# Lösungen für häufige Probleme

{% hint style="danger" %}
**Verwenden Sie diese Korrekturen nur in den beschriebenen Szenarien!**

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

## BranchCache-Probleme

* Fehlermeldung `Auf dem Datenträger ist nicht genügend Speicherplatz vorhanden` (kann je nach Windows-Betriebssystemsprache auch lokalisiert auftreten) in der Downloadphase, chocolatey-Exit-Code `404`:
  1. Eine PowerShell mit erhöhten Rechten öffnen
  2. Ausführen `Clear-BCCache -Force`
* Fehlermeldung `Das bereitgestellte Objekt wurde nicht initialisiert` (kann je nach Windows-Betriebssystemsprache auch lokalisiert auftreten) in der Downloadphase, chocolatey-Exit-Code `404`:
  1. Eine PowerShell mit erhöhten Rechten öffnen
  2. Ausführen `Reset-BC -Force`
* Fehlermeldung `Fehler - Hashes stimmen nicht überein. Der tatsächliche Wert war '123abcd'`:
  1. Eine PowerShell mit erhöhten Rechten öffnen
  2. Ausführen `Reset-BC -Force`

{% hint style="warning" %}
Wir empfehlen dringend, das **BranchCache zurücksetzen oder löschen** Remediation-Skript mit täglichem Zeitplan bereitzustellen. Es ist im [Remediation Scripts](/de/automatisierung/remediation-scripts.md) Bereich des RealmJoin-Portals zu finden.

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

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

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

## Beschädigte .nupkg-Datei

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

`[ERROR] - Unable to read package from path 'generic-package-id\generic-package-id.nupkg'.`

Oft ist auch zu beobachten, dass die .nupkg-Datei eine Größe von 0 Byte hat.

Schritte zur Behebung dieses Problems:

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

## Fehlerhafte 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...`
   * (als Administrator) cmd verwenden, ausführen: `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall`
3. Neustart
4. Das RealmJoin-Systray wird chocolatey neu installieren; lassen Sie das System 5–10 Minuten lang zur Ruhe kommen.
5. Wenn im RealmJoin-Systray-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 mit 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 notwendig ist.

### Paket nicht zur Installation verfügbar / wird im RealmJoin-Systray-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 verborgen zugewiesen ist (verwenden Sie den Debug-Modus, um verborgene zugewiesene Pakete zu sehen)
* Prüfen Sie, ob der Benutzer der Primärbenutzer des Clients ist; andernfalls prüfen Sie, ob das Paket so konfiguriert ist, dass es für sekundäre Benutzer verfügbar ist

## ConfigUpdater nicht autorisiert <a href="#user-content-broken-chocolatey-config" id="user-content-broken-chocolatey-config"></a>

<figure><img src="/files/dfe5d9e8d53bba099def9fcb770489f851487c28" alt=""><figcaption><p>Der RJ-Agent kann nicht auf die Konfiguration zugreifen</p></figcaption></figure>

Das Hauptproblem, das dieses Problem verursacht, ist, dass das Zugriffstoken nicht wie erwartet automatisch aktualisiert wurde. Normalerweise werden Zugriffstoken automatisch aktualisiert, um einen unterbrechungsfreien Zugriff auf Ressourcen zu gewährleisten. In diesem Fall schlug der erwartete Prozess jedoch fehl, wodurch das Token veraltet wurde und dadurch Zugriffsprobleme entstanden. Dies zeigt, wie wichtig es ist sicherzustellen, dass die automatisierten Token-Aktualisierungsmechanismen korrekt funktionieren, um ähnliche Probleme in Zukunft zu verhindern. Die Behebung dieser Grundursache wird dazu beitragen, den konsistenten Zugriff aufrechtzuerhalten und Unterbrechungen in

1. Löschen Sie die RealmJoin-Token-Datei:
   * Pfad: `%LOCALAPPDATA%\RealmJoin`
   * RJ 4.19 und darunter `token2.dat`
   * RJ 4.20 und höher: `msal_cache.dat`
2. Neustart


---

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

```
GET https://docs.realmjoin.com/de/sonstiges/troubleshooting/package-installation-issues/fixes-for-common-issues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.