• Paket im Packages Ordner ablegen
• Paket in der Standort Datenbank (SoftwareDepot) bekannt machen

Software Paket – Installationsdateien – ablegen

Das Software Paket muss im Packages Verzeichnis unterhalb der Freigabe Configurator$ (Standardeinstellung) abgelegt werden. Es sollte somit folgende Ordnerstruktur, durch die Ablage des Paketes, erstellt werden:

\\<EmpirumServer>\Configurator$\Packages\<Hersteller>\<SoftwareName>\<Version>\Install

Im Install Ordner liegt die Setup Information in Form einer Setup.inf oder auch anderem Namen.

Software Paket in das SoftwareDepot einbinden

Nachdem das Paket im Packages Ordner abgelegt wurde, muss dies der Standort Datenbank bekannt gemacht werden zur Verteilung. Dazu startet man die Empirum Management Console, kurz EMC, und wechselt in die Konfiguration und dort in Software-Management. In der Konfiguration des Software-Managements muss man das Register SoftwareDepot auswählen. Nun klickt man mit der rechten Maustaste auf ein Software-Register und wählt „Paket einfügen …“.

Beim ersten Dialog wählt man „Ja“, da uns eine Installationsdatei in Form einer INF Datei vorliegt.

Dann navigiert man in einer Paketstruktur (<Hersteller>\<SoftwareName>\<Version>\Install) bis zur *.INF Datei.

Nach dem Öffnen der Setup.inf werden diverse Informationen aus der *.INF Datei übernommen und vorgeschlagen zur Übernahme.

Nun werden die absolut notwendigen Einstellungen, sowie weitere mögliche Einstellungen erläutert.

Paketeigenschaften

Auf dem Reiter „Darstellung“ muss zur Verteilung der Haken bei „Zur Installation freigeben“ gesetzt sein. Ansonsten wird das Paket nur auf Computern verteilt, die die Variable „READY_TO_INSTALL_TEST“ auf 1 gesetzt haben.

Empfehlenswert ist es auch, die Version aus dem Feld Namen mit in das Feld Text zu übernehmen. Im oben genannten Falle kann man auch im Text einmal „Adobe“ entfernen, damit das Paket besser gelesen werden kann.

Optional kann hier auch noch ein Icon für die Software hinterlegt werden. Das Icon sollte eine ICO Datei sein, anstatt auf eine EXE Datei zu verweisen. Dies ermöglicht eine schnellere Bedienung bzw. Ladezeit der EMC! Eine Dokudatei, kann zur Dokumentation des Paketes für die EMC Nutzer dienen. Die Info-Datei kann bei der Nutzung des Software-Kiosks bei der Auswahl der Software angezeigt werden (Die Schaltfläche „Info“ wird dann im Kiosk bei der Auswahl der Software aktiv).

Als nächstes ist eine Angabe auf dem Reiter „Prüfung“ notwendig bzw. zu überprüfen. Der Befehl (im Feld Befehl) sollte mit einem Silent-Schalter versehen sein. Beim ersten Import bzw. Einfügen der Software in das SoftwareDepot, werden die Einstellungen aus dem Bereich [SetupInfo] aus der INF Datei übernommen. Bei nachträglichen Änderungen in der INF Datei, werden diese Einstellungen nicht mehr an diese Stelle übernommen!

Die „Silent“ Schalter kann  /S0, /S1, /S2 oder /S3 sein.

• /S0 – es wird kein Setup.inf Fenster angezeigt
• /S1 – es wird nur der Fortschrittsbalken der Setup.inf angezeigt
• /S2 – es wird das Hintergrundbild und der Fortschrittsbalken der Setup.inf angezeigt.

Zusätzlich kann es notwendig sein, dass der Schalter /AW zusätzlich angehängt wird, wenn das Paket über benutzerspezifische Einstellungen verfügt, wie (z.B.: HKCU Werte, Sektionen oder Kopierbefehle mit CLIENT, …).

Alle Setup.exe Parameter, oder auch noch ausführlichere Beschreibung kann hier eingesehen werden.

Speichern nicht vergessen …

Sind diese Einstellungen gemacht, ist das Minimum an Einstellungen getätigt und der Dialog kann mit „OK“ verlassen werden und das SoftwareDepot gespeichert werden (Diskettensymbol).

