# 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 der Festplatte ist nicht genügend Speicherplatz vorhanden` (kann je nach Windows-Betriebssystemsprache auch lokalisiert auftreten) in der Downloadphase, Chocolatey-Exit-Code `404`:
  1. Öffnen Sie eine PowerShell mit erhöhten Rechten
  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. Öffnen Sie eine PowerShell mit erhöhten Rechten
  2. Ausführen `Reset-BC -Force`
* Fehlermeldung `Fehler – Hashes stimmen nicht überein. Der tatsächliche Wert war '123abcd'`:
  1. Öffnen Sie eine PowerShell mit erhöhten Rechten
  2. Ausführen `Reset-BC -Force` 

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

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

## 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/die Wert(e) 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 dies nicht die Werte sind, die Sie erwarten würden, prüfen Sie die Paketzuteilung 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:&#x20;

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

Oft ist außerdem zu 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`&#x20;

## 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...`
   * (Admin-)CMD verwenden, ausführen: `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall`
3. Neustart
4. Die RealmJoin-Taskleiste wird Chocolatey neu installieren; lassen Sie das System 5–10 Minuten zur Ruhe kommen.
5. Wenn Ihnen fehlende Einträge im RealmJoin-Taskleistenmenü auffallen, 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, handelt es sich hier nur um eine Sammlung allgemeiner Troubleshooting-Schritte, um das Problem weiter einzugrenzen.**

* Prüfen Sie, ob 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 standardmäßigen lokalen Administratorkonto denselben Fehler, sodass eine Ausführung von `NT AUTHORITY\SYSTEM` möglicherweise nicht erforderlich ist.

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

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

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FxKesgpauzdfJFk4dj4Ep%2F25-07-02-10_40_03_Photos.png?alt=media&#x26;token=bbc6af39-5123-4135-a2a2-f2727cc13acb" 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 Vorgang jedoch fehl, wodurch das Token veraltet wurde und somit Zugriffsprobleme entstanden. Dies unterstreicht, wie wichtig es ist sicherzustellen, dass die automatischen Token-Aktualisierungsmechanismen korrekt funktionieren, um ähnliche Probleme in Zukunft zu vermeiden. Die Behebung dieser Grundursache hilft dabei, einen konsistenten Zugriff aufrechtzuerhalten und Unterbrechungen in

1. Die RealmJoin-Token-Datei löschen:
   * C:\Program Files\RealmJoin `%LOCALAPPDATA%\RealmJoin`
   * RJ 4.19 und älter `token2.dat`
   * RJ 4.20 und neuer: `msal_cache.dat`
2. Neustart