Lösungen für häufige Probleme

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.

BranchCache-Probleme

• Fehlermeldung Auf der Festplatte ist nicht genügend Speicherplatz vorhanden (kann je nach Windows-OS-Sprache auch lokalisiert auftreten) in der Download-Phase, Chocolatey-Exit-Code 404:

  1. Öffnen Sie eine erhöhte PowerShell

  2. Ausführen Clear-BCCache -Force

• Fehlermeldung Das übergebene Objekt wurde nicht initialisiert (kann je nach Windows-OS-Sprache auch lokalisiert auftreten) in der Download-Phase, Chocolatey-Exit-Code 404:

  1. Öffnen Sie eine erhöhte PowerShell

  2. Ausführen Reset-BC -Force

• Fehlermeldung Fehler - Hashes stimmen nicht überein. Der tatsächliche Wert war '123abcd':

  1. Öffnen Sie eine erhöhte PowerShell

  2. Ausführen Reset-BC -Force

Wir empfehlen dringend, das Reset oder Clear BranchCache Remediation-Skript mit einem täglichen Zeitplan bereitzustellen. Es ist zu finden im Behebungs-Skripte Abschnitt des RealmJoin-Portals.

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

Fehlende / falsche Paketargumente

1. Prüfen Sie die chocolatey.log Datei auf den 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 sie nicht die erwarteten Werte sind, prüfen Sie die Paketzuweisung im RealmJoin-Portal auf Gruppen-/Benutzerüberschreibungswerte.

Beschädigte .nupkg-Datei

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

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

Oft kann man 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

1. Inhalt des Ordners löschen C:\ProgramData\chocolatey\config

2. Systemvariable löschen ChocolateyInstall :

   • GUI verwenden: Ausführen sysdm.cpl -> Reiter Erweitert -> Umgebungsvariablen...

   • Verwenden Sie (Admin-)CMD, führen Sie aus: REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall

3. Neustarten

4. Der RealmJoin-Tray installiert Chocolatey neu, lassen Sie das System 5–10 Minuten zur Ruhe kommen.

5. Wenn Sie fehlende Einträge im RealmJoin-Tray-Menü feststellen, starten Sie den Rechner erneut.

Allgemeine Setup-Probleme

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

• Prüfen Sie auf Logdatei(en) in C:\WINDOWS\Logs\RealmJoin\Packages\<package-id>\.

  • Versuchen Sie, die Logdatei(en) zu analysieren und das Problem zu finden.

• Wenn keine Logdatei vorhanden oder 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 Konto installiert NT AUTHORITY\SYSTEM deshalb 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 normalen lokalen Administratorkonto denselben Fehler, sodass das Ausführen von NT AUTHORITY\SYSTEM möglicherweise nicht erforderlich ist.

Paket nicht verfügbar zur Installation / wird nicht im RealmJoin-Tray-Menü angezeigt

• Prüfen Sie, ob das Paket korrekt dem Benutzer zugewiesen ist oder der Benutzer Mitglied der zugewiesenen Gruppe ist

• Prüfen Sie, ob das Paket nicht versteckt zugewiesen ist (verwenden Sie den Debug-Modus, um versteckt zugewiesene Pakete zu sehen)

• 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 sekundären Benutzern zur Verfügung steht

ConfigUpdater nicht autorisiert

Der RJ-Agent kann nicht auf die Konfiguration zugreifen

Das primäre Problem, 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 ist der erwartete Prozess jedoch fehlgeschlagen, wodurch das Token veraltet wurde und es zu Zugriffsproblemen kam. Dies unterstreicht die Bedeutung, sicherzustellen, dass die automatisierten Mechanismen zur Tokenaktualisierung korrekt funktionieren, um ähnliche Probleme in der Zukunft zu vermeiden. Die Behebung dieser Grundursache hilft, einen 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. Neustarten