Der Beitrag Einbinden eines Software-Paketes in Empirum (Basis) erschien zuerst auf Workplace Management Blog.

Die angezeigten ERRORLEVEL haben ihren Ursprung zumeist im Kommando Interpreter oder in den Installern. Unten angefügt habe ich zwei Tabellen mit den häufigsten Fehlermeldung. Diese Tabellen erheben jedoch keinen Anspruch auf Vollständigkeit.

Was sind die gängigen Fehler und wie lassen sie sich beseitigen?

Die ERRORLEVEL Meldungen rühren aus der Setup.inf des fehlerhaften Empirum Paketes.

Fehler 2 oder 3
In diesem Fall ist zumeist ein Befehl falsch geschrieben, die Setup.exe ist zu alt für den genutzten Befehl, ein aufzurufendes Programm wurde versucht als Befehl zu interpretieren.

Fehler 5
Kein Zugriff möglich oder auch Zugriff verweigert bedeutet zumeist, dass der Befehl aufgrund von nicht vorhandenen Berechtigungen fehlschlägt. In Empirum ist das zumeist, wenn in der Registry Änderungen durchgeführt werden sollen, zu der der Benutzer nicht berechtigt ist. Das können Änderungen im Bereich HKLM\SYSTEM, als auch HKCU\Software\Microsoft\Policies sein. Der Benutzer hat zwar Berechtigungen auf den HKCU Zweig, jedoch nicht im Bereich der Policies, denn diese soll er ja auch nicht „manipulieren“ können.

Fehler 1602
Dieser Fehler rührt vom Windows Installer und bedeutet, dass der Benutzer die „Abbrechen“ Schaltfläche des MSIEXEC Dialoges betätigt hat. Diese Schaltfläche kann mit dem „!“ entfernt werden, wie z.B. /qb-! oder /qr!. Nutzt man direkt /qn – so wird nichts angezeigt, auch nicht die „Abbrechen“ Schaltfläche.

Fehler 1603
Der „1603“ ist der beliebteste Fehler unter den Software-Paketieren, denn er bedeutet soviel wie „Es ist ein schwerwiegender Fehler aufgetreten…“. Das heißt soviel wie alles und nichts! Hier kann man dem Fehler nur durch Analyse des MSI Logs näher kommen. Das Log wird im Standard in den %TEMP% Ordner des jeweiligen Computers geschrieben und beginnt mit MSI_. Wenn die Installation mit dem Empirum Advanced Agent durchgeführt wird, so ist die Datei im Ordner %WinDir%\TEMP wiederzufinden. Häufig wird der Fehler am Ende des Logs angezeigt, das man sehr einfach mit STRG+ENDE anspringen kann.

Fehler 0
Warum ist der ERRORLEVEL 0 ein Fehler? Wieso wird das Paket als fehlerhaft in der Console angezeigt bzw. läuft immer wieder, obwohl alles „gut“ aussieht und das Programm auch funktioniert? Dies liegt häufig damit zusammen, dass in Empirum Software-Paketen in denen externe Installer (Hersteller-Setups) aufgerufen werden, auch anschließend eine „Erfolgsüberprüfung“ stattfindet. Da man nicht weiß, ob die Hersteller-Setuproutine das gemacht hat was man von ihr erwartet, prüft man im Anschluß den Erfolg durch die Überprüfung auf das Vorhandensein von Registry Einträgen, Dateien oder Texte in Dateien. Können die zu erwartenden Prüfpunkte nicht erfolgreich geprüft werden, so verzweigt die Installationsabfolge in der Setup.inf in eine Sektion, in der die Empirum Installation mit „Abort“ abgebrochen wird. Der Fehler 0 tritt sehr gerne in MSI Paketen auf.

Folgendes ist zu prüfen bzw. anzupassen:

• Ist der UninstallString in der Registry unterhalb der GUID vorhanden? (Änderung auf InstallDate hilft häufig.)
• Ist es überhaupt die richtige GUID die abgeprüft wird?
• Wird die ReInstSuccessMessageXXXX in dem MSILogFile richtig geprüft? Die aktuellen MSI Vorlagen prüfen 4 ReInstSuccessMessages, da sich die Meldungen mit der Aktualisierung der MSIExec Version geändert haben. Dieser Fehler tritt auch gerne beim Testen der Windows XP Pakete unter Windows 7 auf. Abhilfe schafft hier die Übernahme der 4 ReInstSuccessMessages und das Anpassen der Überprüfung (IF …) in der RepairMSI Sektion. Die Vorlage liefert die aktuelle MSI.inf.

