You searched for AgentConfig - Workplace Management Blog https://www.wpm-blog.de/ ... ideas and solutions making workplace management easier Thu, 30 Jul 2020 14:58:09 +0000 de hourly 1 https://wordpress.org/?v=6.1.7 Empirum Agent – Troubleshooting Verbindungsaufbau https://www.wpm-blog.de/empirum-agent-troubleshooting-verbindungsaufbau/ https://www.wpm-blog.de/empirum-agent-troubleshooting-verbindungsaufbau/#comments Fri, 20 Sep 2019 18:15:21 +0000 https://www.wpm-blog.de/?p=2316 Es gibt Fragen zum Empirum Agenten, die häufiger vorkommen als andere. Neben der Frage: „Warum macht der Agent nichts?“, ist die zweit häufigste Frage: „Mit welchem EmpirumServer verbindet sich mein Client und warum?“. Die Frage … Weiterlesen

Der Beitrag Empirum Agent – Troubleshooting Verbindungsaufbau erschien zuerst auf Workplace Management Blog.

]]>
Es gibt Fragen zum Empirum Agenten, die häufiger vorkommen als andere. Neben der Frage: „Warum macht der Agent nichts?“, ist die zweit häufigste Frage: „Mit welchem EmpirumServer verbindet sich mein Client und warum?“. Die Frage wird zumeist gestellt, weil der Computer sich nicht mit dem EmpirumServer verbindet, oder weil der Empirum Administrator die Konfiguration anpasst und verstehen will, warum der Empirum Agent sich mit dem entsprechenden EmpirumServer verbindet. Das sind wir auch an dem Punkt, dass es eine serverseitige Konfiguration gibt und eine Seite, was der Computer daraus macht.

Zentrale Steuerung – Agent Template

Sein Verhalten bekommt der Empirum Agent über das sogenannte Agent-Template mitgegeben. Dieses Agent-Template ist unabhängig, ob der Advanced oder UEM Agent eingesetzt wird. Funktionen die nur der UEM Agent bedienen kann sind mit einem fliederfarbenen Symbol gekennzeichnet. In Bezug auf die Verbindungsmöglichkeiten gibt es bis dato jedoch keine Unterschiede.

DHCP Optionen

In Empirum DBUtil muss zuerst die Option EmpirumServer aktiviert werden und mit einer Options-Nummer versehen sein. Dies geht in den Eigenschaften zu den PXE-Servern.Im Anschluss sollte man das Agent-Template erstellen bzw. aktualisieren mit der DHCP Option gesetzt (siehe Abbildung 1). Vertrauen ist gut – Kontrolle ist besser! Am besten man schaut nach der Erstellung in die daraus resultierende XML Datei im \\%EmpirumServer%\Configurator$\User Verzeichnis (<Konfigurationsname>.xml). In der Datei sollte eine Suche nach DHCP einen ähnlichen Eintrag wie folgt finden …

<DHCPOptions enabled="true">
     <DHCPEntry id="128">EmpirumServer</DHCPEntry>
</DHCPOptions>

Anschließend ist zu prüfen, ob die zuvor genutzte DHCP Options ID (hier 128) auf dem DHCP Server für den entsprechenden IP-Adressraum konfiguriert ist. Falls die Option 128 noch nicht vorhanden ist, so muss diese auf dem DHCP Server noch erstellt werden. Eine Anleitung, die man sich als Vorlage nutzen kann, ist hier verfügbar. Die zu erstellende Option (ab ID 128) ist vom Typ: Zeichenkette bzw. String und sollte mit dem Namen „EmpirumServer“ belegt werden.

Zugewiesene EmpirumServer verwenden

Wenn man mit der Zuweisung des EmpirumServers über die Konfigurations- bzw. Zuweisungsgruppen arbeiten will, muss man diverse Voraussetzungen erfüllen.
In den Computereigenschaften des zuzuweisenden EmpirumServers müssen die folgenden Werte gesetzt sein:

  • die Computerrolle: Empirum Master Server oder Empirum Depot Server
  • die Variablen: SubDepot\USER_x / PASSWORD_x

