Diese Meldung erscheint, wenn kein passender Eintrag oder kein eindeutiger Eintrag in der DeviceMapping.xml gefunden werden kann. Die DeviceMapping.xml wird während der OS Installation hergenommen, um von den Hardwareeigenschaften (MAC oder UUID) auf den späteren Computernamen und Workgroup/Domain zu verweisen.

Die ersten Troubleshooting Schritte …

(1) Die Voraussetzung für einen Eintrag in der DeviceMapping.xml ist: Die Eigenschaft des Computerobjektes muss „PXE fähig“ markiert haben – er muss jedoch nicht unbedingt PXE aktiviert sein!

(2) Wo liegt die DeviceMapping.xml? Die Datei ist im folgenden Verzeichnis abgelegt: \\%EmpirumServer%\Configurator$\Empirum\Configurator\Values
Folgendes sollte geprüft werden: Ist die Datei aktuell bzw. so aktuell wie die letzte Änderung? Geschieht die OS Installation an einem SubDepot, so gilt dies für das SubDepot! Hier muss ggf. der DepotSync betrachtet werden, wenn die Datei am HauptServer anders bzw. vollständig ist. Ergo zuerst die Datei auf dem HauptServer und anschließend auf dem SubDepot prüfen.

(3) Ist die MAC-Adresse / UUID in der DeviceMapping.xml zu finden und nur einmal (1x) vorhanden? Dazu die Datei mittels eines Editors öffnen und darin nach den Werten (Computername, MAC, UUID) des Computerobjektes suchen.

(4) Falls der Computer, die MAC-Adresse oder die UUID nicht in der DeviceMapping.xml zu finden ist: „Empirum-Backend Task Queue Host (64 bit)“ Dienst prüfen, da er für die Erstellung der Datei zuständig ist. Ist der Dienst gestartet und läuft – funktioniert der Dienst einwandfrei? Die Log-Datei zum BTQH64 Dienst befindet sich hier: „C:\ProgramData\Matrix42\Logs\BackendTaskQueueHost64\BackendTaskQueueHost64.log“

Wird die MAC-Adresse oder UUID mehrfach gefunden, dann diese Informationen (Computernamen) nutzen und in der EMC an den Computerobjekten nachschauen.

Löschen doppelter UUIDs aus der Empirum Datenbank

Doppelte UUIDs aus der Empirum Datenbank können wie folgt gelöscht werden:
Empirum bzw. Matrix42 Management Console starten, Konfiguration, Boot Konfiguration – im Menü unter: Extras, Ungültige UUID’s
Suchen und Löschen der doppelten Einträge per Auswahl und Papierkorb Symbol. Bitte beachte die Hinweise, wenn ein Eintrag nicht gelöscht werden kann. Der Hinweis zeigt an, welche Computernamen die gleiche UUID eingetragen haben. Anhand der letzten Inventarisierung o.ä. kann man erörtern, welches das aktuelle Computerobjekt ist.

Wenn die zuvor genannten Hilfestellungen alle nicht geholfen haben …

Weitere Infos am Client (vor der Windows Installation)

Wenn die Meldung erscheint gelangt man direkt in das Log per Tastenkombination „STRG+L„. In der Log-Datei sucht man am besten nach „ComputerIdentification.ResolveComputername„. Nachfolgend ein beispielhafter Auszug:

[INFO] [PeAgent.CopyDeviceMappingXmlFileFromServer] Retries at copying DeviceMapping XML file: 10
[INFO] [PeAgent.CopyDeviceMappingXmlFileFromServer] Copying DeviceMapping XML file (retry 0/10): Values\DeviceMapping.xml
[INFO] [ComputerIdentification.ResolveComputerName] SMBIOS UUID: 4c4c4544-004a-5710-8038-c8c04f335831
[INFO] [ComputerIdentification.ResolveComputerName] Physical addresses: 90B11C147953
[INFO] [ComputerIdentification.MapDevice] Solved computer name 'LABPC001' in domain 'IMAGOVERUM' for SMBIOS UUID '4c4c4544-004a-5710-8038-c8c04f335831'
[INFO] [PeAgent.ResolveComputerName] Resolve computer name: LABPC001 in domain IMAGOVERUM
[INFO] [PeAgent.CopyDeviceMappingXmlFileFromServer] Finished copying DeviceMapping.xml from the Empirum Server.

Weitere Infos am Client (nach der Windows Installation) …

ALT-TAB zum Wechseln in den Hintergrund und anmelden als Admin.
Höchstwahrscheinlich muss dieser Vorgang 2x getätigt werden, da man beim ersten Versuch durch einen Neustart schnell wieder abgemeldet wird.
Nun findet man die entsprechende Log-Datei im %Programdata%\Matrix42\Logs\UAF Ordner.
Die Stelle, nach der man sucht, ist identisch zu den oben aufgeführten Meldungen.

UUID anstatt MAC Adressen bevorzugen

Die Eindeutigkeit ist mit der Nutzung von UUIDs anstatt MAC Adresse (siehe PXE Dienst im Empirum DBUtil) prinzipiell besser.
Wenn aus Gründen …

