Analyse der chocolatey.log

Dieser Abschnitt konzentriert sich darauf, wie man fehlgeschlagene Chocolatey-Paketinstallationen behebt.

Anforderungen

Für die Fehlerbehebung werden die folgenden Elemente benötigt oder sind hilfreich:

• Protokolldateien, insbesondere chocolatey.log.

• Texteditor Ihrer Wahl mit erweiterten Suchfunktionen, empfohlen: Notepad++, Visual Studio Code.

• Paket-ID des fehlgeschlagenen Pakets, z. B. generic-mozilla-firefox.

• Zeitstempel der fehlgeschlagenen Installation(en) (nicht zwingend erforderlich, aber hilfreich).

Aufbau der Protokolldatei

Einstiegspunkt und Debug-Informationen

Um den Einstiegspunkt der Paketinstallation innerhalb der chocolatey.log verwenden Sie diese genaue Suchzeichenfolge (passen Sie die Paket-ID entsprechend an): generic-mozilla-firefox --version= (wenn Sie sich hinsichtlich der Versionszeichenfolge sicher sind, können Sie diese natürlich hinzufügen, sie ist jedoch nicht zwingend erforderlich)

Auf diese Weise finden Sie den/die Startpunkt(e) des choco-Prozesses für die Installation oder das Upgrade des angegebenen Paket-ID.

Die vollständige Zeile im Protokoll kann so aussehen, anstatt upgrade kann auch sein install je nach Vorgang:

2023-08-22 15:05:36,664 [DEBUG] - Command line: "C:\ProgramData\chocolatey\choco.exe" upgrade generic-mozilla-firefox --version=117.0.0.0 --force --yes --ignore-package-exit-codes --timeout=14400 --params="/BlockAddons:1"

Einstiegspunkt einer choco-Installation innerhalb der chocolatey.log

Diese Zeile enthält bereits einige wichtige Informationen, wie die zu installierende Paketversionsnummer sowie die verwendeten Params (Paketargumente, die im RealmJoin-Portal konfiguriert wurden).

Die folgenden Zeilen werden viele (nicht relevante) Debug-Informationen enthalten, unter anderem wird der komplette Inhalt von chocolateyInstall.ps1 ausgegeben. Innerhalb der Debug-Informationen finden Sie die beiden Abschnitte RJAppDeployToolkit: Input Environment Variables als auch für RJAppDeployToolkit: Resulting Variables. Beide Abschnitte befinden sich nebeneinander und zeigen Variablen und Werte, die vom RJAppDeployToolkit

Ausgabe des RJAppDeployToolkit

Installationsvorgang

Das eigentliche Paketinstallationsskript beginnt nach der folgenden Protokollmeldung:

2023-08-22 15:05:47,000 [DEBUG] - Running 'C:\ProgramData\chocolatey\lib\generic-mozilla-firefox\tools\chocolateyInstall.ps1'

Abhängig vom Installationsskript des Pakets und dem Zustand des Clients ist der erste Schritt in der Regel eine Prüfung, ob die Software bereits installiert ist. Dies dient dazu festzustellen, ob eine Deinstallation vor der eigentlichen Installation erforderlich ist. In den Protokollen kann dies durch eine oder mehrere der folgenden Protokollmeldungen nachverfolgt werden:

2023-08-22 15:05:47,057 [DEBUG] - Entered function 'Get-RealmjoinRegistryUninstallInfo' with parameters [...]]

2023-08-22 15:05:47,053 [DEBUG] - Entered function 'Uninstall-RealmjoinPackage' with parameters [...]]

Nachdem die Prüfungen und die möglichen Deinstallationen ausgeführt wurden, startet die Hauptinstallation der Anwendung, was durch die folgende Protokollmeldung angezeigt wird (Dateiname wird natürlich abweichen):

2023-08-22 15:05:47,858 [INFO ] - Starting RealmJoin-Install of Git-2.42.0-64-bit.exe

Die Installation beginnt in der Regel mit dem Herunterladen der Binärdatei. Beginn und Ende des Downloads werden durch die folgenden Protokollmeldungen dargestellt:

2023-08-22 15:05:48,273 [INFO ] - Downloading generic-git-git from 'https://cdn.realmjoin.com/blobs/generic/generic-git-git/Git-2.42.0-64-bit.exe'

[...]

2023-08-22 15:05:57,293 [INFO ] - Download of Git-2.42.0-64-bit.exe (58.35 MB) completed.

Nach Abschluss des Downloads überprüft chocolatey den Hash der heruntergeladenen Datei und vergleicht ihn mit dem erwarteten Wert. Stimmen die Hashes überein, wird die Setup-Datei schließlich ausgeführt. Die Protokollmeldung für die Ausführung ist durch die folgende Protokollmeldung zu finden:

2023-08-22 15:06:00,743 [DEBUG] - Elevating Permissions and running ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ]. This may take a while, depending on the statements.

Diese Nachricht enthält den Dateipfad zur Setup-Datei sowie die vollständige Befehlszeile einschließlich aller (stillen) Parameter, die zum Starten der Setup-Datei verwendet wurden. Sie hilft auch dabei, den relevanten Pfad zur Setup-Protokolldatei zu finden, falls dieser von der Setup-Datei angeboten und im Paket-Skript angegeben wurde.

Nachdem der Prozess beendet ist, wird eine weitere Protokollmeldung geschrieben, die erneut den vollständigen Dateipfad und alle Parameter enthält. Zusätzlich enthält diese Meldung auch den von dem Setup-Prozess zurückgegebenen Exit-Code, den wichtigsten Indikator für eine erfolgreiche oder nicht erfolgreiche Installation:

2023-08-22 15:06:52,321 [DEBUG] - Command ["C:\WINDOWS\TEMP\chocolatey\generic-git-git\2.42.0.0\Git-2.42.0-64-bit.exe" /verysilent /norestart /log="C:\WINDOWS\Logs\RealmJoin\Packages\generic-git-git\2023-08-22_15-05-47.916_generic-git-git_2.42.0.0_install_Git-2.42.0-64-bit.exe.log" ] exited with '0'.

Je nach Paket kann der Paketinstallation nun ein sogenannter 'postActions'-Abschnitt folgen, bei dem es sich um einige Registrierungseinstellungen, das Entfernen von Desktopsymbolen oder sogar das Ausführen einer weiteren Setup-Datei handeln kann (wodurch erneut ein Download dieser Datei gestartet wird). Der postActions-Teil wird in der Protokolldatei durch die folgenden Anfangs- und Endmeldungen gekennzeichnet:

2023-09-13 16:49:18,550 7224 [INFO ] - Running postActions...
2023-09-13 16:49:20,894 7224 [INFO ] - postActions finished.

Der chocolatey-Installationsvorgang wird mit der folgenden Protokollmeldung beendet (Wortlaut kann je nach Installation/Upgrade unterschiedlich sein):

2023-09-13 17:01:39,433 8336 [INFO ] - The install of generic-google-chrome was successful.