Der EmpirumServer wird über die Eigenschaften der Konfigurations-/Zuweisunggruppe zugewiesen und vererbt. Dem Computerobjekt wird automatisch nochmals direkt der Empirum Master Server zugewiesen.Die Reihenfolge der EmpirumServer Nutzung kann optisch oder in der %Computername%.ini Datei eingesehen werden. In den Eigenschaften der Gruppe entspricht die Reihenfolge von open nach unten. In der %Computername%.ini entspricht die Reihenfolge von unten (höchste Zahl) nach oben (kleinste Zahl).

Verbindungs-Versuchs-Reihenfolge
Die Reihenfolge der Verbindungsversuche geschieht vorwiegend, wie in der Abbildung des Agent-Templates zu sehen ist, von oben nach unten:

  • DHCP Option
  • Zugewiesene EmpirumServer (unter Berücksichtigung der Sub-Optionen: zufällige Reihenfolge, MasterServer auslassen)
  • bereits gesetzte Umgebungsvariable %Empirumserver%
  • Ausfall Server (das sollte zumeist der Empirum Master Server sein) – angegebener Server in der AgentConfig.xml

Die Verbindung wird ausschließlich nach der Erreichbarkeit des Servers bzw. der Freigaben (SMB/https) bestimmt, nicht an der Qualität der Verbindung.

Wie sieht es am Client aus?

Die Frage lässt sich zumeist gut beantworten, bedarf jedoch eines Blickes „unter die Motorhaube“, sprich in die Log Dateien des Agenten. Diese findet man für den UEM Agent unter: C:\ProgramData\Matrix42\Logs\UAF\ und für den Advanced Agent unter: C:\ProgramData\Matrix42\Logs\ERIS. Dazu nimmt man am besten die Datei ohne Datum im Dateinamen (aktuelle Datei) und sucht nach DHCP. Somit findet man zumeist schnell den Start des Empirum Agenten bzw. die Informationen zum aktuellen Polling. Nachfolgend ein beispielhaftes Log mit Kommentaren in kursiver Schrift.

>Welches Agent Template wurde genutzt? Name und Version ist hier aufgeführt.
[Warning] [MxLog.LogS] DLL.Transport [SAC] Using Agent Template ‚AgentConfigSample‘ (Version 18.0.0.3) <19>
>Was sind die aus der AgentConfig.xml (auf dem Client heißt die Konfigurationsdatei immer gleich) ausgelesenen Einstellungen?
[Warning] [MxLog.LogS] DLL.Transport [SAC] Use DHCP options <19>
[Warning] [MxLog.LogS] DLL.Transport [SAC] Use assigned EmpirumServers ; Use random order ; Exclude Empirum Master Server <19>
[Warning] [MxLog.LogS] DLL.Transport [SAC] Fallback Server: empirumserver.domain.loc, account: Domain\EmpirumAgent <19>
[Warning] [MxLog.LogS] DLL.Transport [SAC] Active protocol: SMB <19>
[Warning] [MxLog.LogS] DLL.Transport [SAC] END Configuration for checking server availability <19>
>sind EmpirumServer zugewiesen?
[Warning] [MxLog.LogS] DLL.Transport [SAC] Machine values file for this computer is „C:\EmpirumAgent\Values\MachineValues\Domain\ComputerName.ini“ <19>
[Warning] [MxLog.LogS] DLL.Transport [SAC] Loading assigned EmpirumServers from „C:\EmpirumAgent\Values\MachineValues\Domain\ComputerName.ini“ <19>
>hier sind keine EmpirumServer zugeordnet …
[Warning] [MxLog.LogS] DLL.Transport [SAC] No assigned EmpirumServer found! <19>
>nutze den EmpirumServer aus der Umegbungsvariable: EmpirumServer …
[Warning] [MxLog.LogS] DLL.Transport [SAC] Loading configuration from environment variables <19>
[Warning] [MxLog.LogS] DLL.Transport [SAC] ENV-EmpirumServer: empirumserver.domain.loc, ENV-User: Domain\EmpirumAgent, ENV-Password: is set <19>
[Warning] [MxLog.LogS] DLL.Transport [SAC] Checking availability of server with user <Domain\EmpirumAgent> using configured protocol <19>