• nur die MAC Adresse bekannt bzw. einfacher zu pflegen ist
• nur die MAC Adresse eindeutig ist, weil es mehrere Hardware mit identischer UUID gibt
• die MAC Adresse genutzt wird, …

gelten trotzdem die gleichen Regeln – Eindeutigkeit bei den MAC Adressen am Computerobjekt!

Falls man mehrere Notebooks mit einem externen USB zu Ethernet Netzwerkanschluß installieren möchte, muss man bei Bedarf die Netzwerkadresse am bereits installierten Gerät anpassen, falls die MAC-Adresse das führende Merkmal für die PXE-Installation ist.

Der Beitrag Empirum: Failed to copy a sufficient DeviceMapping.xml erschien zuerst auf Workplace Management Blog.

Empirum OS-Installer – die drei Phasen

Teilen wir die Probleme ein, in die drei Phasen der OS-Installation per Empirum WinPE.

• PXE-Boot
• WinPE
• Windows

PXE Boot

A.) Der PXE Boot funktioniert nicht bzw. hat noch nie funktioniert.
Die Switche bzw. VLANs müssen den Broadcast an den PXE-Server (zusätzlich zum DHCP Server) weiterleiten, gerne wird hier der Begriff „IP Helper“ aus der Cisco Welt hergenommen.
Die Windows Firewall muss den eingehenden Netzwerkverkehr auf den PXE- und TFTP-Ports zulassen. Die freizugebenen Ports sind abhängig von PXE Einstellungen. Wer auf Nummer sich gehen will, gibt die UDP Ports: 67,68,69,4011,10042 frei.

B.) Kein Computer führt mehr einen PXE-Boot durch, obschon dies vorher der Fall war.
In diesem Fall, schaut nach, ob Euer Empirum PXE-Dienst weiterhin läuft und erreichbar ist.

C.) Andere Computer starten einen PXE-Boot, doch dieser eine Computer nicht. Dies hat zumeist die folgenden Ursachen:

• Überprüft die beim Computer hinterlegte MAC/UUID mit den Werten die im BIOS angezeigt werden. Ausnahmen sind natürlich externe Docking-Stationen oder Netzwerkadapter.
• Wird MAC Passthrough genutzt und welche Einstellungen dazu bietet das BIOS. MAC Passthrough ist auch sehr abhängig vom Windows Treiber.
• Ist das Computerobjekt in den Eigenschaften als „PXE fähig“ markiert?
• Wenn dies alles passt, so führt bitte über Matrix42 DBUtil das SQL Script: „OS_CleanupNonUniqueDhcpEntries.sql“ aus dem Verzeichnis Empirum\Empirum DBUtil\Scripts\SQLServer\Custom aus. Mit der Ausführung dieses Skripts könnt ihr nichts kaputt machen! Es kann auch mehrfach ausgeführt werden.

D.) Wenn Sie diesen Bildschirm sehen, dann haben sie die vorgenannten Probleme nicht, nicht mehr oder erfolgreich gemeistert.

WinPE

Hast Du es in die WinPE Phase „geschafft“, sieht Du einen grauen Hintergrund oder gar das Matrix42 Logo, und eine Fortschrittsanzeige, wie hier abgebildet.

Die letzten drei Schritte in der Anzeige (wie in diesem Screenshot) bekommst Du erst mit der WinPE Umgebung neuer als 1.8.3 aufgelistet. Schlägt der „Connect to server“ fehl, dann muss man sich zumeist um die Einbindung der passenden Treiber kümmern (siehe Einbinden der WinPE Treiber). Alternativ kann es auch zu Problemen mit der Anmeldung (Benutzername und Kennwort) kommen. In das Log kommt man mit STRG+L. Dies kann man zur genaueren Analyse auch auf einen USB-Stick kopieren.

War die Verbindung erfolgreich und es erscheint die vorherige Meldung, dann liegt es daran, dass kein eindeutiger Eintrag (kein oder doppelter) in der DeviceMapping.xml (Empirum\Configurator\Values) vorhanden ist. Dazu kann man die DeviceMapping.xml mit einem Editor starten und prüfen, ob der Computername gefunden werden kann. Falls ja, nutzt die dazugehörige MAC Adresse oder UUID und sucht danach in der Datei – wahrscheinlich findet ihr einen weiteren Computer mit identischen Werten. Dieses Problem muss behoben werden!

Unabhängig der genannten Probleme, kann es sein, dass der EmpirumAgent Benutzer keine Schreibberechtigungen auf den Empirum\EmpInst\Wizard\OS\WinPEStatus Ordner hat.

Sind all diese Hürden genommen und es kommt trotzdem zu Problemen, dann liegt das zumeist an der Ausführung eines der WinPE Pakete. In seltenen Fällen sollte man prüfen, ob das Paket tatsächlich auf dem EmpirumServer oder dem SubDepot vorhanden ist. Ansonsten sind es dann Probleme bei der Parametrisierung der Pakete. Da hilft Euch jedoch das Log in WinPEStatus Order weiter bzw. sogar häufig das SWDepotLog in der Management Console.

Einbinden der WinPE Treiber

