Lösungen für häufige Probleme

Gezielte Lösungen für häufige Probleme bei der RealmJoin-Paketinstallation, beispielsweise BranchCache-Fehler, für bestimmte Szenarien.

Verwenden Sie diese Fixes 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 Es ist nicht genug Speicherplatz auf der Festplatte vorhanden (kann je nach Windows-OS-Sprache auch lokalisiert auftreten) in der Download-Phase, Chocolatey-Beendigungscode 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-OS-Sprache auch lokalisiert auftreten) in der Download-Phase, Chocolatey-Beendigungscode 404:

  1. Öffnen Sie eine PowerShell mit erhöhten Rechten
  2. Ausführen Reset-BC -Force
• Fehlermeldung Fehler - die 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

Wir empfehlen dringend die Bereitstellung des BranchCache zurücksetzen oder löschen Remediation-Skript mit täglichem Zeitplan. Es befindet sich im Remediation-Skripte Abschnitt des RealmJoin-Portals.

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

Fehlende / falsche Paketargumente

1. Prüfen Sie die chocolatey.log Datei auf den/die Wert(e) 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 dies nicht die Werte sind, die Sie erwarten würden, 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 ist die .nupkg-Datei beschädigt worden:

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

Oft kann auch beobachtet werden, 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

Defekte Chocolatey-Konfiguration

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 die (Administrator-)Eingabeaufforderung, führen Sie aus: REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall
3. Neu starten
4. Das RealmJoin-Tray wird Chocolatey neu installieren; lassen Sie das System 5–10 Minuten lang zur Ruhe kommen.
5. Wenn Elemente im RealmJoin-Tray-Menü fehlen, starten Sie erneut neu.

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 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 über dieses Konto auszuführen.
  • In den meisten Fällen liefert die Installation mit einem normalen lokalen Administratorkonto denselben Fehler, daher ist die Ausführung von NT AUTHORITY\SYSTEM möglicherweise nicht erforderlich.

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

• 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äre Benutzer des Clients ist; alternativ prüfen Sie, ob das Paket für sekundäre Benutzer verfügbar konfiguriert ist

ConfigUpdater nicht autorisiert

Der RJ-Agent kann nicht auf die Konfiguration zugreifen

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 somit Zugriffsprobleme entstanden. Dies unterstreicht, wie wichtig es ist sicherzustellen, dass die automatisierten Mechanismen zur Tokenaktualisierung korrekt funktionieren, um ähnliche Probleme in Zukunft zu vermeiden. Die Behebung dieser Grundursache trägt dazu bei, 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. Neu starten