>im Falle eines zugewiesenen EmpirumServers per DHCP …
[Warning] [MxLog.LogS] DLL.Transport [SAC] Use DHCP options <9>

[Warning] [MxLog.LogS] DLL.Transport [SAC] Reading DHCP options from network stack <9>
[Information] [MxLog.LogS] DLL.Transport Dhcp environment variables from xml read <9>
[Information] [MxLog.LogS] DLL.Transport [DhcpOptions] START SelectAdapters <9>

[Information] [MxLog.LogS] DLL.Transport [DhcpOptions] START GetDhcpOptions <9>

[Information] [MxLog.LogS] DLL.Transport Dhcp Option „EmpirumServer“ with ID 128 will be requested <9>
[Information] [MxLog.LogS] DLL.Transport Dhcp Received 19 bytes from DHCP server: „empirumserver.domain.loc“ for option 129 <9>
[Information] [MxLog.LogS] DLL.Transport [DhcpOptions] END GetDhcpOptions successful. ‚1‘ values found <9>
[Warning] [MxLog.LogS] DLL.Transport [SAC] Get for DHCP option ‚EmpirumServer‘ value ‚empirumserver.domain.loc‘ successfully <9>

>Verbindungsversuche
[Information] [MxLog.LogS] DLL.Transport SMB Session Manager Connection to \\empirumserver.domain.loc\Configurator$\Packages with user Domain\EmpirumAgent establishing. <34>
>hierauf sollte ein „established“ folgen, oder eben eine Fehlermeldung, warum der EmpirumServer nicht erreichbar ist.

Der Beitrag Empirum Agent – Troubleshooting Verbindungsaufbau erschien zuerst auf Workplace Management Blog.

]]>
https://www.wpm-blog.de/empirum-agent-troubleshooting-verbindungsaufbau/feed/ 2
XML Wert in eine Variable https://www.wpm-blog.de/xml-wert-in-eine-variable/ https://www.wpm-blog.de/xml-wert-in-eine-variable/#respond Tue, 30 Jul 2013 17:59:56 +0000 https://www.wpm-blog.de/?p=1045 In der Softwarepaketierung besteht immer wieder mal die Notwendigkeit auf einen Wert in einer XML Datei zu reagieren bzw. diesen Wert während des Installationsskriptes anderweitig zu verarbeiten. Dazu gibt es in der Matrix42 Empirum Setup.inf Skriptsprache … Weiterlesen

Der Beitrag XML Wert in eine Variable erschien zuerst auf Workplace Management Blog.

]]>
In der Softwarepaketierung besteht immer wieder mal die Notwendigkeit auf einen Wert in einer XML Datei zu reagieren bzw. diesen Wert während des Installationsskriptes anderweitig zu verarbeiten. Dazu gibt es in der Matrix42 Empirum Setup.inf Skriptsprache seit der Version 14 den Befehl ReadXML. Wie immer fällt es einem leichter, wenn man das ein oder andere Beispiel sieht, das man nutzen und an seine Bedürfnisse anpassen kann. Nachfolgend sind ein paar ReadXML Befehle, die sich Werte aus der Empirum Inventory Datei holen, oder der Agenten Konfiguration. Beim Auslesen der Agenten-Konfiguration kann es notwendig sein, die AgentConfig.xml für den Auslesevorgang an einen temporären Ort zu kopieren.

Viel Spaß damit!

Set Bandwith=ReadXmlText("%System%\Empirum\AgentConfig.xml","/AgentTemplate/Transport/Protocols/CommonParameters/MinBandwidth")
ECHO %Bandwith%

Set LocalDirPackage=ReadXmlText("%System%\Empirum\AgentConfig.xml","/AgentTemplate/Transport/Protocols/CommonParameters/LocalDirPackage[@Platform='Windows']")
ECHO %LocalDirPackage%

Set InstalledOSVersion=ReadXmlText("%System%\Empirum\%ComputerName%.xml", "/InventoryData/Table[@Name='InvLicenseKey']/Column[@Name='ProductName'])
ECHO %InstalledOSVersion%

Der Beitrag XML Wert in eine Variable erschien zuerst auf Workplace Management Blog.

]]>
https://www.wpm-blog.de/xml-wert-in-eine-variable/feed/ 0