Liste von Fehlermeldungen bzw. ERRORLEVEL Werten

Fehler – Beschreibung
0 – Fehlerfrei
2 – Datei nicht vorhanden
3 – Pfad nicht gefunden
5 – Kein Zugriff möglich
6 – Ungültiger Zugriff/ungültiges Handle
8 – Zu wenig Speicher
10 – Ungültiger Bereich/ungültige Environment Variablen
11 – Ungültiges (Befehls-)Format

MsiExec.exe und InstMsi.exe Fehlermeldungen
Hier geht es zur Microsoft Seite mit der vollständigen Liste der „MsiExec.exe and InstMsi.exe Error Messages (Windows)“

Wert – Fehler-Code – Beschreibung
0 – ERROR_SUCCESS – Die Installation war erfolgreich.
1602 – ERROR_INSTALL_USEREXIT – Der Benutzer hat die Installation abgebrochen.
1603 – ERROR_INSTALL_FAILURE – Es ist ein schwerwiegender Fehler während der Installation aufgetreten.
1642 – ERROR_PATCH_TARGET_NOT_FOUND Der Patch kann nicht installiert werden, weil die zu aktualisierende Software nicht installiert ist.
3010 – ERROR_SUCCESS_REBOOT_REQUIRED Die Installation war erfolgreich, benötigt jedoch einen Neustart!

Der Beitrag Fehler und ErrorLevel aus der Setup.inf erschien zuerst auf Workplace Management Blog.

Das einfache Importieren von *.reg Dateien mit HKCU (HKEY_CURRENT_USER) Einträgen ist dagegen schon fast „fahrlässig“. Die Einstellungen werden ggf. nur für den gerade angemeldeten Benutzer getätigt, wenn es in der Setup.inf nicht richtig eingebunden ist. Dann bekommt der „EmpirumAgent“ diese Einstellungen gesetzt, davon hat jedoch keiner etwas. Wenn nun die *.reg Datei HKCU Einträge beinhaltet, so muss diese im Benutzerteil (Sektion mit CLIENT „geflagged“) importiert werden. Dies kann jedoch bei vorhandenen Group-Policies (GPOs), die den Registry Editor verbietet, zu Problemen führen. Darüberhinaus sind die gleichen Nachteile vorhanden, wie zuvor beschrieben.

Wie bekommt man nun die *.reg Einträge zuverlässig gesetzt und somit in die REG: Sektion der Setup.inf?

Dazu gibt es zwei Methoden:
1. Erstellen der Setup.inf per Differenzmethode
2. Importieren der *.reg Datei in die Setup.inf per PackageEditor

Beides ist bereits in diesem Blogeintrag beschrieben.

Der Beitrag Registry ändern mit REG Dateien erschien zuerst auf Workplace Management Blog.

Die hier beschriebene Methode kann natürlich auch im Maschinenteil zur Anpassung von HKEY_LOCAL_MACHINE Einträgen genutzt werden. Dazu müssen jedoch Anpassungen vorgenommen werden.

[Set:Product]
#Set:User, CLIENT

[Set:User]
Set HKCURegTree = HKEY_CURRENT_USER\Software\Hersteller
Set HKCURegFile = "%TEMP%\hkcu.reg"
Set SearchString = "Alt"
Set ReplaceString = "Neu"
CALLHIDDEN regedit.exe /E %HKCURegFile% %HKCURegTree%
ReplaceTextFile (%HKCURegFile%, %SearchString%, %ReplaceString%, 0)
CALLHIDDEN regedit.exe /S %HKCURegFile%
If %ErrorLevel%<>0 Then Set:CUError EndIf
Del %HKCURegFile%

[Set:CUError]
ErrorLogMsg Error: %ErrorLevel% : Error changing Registry
Abort

Der Beitrag Suchen und Ersetzen in der Registry erschien zuerst auf Workplace Management Blog.

Favoriten

Zumeist interessieren einen immer wieder die gleichen Pfade in der Registry.
Die installierte Software trägt sich in der Registry ein. Die meisten kennen die Einträge in der Systemsteuerung unter „Software hinzufügen“ (Windows XP) oder „Programme“ (Windows 7 und neuer). Die hier angezeigten Informationen werden aus der Registry unterhalb von:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