Für die WinPE Phase müssen die Treiber (zumeist nur Netzwerkkartentreiber) über die Management Console, Konfiguration, Boot Konfiguration eingebunden werden.
Dazu die Erweiterten Eigenschaften aktivieren (oben rechts) und bei Zusätzliche Treiberverzeichnisse ein Ordner angeben, in dem die Treiber abgelegt sind oder werden.Ich empfehle ein Ordner unterhalb von Empirum\EmpInst\DRV anzulegen und dort die Treiber ggf. nach Modell sortiert abzulegen. Die Treiber werden auch aus den Unterverzeichnissen (rekursiv) hinzugefügt, so muss man nicht pro Treiber ein Ordner in der Oberfläche angeben. Hast Du diesen Ordner bereits, brauchst Du die Treiber nur in diesem Ordner zusätzlich abzulegen und die Boot Konfiguration neu zu speichern, über den „Speichern“ Button (unten rechts).

Du kannst dann an Deiner Boot Konfiguration verschiedene Zustände feststellen – Sanduhr, Zahnräder und am Ende einen grünen Haken. Sobald die Boot Konfiguration erfolgreich neu erstellt wurde, kannst Du den nächsten Boot-Versuch starten.

Import-Certificate -FilePath "<EmpirumLaufwerk>:\Empirum\EmpInst\Sys\Images\WinPE\binaries\UAF\matrix42ag.Cer" -CertStoreLocation Cert:\LocalMachine\TrustedPublisher

Möchtest Du nicht den Netzwerkartentreiber für die einzelnen Modelle raussuchen bzw. aus dem Windows 10 Treiberpaket entnehmen, so kannst Du auch ein komplettes WinPE Treiberpaket des jeweiligen Herstellers hinterlegen. Dazu jedoch immer erst das alte Verzeichnis löschen und anschließend das neue kopieren/ablegen.

Hier ein paar Beispiele:

• Dell Command | Deploy WinPE Driver Packs
• HP Client Windows PE Driver Packs

Windows

Mit den vorherigen Tipps sollte sich das Windows automatisiert installieren lassen. Ein weiterer häufiger Knackpunkt kommt im Anschluss an die Windows-Installation.
In der Management Console kann man noch eine erfolgreiche Installation von PxeOffAndReboot verzeichnen, jedoch schreitet die Installation nicht weiter voran.

Am Client sieht man dann eine durchlaufende Fortschrittsanzeige vor dem ausgeblendeten Windows-Hintergrund und das System führt alle 5 Minuten einen Neustart durch.
Ein weiterer Indiz ist, dass im PXE-Log des Computers während des DriverIntegration Pakets kein Treiber für das Model kopiert wurde. In diesem Fall fehlt in den meisten Fällen mindestens der Netzwerkkartentreiber für Windows bzw. das komplette Treiberpaket. Diese integriert man mit Hilfe des WinPEDriverAssistant’s aus dem Empirum\AddOns\WinPEDriverAssistant Ordner.

Die Treiber, ganz gleich ob *.zip, *.cab oder ein Ordner werden dann unterhalb von Empirum\Configurator\Packages\Matrix42\OsPackages\Drivers abgelegt. Du kannst die Treiber auch direkt dort ablegen und nur den Namen in das Treiberfeld einfügen – und nicht über das Ordner Symbol für den Import daneben gehen.

Dazu benötigt man die Hersteller und Modellbezeichnung und die entsprechenden Treiber.
Die Hersteller und Modellbezeichnung könnt ihr mit dem HardwareInfo Paket auslesen, oder wie gerade schon beschrieben, schaut ihr in das PXE-Log des Computers. Die erste Meldung ist „Using OS specific driver assignment for vendor …“.

Die Treiber dazu bekommst du bei den Herstellern. Dazu hatte ich bereits beim Beitrag für EPE die Seiten der Hersteller zusammengefasst.
Hast Du die Windows 10 Treiber eingebunden und das DriverIntegration Paket kopiert die Treiber, wie im zu vorigen Screenshot zu erkennen („Using the drivers: …), dann sollte es auch keine Probleme nach der Windows Installation geben.
Wenn es trotz Windows 10 Treiber nach dem PxeOffAndReboot nicht „weitergeht“, dann solltest Du schauen, dass du in Empirum DBUtil die UUID anstatt der MAC als „führendes“ Merkmal nutzt.

Mit diesen Tipps bin ich bester Dinge, dass Du eine erfolgreiche Windows Installation hinbekommst.

Als Grundlage solltest Du die anderen Blog Beiträge erfolgreich umgesetzt haben.
Zum Troubleshooting hatte ich bereits diesen Beitrag hier geschrieben.

Der Beitrag Empirum WinPE – neues Computermodell erschien zuerst auf Workplace Management Blog.

Bei welcher Aktion wird mir diese Option angeboten?

Bei der Aktivierung einer kompletten Gruppe anstatt einem einzelnen Computerobjekt, wird einem im Aktivierungsassistenten beim zweiten Schritt der nachfolgende Dialog angeboten.

Welche Auswirkung hat die Option?

Durch das Setzen der Option „Für alle untergeordneten Elemente übernehmen“, die ich unten eingerahmt habe, überschreibt die angezeigte Verteilungsoption alle bereits vorhandenen Verteilungsoptionen der darunter liegenden Softwarepaketen. Dies hat zur Folge, dass gesetzte Optionen wie Zeitplaner, Deinstallieren etc. mit „Installieren, Erneuern“ überschrieben wird. Die Aktivierung einer Gruppe hat sowieso zur Folge, dass alle darunter befindlichen Computerobjekte aktiviert werden – eine „Übernahme für darunter befindliche Objekte“ ist nicht gesondert notwendig!

