> 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).

# Problembehandlung fehlgeschlagener Chocolatey-Pakete

Analysieren Sie fehlgeschlagene Chocolatey-Paketinstallationen, indem Sie die Installationsschritte 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 der Variablen
2. Überprüfen auf vorhandene 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. Nachgelagerte Aktionen, die nach der Installation ausgeführt werden

Auch wenn jede Phase scheitern und dazu führen kann, dass die Installation abgebrochen wird, 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-Stackmeldungen zurückgibt, die ähnlich wie folgt aussehen werden:

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

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

{% endcode %}

Die `Zugriff verweigert` Die Nachricht gehört zum standardmäßigen Fehler-Stack von chocolatey und muss ignoriert werden. Der tatsächliche Fehler, der dazu führt, dass die Paketinstallation fehlschlägt, befindet sich irgendwo in den vorherigen Zeilen der Protokolldatei. Das Suchen nach dem Tag `[ERROR]` hilft dabei, die richtigen Nachrichten zu finden.

Sehen Sie, wie in diesem Beispiel der eigentliche Fehler oben auftritt (404 beim Download), der chocolatey-Fehler-Stack später jedoch einige irreführende 'Access is denied'-Meldungen ausgibt.

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBPOlb5tEzZXYAtjilVX5%2Fchoco-error-stack.png?alt=media&amp;token=4c5d5eba-d915-45f1-89c0-834ea477db65" alt=""><figcaption><p>Eigentlicher 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 Fehler aus folgenden Gründen 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" %}
Vorsicht, da diese (leicht ähnliche) Meldung auch in der `chocolatey.log` ebenfalls auftreten kann, aber dies kann gefahrlos ignoriert werden und erfordert keine Aktion!

{% code overflow="wrap" %}

```log
2023-11-21 11:46:10,365 [ERROR] - Fehler beim Serialisieren des Typs chocolatey.infrastructure.app.configuration.ConfigFileSettings:
 Der 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 [Überlegungen zur Infrastruktur](https://docs.realmjoin.com/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 zwingenden Paketargumenten:

{% code overflow="wrap" %}

```log
2023-09-14 13:53:33,982 [ERROR] - FEHLER: Pflichtargument 'Serial' wurde 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 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' verboten. Ausnahme beim Aufruf von "GetResult" mit "0" Argument(en): "Die Daten konnten nicht aus der Transportverbindung gelesen werden: Eine hergestellte Verbindung wurde von der Software auf Ihrem Hostcomputer abgebrochen."
```

{% endcode %}

{% code overflow="wrap" %}

```log
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' verboten. Ausnahme beim Aufruf von "GetResult" mit "0" Argument(en): "Auf dem Datenträger ist nicht genügend Speicherplatz vorhanden"
```

{% endcode %}

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

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 Protokolls bietet.

{% 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). Zusätzlich schreiben MSI-Installer immer Logdateien in den oben genannten Ordner. Besonders wenn der Exit-Code `1603` Wurde zurückgegeben (generischer MSI-Fehler), ist die MSI-Protokolldatei für die Problembehandlung zwingend 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
