> 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/fixes-for-common-issues.md).

# Lösungen für häufige Probleme

Gezielte Lösungen für häufige Probleme bei der Installation von RealmJoin-Paketen, z. B. BranchCache-Fehler, für bestimmte Szenarien.

{% hint style="danger" %}
**Nur diese Korrekturen in den beschriebenen Szenarien verwenden!**

**Diese sind nicht dafür gedacht, blind angewendet zu werden, da sie bei unnötiger Anwendung mehr Schaden anrichten können.**
{% endhint %}

## BranchCache-Probleme

* Fehlermeldung `Nicht genügend Speicherplatz auf dem Datenträger` (kann je nach Windows-OS-Sprache auch lokalisiert auftreten) in der Downloadphase, Chocolatey-Exit-Code `404`:
  1. Eine erhöhte PowerShell öffnen
  2. Erneut ausführen `Clear-BCCache -Force`
* Fehlermeldung `Das bereitgestellte Objekt wurde nicht initialisiert` (kann je nach Windows-OS-Sprache auch lokalisiert auftreten) in der Downloadphase, Chocolatey-Exit-Code `404`:
  1. Eine erhöhte PowerShell öffnen
  2. Erneut ausführen `Reset-BC -Force`
* Fehlermeldung `Fehler - Hashes stimmen nicht überein. Der tatsächliche Wert war '123abcd'`:
  1. Eine erhöhte PowerShell öffnen
  2. Erneut ausführen `Reset-BC -Force`

{% hint style="warning" %}
Wir empfehlen dringend, das **BranchCache zurückzusetzen oder zu leeren** Remediation Script mit einem täglichen Zeitplan bereitzustellen. Es ist im [Remediation-Skripte](https://docs.realmjoin.com/de/automatisierung/remediation-scripts.md) Abschnitt des RealmJoin Portals zu finden.

Durch diese Methode werden die oben genannten BranchCache-Probleme proaktiv erkannt und automatisch behoben (falls möglich).
{% endhint %}

## Wachsender Chocolatey-Temporärordner

Installationsdateien für Chocolatey-Pakete werden nach `C:\Windows\Temp\chocolatey\<package-id>\<version>\` und werden nach der Installation nicht entfernt. Dies gilt sowohl für die klassische Chocolatey-Engine als auch für die [Native Choco Runtime](https://docs.realmjoin.com/de/realmjoin-agent/realmjoin-client/native-choco-runtime.md). Im Laufe der Zeit kann der Ordner einen beträchtlichen Teil des Speicherplatzes belegen.

Wenn dieser Ordner automatisch bereinigt werden soll, stellen Sie das **Bereinigen des Chocolatey-Temporärordners** Remediation Script aus dem [Remediation-Skripte](https://docs.realmjoin.com/de/automatisierung/remediation-scripts.md) Abschnitt des RealmJoin Portals bereit. Es entfernt Paketversionsordner, die älter als 7 Tage sind.

## Fehlende / falsche Paketargumente <a href="#user-content-missing-wrong-package-arguments" id="user-content-missing-wrong-package-arguments"></a>

1. Prüfen Sie die `chocolatey.log` Datei auf den Wert/die Werte von `packageParameters` im Abschnitt `RJAppDeployToolkit: Ergebnisvariablen`
   * Dies sind die tatsächlichen Werte, die für die Installation verwendet und vom RealmJoin-Backend übergeben werden.
2. Wenn sie nicht den Werten entsprechen, die Sie erwarten würden, prüfen Sie die Paketzuweisung im RealmJoin-Portal auf Überschreibungswerte für Gruppe / Benutzer.

## Beschädigte .nupkg-Datei

Wenn Sie den folgenden Fehler in der `chocolatey.log` die .nupkg-Datei wurde beschädigt:

`[ERROR] - Das Paket konnte nicht vom Pfad 'generic-package-id\generic-package-id.nupkg' gelesen werden.`

Häufig lässt sich auch beobachten, dass die .nupkg-Datei eine Größe von 0 Bytes hat.

Schritte zur Behebung dieses Problems:

1. Navigieren Sie zu `C:\ProgramData\chocolatey\lib`
2. Ordner löschen `generic-package-id`

## Beschädigte Chocolatey-Konfiguration <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

1. Inhalt des Ordners löschen `C:\ProgramData\chocolatey\config`
2. Systemvariable löschen `ChocolateyInstall` :
   * GUI verwenden: Ausführen `sysdm.cpl` -> Registerkarte `Erweitert` -> `Umgebungsvariablen...`
   * Verwenden Sie (Admin-)cmd, führen Sie aus: `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall`
3. Neustart
4. Im RealmJoin-Tray wird Chocolatey neu installiert; lassen Sie das System 5-10 Minuten zur Ruhe kommen.
5. Wenn im RealmJoin-Tray-Menü Einträge fehlen, starten Sie erneut neu.

## Allgemeine Setup-Probleme <a href="#user-content-general-setup-issues" id="user-content-general-setup-issues"></a>

**Da diese sehr individuell sind, ist dies nur eine Sammlung allgemeiner Schritte zur Fehlerbehebung, um das Problem weiter einzugrenzen.**

* Nach Protokolldatei(en) in `C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\`.
  * Versuchen Sie, die Protokolldatei(en) zu analysieren und das Problem zu finden.
* Wenn keine Protokolldatei vorhanden ist oder sie nicht hilfreich ist, versuchen Sie, das Setup manuell im GUI-Modus auszuführen, um mögliche Fehlermeldungen zu sehen.
  * WICHTIG: RealmJoin-Systempakete werden immer mit dem integrierten `NT AUTHORITY\SYSTEM` Konto installiert, daher ist es am besten, ein Tool wie `psexec` zu verwenden, um die Installation von diesem Konto auszuführen.
  * Meistens liefert die Ausführung der Installation mit einem lokalen Standard-Administratorkonto denselben Fehler, sodass die Ausführung von `NT AUTHORITY\SYSTEM` möglicherweise nicht erforderlich ist.

### Paket nicht zur Installation verfügbar / wird im RealmJoin-Tray-Menü nicht angezeigt <a href="#user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu" id="user-content-package-not-available-to-install-not-showing-in-realmjoin-tray-menu"></a>

* Prüfen Sie, ob das Paket dem Benutzer korrekt zugewiesen ist oder der Benutzer Mitglied der zugewiesenen Gruppe ist
* Prüfen Sie, ob das Paket nicht ausgeblendet zugewiesen ist (verwenden Sie den Debug-Modus, um ausgeblendete zugewiesene Pakete anzuzeigen)
* Prüfen Sie, ob der Benutzer der primäre Benutzer des Clients ist; alternativ prüfen Sie, ob das Paket so konfiguriert ist, dass es für sekundäre Benutzer verfügbar ist


---

# 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/fixes-for-common-issues.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.