Was kann ich tun, wenn ich diese Option fälschlicherweise aktiviert habe?

Wenn Du diese Option ausgewählt hast, oder eben ein Kollege, und das „Problem“ bemerkst, solltest Du als nächstes zur Sicherheit die gesamte Struktur deaktivieren und falls DepotServer im Einsatz sind zur Sicherheit eine Synchronisation des Jobs „ESubdepot_MachineValues“ oder eben „ESubdepot_MachineValues_QuickSync_Night“ forcieren.

Im Nachgang musst Du dich vergewissern, welche Abweichungen welche Folgen haben.
Das Überschreiben eines Zeitplaners, oder der Option „Nicht Anzeigen“ ist zumeist nicht so kritisch. Das Überschreiben von „Deinstallieren“ mit „Installieren, Erneuern“ sorgt dagegen für zumeist ungewünschte Effekte. Für den ersten Fall, kann man sich überlegen, stückweise die Optionen wieder zu setzen und neu zu aktivieren.

Für das Wiederherstellen des Ursprungszustandes im zweiten Fall hilft meines Erachtens nur eine Rücksicherung der Datenbank. Dies hat natürlich den Verlust, der seit der Sicherung durchgeführten Änderungen, zur Folge. Neben neuen Softwarezuweisungen, sind dies auch Rückmeldungen der Softwareverteilung und Inventarisierungsstände.

Deswegen, bitte auch immer neue Kollegen proaktiv auf diese Option und ihre mögliche Auswirkungen hinweisen.

Weiterer Hinweis

Wenn man tatsächlich für alle neuen Verteilungen eine besondere Verteilungsoption („Ablehnen möglich: 5“ oder ähnlich) setzen möchte, so sollte man die Experte, Verteilungsoptionen… Funktion nutzen.

Der Beitrag Gefährliche Aktivierungsoption erschien zuerst auf Workplace Management Blog.

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.

Der WinPE PXE-Boot bootet ein von Empirum modifiziertes bzw. ergänztes Windows PE. Das WinPE wurde im Bedarf um weitere Treiber ergänzt, aber auf jeden Fall um nützliche Libraries und den Matrix42 UAF Dienst. Letzterer führt die zugewiesenen PreOS-Packages (Powershell „Pakete“) aus und bedient sich der gesetzten Variablen. Diese zugewiesenen Pakete beschreiben die Art und Weise, wie z.B. die Betriebssystem-Installation stattfinden soll. Auf weitere Einzelheiten und Vergleiche mit dem EPE Boot werde ich an anderer Stelle eingehen.

So gliedert sich der WinPE PXE-Bootvorgang in:

• Laden und Ausführen der WinPE Umgebung
• Laden des Matrix42 UAF Dienstes
• Verarbeiten der PreOS-Packages

Nun zu möglichen Problemen und Maßnahmen/Hilfestellungen zur Bearbeitung.

Laden der Windows PE Umgebung

Schlägt bereits das Laden der WinPE Umgebung fehl, so könnte dies ggf. an der TFTP Blocksize liegen. Diese kann bis Empirum v19 global in der .config Datei des BTQH (Backend Task Queue Host Services) Dienstes eingestellt werden. Standardmäßig steht dieser Wert auf 4096. Mit größeren Werten kann man den Boot beschleunigen. Damit kann er jedoch unzuverlässiger werden. In einem Falle musste ich die Größe auf 1456 festsetzen, damit der Boot zuverlässig an allen Standorten funktioniert hat.

Windows PE ist gestartet

Sobald das Windows PE gestartet ist, kann mittels STRG+C auf die Kommandozeile und per STRG+L direkt auf die Log Datei des UAF Dienstes zugegriffen werden. Die Windows PE Umgebung befindet sich unter X:\. Der UAF Dienst liegt im Ordner X:\UAF. Das wpeinit.log unter X:\Windows\System32.

Herstellen einer Netzwerkverbindung

Damit der im WinPE implementierte UAF Dienst seine Aufträge abarbeiten kann, bedarf es einer grundlegenden Netzwerkverbindung. Diese Verbindung wird durch Laden und Starten des Netzwerk-Stacks durch die  X:\Windows\StartNet.cmd und nachvollziehbar durch die wpeinit.log  vorgenommen (QueryAdapterStatus ist hier das passende Suchwort). Kann das WinPE keine Netzwerkverbindung aufbauen, kann es notwendig sein, das WinPE mit Netzwerk- und/oder Speicherverwaltungs-Treibern (Storage) zu versorgen. Dies geht über die Bootkonfiguration und wird in einem anderen Beitrag erläutert.

DeviceMapping.xml

Die DeviceMapping.xml im \\%EmpirumServer%\Values$ Verzeichnis stellt die Verbindung MAC-Adresse bzw. UUID zum Computernamen her. Somit darf jede MAC Adresse bzw. UUID auch nur einmal in der DeviceMapping.xml vorhanden sein. Beim Einsatz von SubDepots muss zusätzlich beachtet werden, dass es für die DeviceMapping Datei einen separaten SyncJob (ESubdepot_DeviceMapping) gibt, der zugewiesenen werden muss.

