> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/fehlerbehebung-and-faq/troubleshooting/package-installation-issues/troubleshooting-failed-chocolatey-packages.md).

# Fehlerbehebung bei fehlgeschlagenen Chocolatey-Paketen

Wie im vorherigen Abschnitt erklärt, besteht eine chocolatey-Paketinstallation aus mehreren Phasen:

1. Initialisierung der chocolatey-Umgebung und Variablen
2. Überprüfung vorhandener Installationen der zu installierenden Software
3. Mögliche Deinstallation vorhandener Installationen
4. Herunterladen von Binärdateien
5. Tatsächliche Installation mithilfe der heruntergeladenen Setup-Binärdateien.
6. Nacharbeiten, die nach der Installation auszuführen sind

Obwohl jede Phase scheitern und die Installation abbrechen kann, ist die Wahrscheinlichkeit für Fehler in Phase 3, 4 und 5 am höchsten.

## Die richtige Fehlermeldung finden

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

{% code overflow="wrap" fullWidth="false" %}

```log
2021-08-23 09:48:58,465 [DEBUG] - Moving 'C:\ProgramData\chocolatey\lib\generic-autodesk-navisworks-freedom-2022'
 zu 'C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022'
2021-08-23 09:48:58,480 [WARN ] - Dies ist Versuch 1/3. Neuer Versuch nach 300 Millisekunden.
 In Warnung umgewandelter Fehler:
 (5) Zugriff verweigert: [\\?\C:\ProgramData\chocolatey\lib-bad\generic-autodesk-navisworks-freedom-2022]
```

{% endcode %}

Die `Zugriff verweigert` Meldung gehört zum standardmäßigen Fehler-Stack von chocolatey und muss ignoriert werden. Der eigentliche Fehler, der dazu führt, dass die Paketinstallation fehlschlägt, befindet sich irgendwo in den vorherigen Zeilen der Protokolldatei. Die Suche nach dem Tag `[ERROR]` hilft beim Finden der richtigen Meldungen.

Man sieht in diesem Beispiel, dass der eigentliche Fehler oben auftritt (404 beim Download), aber der chocolatey-Fehler-Stack später einige irreführende Meldungen wie „Access is denied“ ausgibt.

<figure><img src="/files/eca332454d69d9d131d193a6b3ea38e78dfefffb" alt=""><figcaption><p>Tatsächlicher Downloadfehler oben, gefolgt vom standardmäßigen chocolatey-Fehler-Stack unten, kann irreführend sein.</p></figcaption></figure>

## Beispiele für fehlgeschlagene Installationen

### Fehler, die während der Initialisierung auftreten

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

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

{% code overflow="wrap" %}

```log
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
```

{% endcode %}

{% hint style="warning" %}
Seien Sie vorsichtig, da diese (leicht ähnliche) Meldung auch in der `chocolatey.log` auftreten kann, aber dies kann gefahrlos ignoriert werden und erfordert keinerlei Maßnahmen!

{% code overflow="wrap" %}

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

{% endcode %}
{% endhint %}

* Netzwerkproblem, wenn der RealmJoin-nuget-Server nicht erreicht werden kann, (siehe [Infrastrukturüberlegungen](/de/bereitstellung/infrastructure.md#realmjoin-connection-endpoints)):

{% code overflow="wrap" %}

```log
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.
```

{% endcode %}

* Problem mit fehlenden obligatorischen Paketargumenten:

{% code overflow="wrap" %}

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

{% endcode %}

### 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:

{% code overflow="wrap" %}

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

{% endcode %}

{% code overflow="wrap" %}

```log
2021-08-23 09:36:08,874 [ERROR] - FEHLER: Die entfernte Datei existiert entweder nicht, ist nicht autorisiert oder für die URL 'https://cdn.realmjoin.com/blobs/generic/generic-adobe-acrobat-dc-continuous/AcrobatDCUpd2300620320.msp' verboten. Ausnahme beim Aufruf von "GetResult" mit "0" Argument(en): "Nicht genügend Speicherplatz auf der Festplatte"
```

{% endcode %}

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

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

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

{% hint style="info" %}
Wenn ein MSI-Installer verwendet wurde, sind die Exit-Codes standardisiert und können nachgeschlagen werden [hier](https://learn.microsoft.com/en-us/windows/win32/msi/error-codes). 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 Fehlerbehebung erforderlich.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/de/fehlerbehebung-and-faq/troubleshooting/package-installation-issues/troubleshooting-failed-chocolatey-packages.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