bzw. auf 64bit Windows Systemen für 32bit Software aus

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall

geholt.

Den Weg dorthin legen die „Kenner“ in wenigen Sekunden zurück.
Mit einem Tipp, können das auch weniger „Geübte“ in Sekunden.
Denn nutzt man die „Favoriten“ im Registry Editor steuert man zielsicher die wichtigsten Einträge an.

So lohnt es sich, die „Favoriten“ in seiner Paketierungsumgebung anzulegen!

Möchte man die Favoriten austauschen, so kann man den nachfolgen Registry Schlüssel exportieren und importieren.

HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Applets\Regedit\Favorites

Hier habe ich Favoriten für die „Uninstall“ und „Run“ Einträge zum Download angehängt.
Registry Favoriten (1059 Downloads )

Schlüsselnamen in die Zwischenablage kopieren.

Eine weitere Hilfestellung ist die Funktion „Schlüsselnamen kopieren“. Damit kann man einen gerade „angesteuerten“ Registrypfad bzw. Schlüssel in die Zwischenablage kopieren und in sein Paket einfügen.

Wenn man den Pfad in eine Reg: Sektion der Empirum Setup.inf einfügt, sollte man aber daran denken die Wurzel mit einem „,“ (Komma) anstatt dem „\“ (Backslash) abzutrennen.

Aus

HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings

wird für die Empirum Setup.inf Datei:

HKCU,Software\Microsoft\Windows\CurrentVersion\Internet Settings

Der Beitrag Tipps für den Windows Registry Editor erschien zuerst auf Workplace Management Blog.

In einer Sektion die mit Reg: beginnt, dürfen jedoch auch nur Registry Veränderungen enthalten sein, da mittels dieser Sektion die Registry API angesprochen wird.

Wie erstellt man nun einen Registry Eintrag oder wie so häufig genannt – Reg Key?

• Aufzeichnung per Differenzanalyseverfahren (Diff)
• Erstellen der Einträge mittels des Package Editors
• Import von Reg Dateien mittels des Package Editors
• Erstellen der Registry Einträge von Hand
• Erstellen eines „Standard“eintrag
• Weitere Erläuterungen
• Benutzerteil

Aufzeichnung per Differenzanalyseverfahren (Diff)

Wenn man ein Paket per „Diff“ aufzeichnet, hat man die erstellten Registry Einträge auch direkt in der REG:Product und ggf. auch der Reg:OnUninstallProduct vorliegen. Hat man ein Paket mit dem MSI oder Unattended Verfahren erstellt, so kann man anschließend die weiteren Anpassungen per Diff festhalten.

Dazu startet man das installierte Programm, wechselt zu dem Menü oder ähnlich, wo man seine Änderung (z.B.: Automatische Updates, Speicherort der Einstellungen, etc.) vornehmen möchte, startet den PackageWizard, wählt die Option „Differenzanalyseverfahren“ und führt den „PreScan“ durch. Ist der „PreScan“ abgeschlossen, führt man die Veränderung, wie die Programmeinstellung durch. Hat man die Einstellungen im Programm abgeschlossen, folgt man den Schritten des PackageWizard Assistenten bis zum Ende. Falls sich die Programmeinstellungen in Registry Änderungen „niederschlagen“, so kann man die Zeilen aus der [REG:Product] Sektion der gerade erstellten Setup.inf in das vorhandene Paket zur Programminstallation übernehmen.

Erstellen der Einträge mittels des Package Editors

Der Empirum Package Editor unterstützt den Benutzer bei der Erstellung von Registry Einträgen in der „Normalen“ und in der „Erweiterten Ansicht“ auf seine Weise. In beiden Fällen muss man zuvor in „Alle Abschnitte“ die Sektion „Reg:Product“ unter „Options“ auswählen.

In der „Normalen Ansicht“ „klickt“ man sich den Eintrag zusammen, in der „Erweiterten Ansicht“ kann man die Unterstützung mittels der Tastenkombination STRG-Leertaste nutzen.

Import von Reg Dateien mittels des Package Editors

Liegt einem bereits eine *.reg Datei vor, so kann man diese mittels des Empirum Package Editors importieren. Wie das geht ist in der Empirum Hilfe beschrieben.

