Fehlerbehebung bei fehlgeschlagenen Chocolatey-Paketen

Diagnostizieren Sie fehlgeschlagene Chocolatey-Paketinstallationen, indem Sie die Installationsphasen verstehen und Fehlermeldungen in den Protokollen finden.

Wie im vorherigen Abschnitt erläutert, besteht eine chocolatey-Paketinstallation aus mehreren Phasen:

1. Initialisierung der chocolatey-Umgebung und -Variablen
2. Prüfung auf vorhandene Installationen der zu installierenden Software
3. Mögliche Deinstallation vorhandener Installationen
4. Herunterladen von Binärdateien
5. Eigentliche Installation mithilfe der heruntergeladenen Setup-Binärdateien.
6. Nachgelagerte Aktionen, die nach der Installation ausgeführt werden

Auch wenn jede Phase die Chance hat, zu fehlschlagen und die Installation abzubrechen, liegt die höchste Ausfallwahrscheinlichkeit in Phase 3, 4 und 5.

Das Finden der richtigen Fehlermeldung

Es ist wichtig zu wissen, dass jede fehlgeschlagene Installation standardmäßige chocolatey-Fehler-Stack-Meldungen zurückgibt, die ungefähr so aussehen:

2021-08-23 09:48:58,465 [DEBUG] - Verschieben von 'C:\ProgramData\chocolatey\lib\generic-autodesk-navisworks-freedom-2022'
 nach 'C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022'
2021-08-23 09:48:58,480 [WARN ] - Dies ist Versuch 1/3. Erneuter Versuch nach 300 Millisekunden.
 Fehler in Warnung umgewandelt:
 (5) Zugriff verweigert: [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]

Die Zugriff verweigert gehört zum standardmäßigen Fehler-Stack von chocolatey und muss ignoriert werden. Der eigentliche Fehler, der das Fehlschlagen der Paketinstallation verursacht, befindet sich irgendwo in den vorherigen Zeilen der Protokolldatei. Die Suche nach dem Tag [ERROR] hilft dabei, die richtigen Meldungen zu finden.

Sehen Sie, wie in diesem Beispiel der eigentliche Fehler oben auftritt (404 beim Download), aber der chocolatey-Fehler-Stack später irreführende 'Zugriff verweigert'-Meldungen ausgibt.

Eigentlicher Downloadfehler oben, gefolgt vom standardmäßigen chocolatey-Fehler-Stack unten, kann irreführend sein.

Beispiele für fehlgeschlagene Installationen

Fehler, die während der Initialisierung auftreten

Während der Initialisierungsphase können Fehler aus folgenden Gründen auftreten:

• Problem mit der chocolatey-Installation selbst (defekte Konfiguration, fehlende Dateien):

2023-10-10 10:28:32,523 [ERROR] - Fehler beim Deserialisieren der Antwort vom Typ chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 '.', der hexadezimale Wert 0x00, ist ein ungültiges Zeichen. Zeile 1, Position 1.
2023-10-10 10:28:32,535 [ERROR] - '.', der hexadezimale Wert 0x00, ist ein ungültiges Zeichen. Zeile 1, Position 1.
2023-10-10 10:28:32,537 [DEBUG] - Beenden mit 1

Vorsicht, da diese (leicht ähnliche) Meldung auch in der chocolatey.log auftreten kann, aber dies kann bedenkenlos ignoriert werden und erfordert keine Aktion!

2023-11-21 11:46:10,365 [ERROR] - Fehler beim Serialisieren vom Typ chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 Der Zugriff auf den Pfad 'C:\ProgramData\chocolatey\config\chocolatey.config.update' wurde verweigert.

• Netzwerkproblem, wenn der RealmJoin-NuGet-Server nicht erreicht werden kann, (siehe Infrastrukturüberlegungen):

2023-09-08 13:01:47,335 [ERROR] - generic-adobe-reader-dc-continuous nicht installiert. Das Paket wurde mit den aufgeführten Quelle(n) nicht gefunden.

• Problem mit fehlenden obligatorischen Paketargumenten:

2023-09-14 13:53:33,982 [ERROR] - FEHLER: Obligatorisches Argument 'Serial' nicht angegeben, Abbruch!

Fehler, die während des Downloads auftreten

Bei Fehlern im Zusammenhang mit dem Herunterladen der Binärdateien enthält die Fehlermeldung normalerweise die Download-URL mit cdn.realmjoin.com, Beispiele:

2023-10-16 13:04:52,952 [ERROR] - FEHLER: Die Remotedatei existiert entweder nicht, ist nicht autorisiert oder für die URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp' gesperrt. Ausnahme beim Aufruf von "GetResult" mit 0 Argument(en): "Daten konnten nicht aus der Transportverbindung gelesen werden: Eine bestehende Verbindung wurde von der Software auf Ihrem Hostcomputer abgebrochen."

2021-08-23 09:36:08,874 [ERROR] - FEHLER: Die Remotedatei existiert entweder nicht, ist nicht autorisiert oder für die URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp' gesperrt. Ausnahme beim Aufruf von "GetResult" mit 0 Argument(en): "Auf dem Datenträger ist nicht genügend Speicherplatz vorhanden"

Fehler, die während des (De-)Installationsprozesses auftreten

Fehler, die während des eigentlichen (De-)Installationsprozesses mithilfe der heruntergeladenen Binärdatei auftreten, lassen sich am besten mit zwei Dingen analysieren:

1. Der vom Setup-Prozess zurückgegebene Exit-Code.
2. Die vom Setup-Prozess geschriebene Protokolldatei, zu finden unter C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\, sofern der Installer die Möglichkeit zum Schreiben eines Logs bietet.

Wenn ein MSI-Installer verwendet wurde, sind die Exit-Codes standardisiert und können nachgeschlagen werden hier. Außerdem schreiben MSI-Installer immer Protokolldateien in den oben genannten Ordner. Besonders wenn der Exit-Code 1603 zurückgegeben wurde (generischer MSI-Fehler), ist die MSI-Protokolldatei für die Fehlersuche zwingend erforderlich.