> 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 {% 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 als Nutzen anrichten können.** {% endhint %} ## BranchCache-Probleme * Fehlermeldung `Auf der Festplatte ist nicht genügend Speicherplatz vorhanden` (kann auch lokalisiert auftreten, abhängig von der Windows-OS-Sprache) in der Downloadphase, Chocolatey-Beendigungscode `404`: 1. Eine PowerShell mit erhöhten Rechten öffnen 2. Ausführen `Clear-BCCache -Force` * Fehlermeldung `Das übergebene Objekt wurde nicht initialisiert` (kann auch lokalisiert auftreten, abhängig von der Windows-OS-Sprache) in der Downloadphase, Chocolatey-Beendigungscode `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ückzusetzen oder zu leeren** Remediation Script mit täglichem Zeitplan bereitzustellen. Es ist im [Remediation-Skripte](/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 (wenn möglich). {% endhint %} ## Fehlende / falsche Package-Argumente 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-Override-Werte. ## Beschädigte .nupkg-Datei Wenn Sie den folgenden Fehler in der `chocolatey.log` sehen, wurde die .nupkg-Datei beschädigt: `[ERROR] - Paket konnte nicht aus dem Pfad 'generic-package-id\generic-package-id.nupkg' gelesen werden.` Oft kann man auch 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 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. RealmJoin tray installiert Chocolatey neu, 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 **Da diese sehr individuell sind, ist dies nur eine Sammlung allgemeiner Schritte zur Problembehandlung, um das Problem weiter einzugrenzen.** * Prüfen Sie auf Protokolldatei(en) in `C:\WINDOWS\Logs\RealmJoin\Packages\\`. * 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 unter Verwendung des integrierten `NT AUTHORITY\SYSTEM` Kontos installiert, daher ist es am besten, ein Tool wie `psexec` zu verwenden, um die Installation von diesem Konto aus auszuführen. * Meistens liefert die Ausführung der 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 im RealmJoin-Tray-Menü nicht angezeigt * Prüfen Sie, ob das Paket korrekt dem Benutzer 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 verborgene 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äre Benutzer verfügbar 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 sicherzustellen. In diesem Fall schlug der erwartete Prozess jedoch fehl, wodurch das Token veraltet wurde und es somit zu Zugriffsproblemen kam. Dies unterstreicht, wie wichtig es ist, sicherzustellen, dass die automatisierten Token-Aktualisierungsmechanismen korrekt funktionieren, um ähnliche Probleme in Zukunft zu vermeiden. Die Behebung dieser Grundursache wird dazu beitragen, den konsistenten Zugriff aufrechtzuerhalten und Unterbrechungen zu vermeiden in 1. Die RealmJoin-Token-Datei löschen: * Pfad: `%LOCALAPPDATA%\RealmJoin` * RJ 4.19 und älter `token2.dat` * RJ 4.20 und neuer: `msal_cache.dat` 2. Neustart --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/de/fehlerbehebung-and-faq/troubleshooting/package-installation-issues/fixes-for-common-issues.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.