Erstellen der Registry Einträge von Hand

Die Syntax der Registry Änderungen in der Setup.inf sieht auf den ersten Blick „unerlernbar“ aus. Das ist es aber auf keinen Fall! Der Pfad trennt die Wurzel (HKLM, HKCU, etc.) nicht mit einem „\“ (Backslash), sondern mit einem „,“ (Komma). Die meisten Änderungen betreffen Registry Werte vom Typ REG_SZ oder REG_DWORD.

In der Setup.inf steht nicht der Typ in Form von REG_SZ oder REG_DWORD, sondern 0x00000000 bzw. 0x00010001. Hier eine kleine „Eselsbrücke“, wie ich die wichtigsten Änderungen von Hand vornehme.

REG_SZ entspricht 0x00000000 = „NULL X 8 mal die NULL“
REG_DWORD entspricht 0x00010001 = „NULL X, 3 mal NULL, EINS, 3 mal NULL, EINS“

[Reg:Product]
HKLM,"Software\Hersteller\Produkt","Eigenschaft",0x00000000,"Zeichenkette"
HKLM,"Software\Hersteller\Produkt","AutoUpdate",0x00010001,"0"

Hier geht es zur vollständigen Beschreibung.

Erstellen eines „Standard“eintrag

In der Registry gibt es auch die sogenannten (Standard) bzw. (Default) Werte. Diese werden wie folgt erstellt:

[Reg:Product]
HKCR,"Software\Adobe\Acrobat\Exe",,0x00000000,'"%ProgramFiles%\Adobe\Reader 9.0\Reader\AcroRd32.exe"'

Weitere Erläuterungen

Wird die Reg: Sektion auch bei der Deinstallation aufgerufen, so wird die aufgeführte Änderung rückgängig gemacht, was zumeist bedeutet, dass der Eintrag gelöscht wird. Soll ein Eintrag bei der Deinstallation wieder auf den Wert vor der Installation „zurückgesetzt“ werden, so ist in der Setup.inf unter Reg:OnUninstallProduct der „vor der Installations Registry Wert“ einzutragen.

Soll ein Eintrag oder Baum auch bei der Installation gelöscht werden, so ist der Zeile ein „-“ voranzustellen. Hier ein Beispiel:

[Reg:Product]
-HKLM,"Software\Hersteller\Produkt"

So kann man auch bei der Deinstallation die Registry bereinigen, indem man in  der Reg:OnUninstallProduct Sektion ein „löschen“ mittels „-HKLM,…“  durchführt. Doch hier sollte man mit Vorsicht vorgehen, nicht „zuviel“ zu bereinigen!

Benutzerteil

Hat man eine Setup.inf mit „HKCU,…“ Einträgen, so besitzt dieses Paket einen sogenannten Benutzerteil. Damit der Benutzerteil ordnungsgemäß ausgeführt wird, muss die „Command Line Options =“ ein /AW aufweisen. Viel wichtiger ist jedoch, dass das /AW auch im SoftwareDepot, wo das Paket in die Empirum Management Console eingebunden ist unter den Paketeigenschaften, auf dem Register „Prüfung“, der „Befehl“ um ein „/AW“ erweitert wird. Näheres dazu ist wiederum hier zu finden.

Der Beitrag Empirum Paket – Registry ändern erschien zuerst auf Workplace Management Blog.

[Application]
...
MachineKeyName=%DeveloperName%\%ProductName%\%Version%
UserKeyName=%DeveloperName%\%ProductName%
...

Je nach gesetztem Platform Wert (x86) unter [Setup] kann der Eintrag auch unter HKLM\Software\Wow6432Node abgelegt sein. Meines Erachtens werden mit den Standardeinstellungen die Empirum Paket Informationen verstreut in der Registry abgelegt, was ich persönlich nicht so vorteilhaft finde.

Möchte man alle Empirum Paket Informationen in der Registry unter einem Eintrag zusammengefasst haben, so müssen die angesprochenen Einträge, ähnlich wie hier angegeben, geändert werden.

[Application]
...
MachineKeyName=EmPack\%DeveloperName%\%ProductName%\%Version%
UserKeyName=EmPack\%DeveloperName%\%ProductName%
...

Der Beitrag Anpassung Paketierungsvorlage – Empirum Paket Informationen in der Registry erschien zuerst auf Workplace Management Blog.