UAF – Auftragsverarbeitung

Das Vorgehen des UAF Dienstes wird im Matrix42.Platform.Service.Host.log festgehalten. Wie zuvor beschrieben, kann dies per STRG+L geöffnet werden. Um Neuerungen mitzubekommen, muss man ggf. das Fenster schließen und erneut aufrufen. Nach einer UAF Sitzung wird das Log auf den EmpirumServer zurückgeschrieben. In Empirum v18 bzw. WinPE 1.4.14 ist das das Verzeichnis \\%EmpirumServer%\EmpInst$\Wizard\OS\Auto\<letzten8 Stellen der MAC-Adrese> bzw. <UUID>.

PXE-Image / WADK Version

Wenn man die neuen WinPE Versionen einsetzt, sollte man wie ein Blog-Leser zusätzlich darauf hingewiesen hat, sicherstellen, dass man die aktuelle WADK Version auf dem EmpirumServer installiert hat. Matrix42 empfiehlt den Einsatz der WADK Version 1903 (eine Version 1909 wird nicht von Microsoft bereitgestellt). Mit dem WADK 1903 habe ich bis dato keine schlechten Erfahrungen gemacht, ganz gleich ob Windows 10 Enterprise 2016 LTSB oder Windows 10 Build 1909 installiert wurde. Zusätzlich sollte man darauf achten, dass die PXE-Image Erstellung (unter Konfiguration\Boot-Konfiguration) erfolgreich ist. Die aktualisierten PreOS Pakete funktionieren auch nur zuverlässig mit einer zu der Version passenden Boot-Konfiguration bzw. aktualisierten PXE-Image.

Der Beitrag Empirum WinPE Boot Troubleshooting erschien zuerst auf Workplace Management Blog.

Empirum Installation / Update

Damit alle Dateien sauber geschrieben werden, ist es von Vorteil bei der Installation und bei Updates die AntiVirus Software auf dem Server zu deaktivieren – wenn möglich.

AntiVirus Konfiguration auf dem Empirum Server

Die nachfolgenden Angaben beziehen sich jeweils auf das Empirum Verzeichnis, unabhängig von dem Laufwerk auf dem es installiert ist. Da sich in den Verzeichnissen lediglich Konfigurationsdateien befinden, ist das Risiko an dieser Stelle auch begrenzt.

• Empirum\EmpInst\Wizard\OS\Auto
• Empirum\Configurator\Values

AntiVirus Konfiguration auf den Clients

Auf dem Client verhält es sich etwas anders, jedoch sind Ausnahmen zu empfehlen.
Wenn machbar, kann man auch die Aktionen der

• ERIS.EXE aus dem %WinDir%\System32\Empirum Verzeichnis
• Setup.exe und Setup64.exe aus dem EmpirumAgent Verzeichnis
• Matrix42.Platform.Service.Host.exe aus dem %ProgramFiles%\Matrix42\Universal Agent Framework Verzeichnis

aus der Verhaltensüberwachung oder Überprüfung herausnehmen.

Für die folgenden Verzeichnisse sollten Ausnahmen definiert werden:
C:\Program Files (x86)\Common Files\Setup32
C:\Program Files\Common Files\Setup32
C:\Program Files\Common Files\Setup64
C:\Windows\System32\Empirum (Empirum Advanced Agent)

Bei den zuvor genannten Verzeichnissen kann es ansonsten dazu kommen, dass die eigentlichen Dateien nicht ausgetauscht werden und sich somit *.00* Dateien über einen Zeitraum ansammeln und die Funktion einschränken.

EPE USB Stick Erstellung

Zuletzt hatte ein Kunde sogar Probleme EPE USB Sticks zu erzeugen bzw. valide Ergebnisse zu bekommen, da einige Dateien nicht in der Form von der Erstellungsroutine verändert werden konnten wie angedacht.

Generell sollte man ebenfalls prüfen, wie man die Lese- und Schreibzugriffe der AntiVirus Lösung konfiguriert. Wenn man das Lesen vom Netzwerk-Laufwerk überprüft, stellt sich die Frage, ob man dann auch das Schreiben der gleichen Datei auf die lokale Festplatte nochmals prüfen muss.

Wie sind Eure Erfahrungen und vielleicht auch Ergänzungen zu meinen Beobachtungen?

Der Beitrag Empirum und AntiVirus Software erschien zuerst auf Workplace Management Blog.

Es gibt jedoch Besonderheiten bei diesem Befehl. Die For … Next Schleife wird beim Install als auch beim Uninstall ausgeführt und benötigt kein „-„. Beim Uninstall zählt die For Schleife jedoch „umgekehrt“. Dies ist in der Hilfe so nicht näher erläutert. Anbei findet Ihr die Erläuterung aus der Matrix42 Hilfe, als auch ein Empirum Setup.inf Ausschnitt mit zwei Beispielen.

Auszug aus der Online Hilfe

For <Var>,<LB>,<UB>,<Inc>,<Abschnitt>

Führt eine FOR-Schleife aus. Die Zählvariable ist <Var> wird von der Untergrenze <LB> zur Obergrenze <UB> in <Inc> Schritten hoch gezählt. Jedes Mal wird der Abschnitt <Abschnitt> aufgerufen. Die Zahlen dürfen auch negativ sein sowie Ober- und Untergrenze vertauscht werden (Abwärtsschleife). Wird <Inc> leer gelassen, wird 1 bzw. -1 angenommen.

Beispiel: For Counter,1,3,,UpSection

Setup.inf Beispiel

[Environment]
VALUE1=Hello
VALUE2=World
VALUE3=!

[Product]
#Set:Installation, DONTDELETE
#Set:Deinstallation, DELETE

[SET:Installation]
FOR counter,1,5,,ECHOCounter
FOR counter,1,3,,ECHOValues

[ECHOCounter]
ECHO Installation : %Counter%
-ECHO DeInstallation : %Counter%

[ECHOValues]
SET EchoVALUE=%%Value%Counter%%%
ReplaceEnv EchoValue
ECHO %EchoValue%

[SET:Deinstallation]
;--This counts from 5 to 1 during UNINSTALL!
FOR counter,1,5,,ECHOCounter
-ECHO FOR counter,1,5,,ECHOCounter

;--This counts from 1 to 5 during UNINSTALL!
FOR counter,5,1,-1,ECHOCounter
-ECHO FOR counter,5,1,-1,ECHOCounter

Der Beitrag Empirum und For – Next Schleife erschien zuerst auf Workplace Management Blog.

Windows 10

Seit nun fast einem Monat ist Windows 10 offiziell freigegeben. Ich hatte bereits einen Artikel veröffentlicht, wie man mit Empirum Windows 10 Technical Preview verteilen kann. Noch vor der eigentlichen Veröffentlichung durch Microsoft hat Matrix42 bereits mit dem Update 1 für die Empirum Version 16 die Unterstützung für Windows 10 bekanntgegeben.

Empirum V16 Update 1

Das Update 1 für Empirum V16 wird auch Windows 10 Feature Pack genannt. Diese Version enthält bereits in allen Modulen die Unterstützung von Windows 10.

Windows 10 LTSB

Da sich Microsoft lange mit den LTSB Versionen zurückgehalten hat, sind diese SKUs noch nicht im Update 1 enthalten. Die Einbindung und Verteilung funktioniert trotz alledem. Hier muss man sich ggf. dem Trick mit der ImageInfo.ini bedienen, den ich im oben genannten Artikel bereits eingeführt habe. Dazu muss eine INI Datei mit dem Namen ImageInfo.ini bei den Betriebssystemquellen, im Verzeichnis (Empirum\EmpInst\SYS\Win10\<ServicePack>_{GUID}\<Sprache>) in dem auch die unattend.xml abgelegt ist, erstellt werden. Diese ImageInfo.ini sieht beispielhaft wie folgt aus:

[ImageInfo]
SKU=Windows 10 Enterprise 2015 LTSB

Diese ImageInfo.ini Datei wird, wenn vorhanden, von der end_winvista.eis Anpassung ausgelesen. Da sich jedoch die Variablen ab der Version 16 etwas geändert haben, muss hier in der end_winvista.eis eine Anpassung, gegenüber dem Artikel zur Empirum Version 15.1.9, vorgenommen werden. Die Anpassungen stehen unten auch zum Download bereit.

; ----------------------------------------------------------------------------
;SKU Override for non supported OS Versions
; ----------------------------------------------------------------------------
IFEXIST %E%%SysPath%\ImageInfo.ini THEN
READINI %E%%SysPath%\ImageInfo.ini ImageInfo SKU valueSKU 
IF "%valueSKU%"<>"" THEN
§ECHO_MSG="10 Custom script: end_winvista-[SKU Override] executed - ImageInfo.ini SKU value found"
GOSUB LINUX_ECHO

§SKU_LONG="%valueSKU%"
XMLSET %XMLWinPEPath%ImageInstall/OSImage/InstallFrom/MetaData[wcm:action="add"]/Key="/IMAGE/NAME"
XMLSET %XMLWinPEPath%ImageInstall/OSImage/InstallFrom/MetaData[wcm:action="add"]/Value="%SKU_LONG%"
§ECHO_MSG="10 Custom script: end_winvista-[SKU Override] SKU changed to: %SKU_LONG%"
GOSUB LINUX_ECHO
ENDIF
ENDIF
; ----------------------------------------------------------------------------

Windows 10 Treiberablage in Empirum

Wer die Release Notes zum Update 1 sorgfältig gelesen hat, hat festgestellt, dass die Windows 10 Treiber vorerst in der Windows 8 Struktur abgelegt werden. Dies sollte für den Großteil der Empirum Nutzer, die direkt von Windows 7 in Richtung 10 schielen kein Problem darstellen. Wenn man die Treibereinbindung über die Hardwareprofilverzeichnisse vornimmt, wie ich das in meinen anderen Artikel Empirum Treiberintegration – einfacher gemacht! erläutert habe, so kann man sich die Windows 10 Treiberstruktur auch analog zu den vorhandenen Treiberstrukturen befüllen. Die Einbindung der Treiber über die Empirum Management Console in die Win10 Verzeichnisstruktur wird von mir, als auch derzeit der Matrix42, nicht unterstützt!

Auch diese Anpassung geschieht über die end_winvista.eis.

Ich habe eine exemplarische und funktionierende end_winvista.eis Datei zum Download angehängt. Diese Datei funktioniert ab Empirum Version 16 und mit den Windows 10 Verzeichnissen und enthält somit beide oben genannten Anpassungen. Wenn man in der end_winvista.eis noch mehr Anpassungen durchgeführt hat, so sind die Änderungen zusammenzuführen.

Hier geht es zum Download:  end_winvista.eis.v16.0.1 (1961 Downloads )

Der Beitrag Mit Empirum Windows 10 verteilen erschien zuerst auf Workplace Management Blog.

Windows 10 scheint das Windows Betriebssystem zu werden, dass sich viele Nutzer wünschen. Es verbindet die klassische Bedienlogik inklusive eines Startmenues und die touchoptimierte Bedienung, die mit Windows 8 Einzug gehalten hat. Windows 10 verbindet nicht nur die unterschiedlichen Bedienphilosophien, sondern bietet auch immer die optimale Oberfläche bei Geräten die Tablet und Notebook in einem sind, wie ein Microsoft Surface, Lenovo Yoga, etc..

Windows 10

Die Quellen zum jeweils aktuell veröffentlichten Stand von Windows 10 gibt es entweder im MSDN Bereich oder hier. Wenn man die Windows 10 Preview jedoch auch in der eigenen Empirum Umgebung schon mal testen möchte, muss man beachten das es derzeit nicht offiziell supported wird.

Schnellschuss mit Empirum v15.1

Mit den aktuellen Quellen von Windows 10 kann man auch einen „Schnellschuss“ versuchen.
Dazu muss man zuvor die äquivalente Windows 8.1 Quelle (Architektur, Sprache, Edition) importieren und anschließend die gerade importierten Quellen mit den Windows 10 Quellen ersetzen. Anschließend kopiert man eine passende Windows 8.1 Betriebssystemvorlage und verweist auf die neu importierten Quellen.

Hintergrundinformationen

Wenn das nicht wie gewünscht funktioniert, kann es noch an anderen Parametern liegen.
Da ich bereits ab der ersten verfügbaren Windows 10 Quelle mit Empirum v15.1 experimentiere, habe ich an der ein oder anderen Stelle im System bereits Anpassungen vorgenommen.

Was habe ich alles getan?
1. Aktuelles WADK eingebunden
2. Die Windows 10 Betriebssystemquellen müssen in Empirum eingebunden werden
3. Die unbeaufsichtigte Installation muss mit der ggf. unbekannten SKU zurecht kommen.
4. Betriebssystemvorlage erstellen.

Aktuelles WADK importieren

Zur Sicherheit habe ich das aktuelle WADK auf dem EmpirumServer installiert.
Das aktualisierte WADK gibt es hier.
Wenn man die neuere Version installieren möchte, muss man beachten, dass man zuvor die Vorgängerversion deinstalliert.
Ansonsten erscheint ein Hinweis, dass man bereits die aktuelle Version installiert hätte.

Einbindung der Quellen

Die Windows 10 Quellen kann man entweder über den gleichen Weg einbinden, wie die Windows 8.1 Quellen mit dem damals zur Verfügung gestellten Preview.
Dann wird im OS-Installer auch Windows 10 als importierte Quelle angezeigt. Dazu muss man den Importkatalog, die Datenbank als auch die Importskripte erstellen und in die eigene Umgebung einbauen. Alternativ kann man ein weiteres Windows 8.1, der gleichen Architektur, Sprache und Edition importieren und nachträglich die Windows Quellen unterhalb des SYS Ordners gegen die von Windows 10 austauschen (siehe oben).

SKU (Windows Versions und Editions Information)

Nun haben die Windows 10 Quellen, die ich mir betrachtet habe immer wieder unterschiedliche SKUs besessen. Die Angabe der richtigen SKU sorgt für die komplett unbeaufsichtige Installation. Stimmt die in der unattend.xml hinterlegte SKU nicht mit den eingebundenen Quellen überein, bleibt der Installationsdialog stehen und fragt welche Version von Windows installiert werden soll. Die letzten Windows 10 Enterprise Quellen mit dem Build 9926 hatten allesamt die SKU „Windows 8.1 Enterprise“ eingetragen. Somit müsste man nicht mal eine Anpassung der SKU vor der Installation mit Hilfe eines angepassten EIS Skriptes vornehmen (Empirum v15.1 Patch 09 oder Windows 8.1 Preview vorausgesetzt). Dies war jedoch bei den ersten Windows 10 Technical Previews noch anders.
Die gültige SKU kann mit dem Befehl:
dism /get-imageinfo /imagefile:<Pfad>\install.wim /index:1 
herausgefunden werden. Diese wird unter „Name:“ angezeigt.

ImageInfo.ini

Ist es doch eine andere SKU, so kann man mit der END_WINVISTA.EIS die SKU in der unattend.xml überschreiben.
Ich habe mir für diesen Zweck eine einfache aber vielfältige Methode ausgedacht, wie man für die importierte Quelle immer die richtige SKU hinterlegen kann.

Dazu wird im Verzeichnis
Empirum\EmpInst\SYS\Win8\<ServicePack>_{GUID}\<Sprache>
eine Datei ImageInfo.ini mit folgendem Inhalt erstellt.
Als Hinweis: In diesem Verzeichnis müsste auch die unattended.xml Vorlage liegen.

[ImageInfo]
;SKU=Windows 10 Technical Preview
SKU=Windows 8.1 Enterprise

end_Winvista.eis

Folgende end_winvista.eis Erweiterung sorgt für die Auswertung der ImageInfo.ini, falls diese vorhanden ist. Somit haben diese Zeilen auch für die bestehenden Installationen keine Auswirkung.

; ----------------------------------------------------------------------------
;SKU Override for non supported OS Versions
; ----------------------------------------------------------------------------
IFEXIST %E%Sys\%OS%\%LocARCH%%LocTYP%\%SP%%Language%\ImageInfo.ini THEN
   READINI %E%Sys\%OS%\%LocARCH%%LocTYP%\%SP%%Language%\ImageInfo.ini ImageInfo SKU valueSKU 
      IF "%valueSKU%"<>"" THEN
         §ECHO_MSG="10 Custom script: end_winvista-[SKU Override] executed"
         GOSUB LINUX_ECHO

         §SKU_LONG="%valueSKU%"
         XMLSET %XMLWinPEPath%ImageInstall/OSImage/InstallFrom/MetaData[wcm:action="add"]/Key="/IMAGE/NAME"
         XMLSET %XMLWinPEPath%ImageInstall/OSImage/InstallFrom/MetaData[wcm:action="add"]/Value="%SKU_LONG%"

         §ECHO_MSG="10 Custom script: end_winvista-[SKU Override] SKU changed to: %SKU_LONG%"
         GOSUB LINUX_ECHO
      ENDIF
ENDIF
; ----------------------------------------------------------------------------

Betriebssystemvorlage erstellen

Wenn man bereits eine Windows 8 oder 8.1 Betriebssystemkonfiguration hat, so kopiert man diese und hinterlegt unter Allgemein\Sprache die neu eingebundenen Betriebssystemquellen. Speichern, Fertig!

Jetzt kann es losgehen …
Viel Spaß!

Der Beitrag Windows 10 mit Empirum v15.1 installieren erschien zuerst auf Workplace Management Blog.

Wo werden die Aufrufe zu externen Programmen hinterlegt?

Im Bereich „Administration“, im Menü unter „Extras“, „Einstellungen …“ gibt es den Reiter „Externe Programme“. Mit einem Klick auf das „+“ Symbol wird ein neuer Eintrag vorbereitet.
Jeder externe Programmaufruf benötigt dann die Eingabe eines Namens und einer Angabe zum Programm das aufgerufen wird. Will man diesen Programmaufruf allen Benutzern der Management Console bereitstellen, so muss man zusätzlich die Option „Globales Programm (Für alle Benutzer)“ setzen. Wenn man mit der Eingabe des oder der weiteren externen Programmaufrufe fertig ist, sollte man den Dialog auch mit „OK“ verlassen, ansonsten werden die gemachten Änderungen nicht gespeichert!

Welche Variablen können genutzt werden?

Es stehen für die Aufrufe diverse Variablen zur Verfügung.

Die meist genutzten Variablen sind:

• %Computername%
• %IP%
• %Domain%

Darüberhinaus stehen jedoch auch:

• %INVENTORYID%
• %DOMAIN%
• %MACADDRESS%
• %MAC8%
• %CUSTOM01% bis %CUSTOM30%

zur Verfügung

Beispiele für Aufrufe

• Verteilaufträge – Computer
  notepad \\%EmpirumServer%\Values$\MachineValues\%Domain%\%Computername%.ddc
• Variablen – Computer
  notepad \\%EmpirumServer%\Values$\MachineValues\%Domain%\%Computername%.ini
• Explorer C$
  explorer \\%Computername%\C$
• Ping (3 Sekunden)
  ping -n 3 %Computername%
• Computerverwaltung
  Compmgmt.msc /Computer:%Computername%
• MAC8 Ordner
  explorer \\%EmpirumServer%\EmpInst$\Wizard\OS\Auto\%Mac8%
• WinPEStatus
  explorer \\%EmpirumServer%\EmpInst$\Wizard\OS\WinPEStatus\%Domain%_%Computername%

Fernsteuerung

Das gleiche Prinzip wie bei den externen Programmen gilt auch für die Fernsteuerung. Auch hier können weitere eigene Aufrufe zu eigenen Fernsteuerprogrammen hinterlegt werden. Eine, die die jeder nutzen kann ist …

• Microsoft RemoteDesktop
  mstsc /v:%Computername%

Ideen …

Weitere Programmaufrufe zum Durchführen eines Neustarts oder Shutdowns, sowie die Nutzung von PSEXEC lassen noch viele weitere spannende Aufrufe zu.

Viel Spaß beim Ausprobieren!

Der Beitrag Externe Programmaufrufe oder Fernsteuerung aus der EMC erschien zuerst auf Workplace Management Blog.