> 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 Gezielte Lösungen für häufige Probleme bei der Installation von RealmJoin-Paketen, z. B. BranchCache-Fehler, für bestimmte Szenarien. {% hint style="danger" %} **Verwenden Sie diese Korrekturen nur in den beschriebenen Szenarien!** **Diese sind nicht dafür 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 Download-Phase, 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 Download-Phase, 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 leeren** Remediation-Skript mit täglichem Zeitplan. Es befindet sich im [Remediation-Skripte](/de/automatisierung/remediation-scripts.md) Bereich des RealmJoin-Portals. Durch diese Methode werden die oben genannten BranchCache-Probleme proaktiv erkannt und automatisch behoben (wenn möglich). {% endhint %} ## Wachsender Chocolatey-Temp-Ordner Installationsdateien für Chocolatey-Pakete werden nach `C:\Windows\Temp\chocolatey\\\` heruntergeladen und nach der Installation nicht entfernt. Dies gilt sowohl für die klassische Chocolatey-Engine als auch für die [Native Choco Runtime](/de/realmjoin-agent/realmjoin-client/native-choco-runtime.md). Im Laufe der Zeit kann der Ordner einen erheblichen Teil des Speicherplatzes belegen. Wenn dieser Ordner automatisch bereinigt werden soll, stellen Sie das **Bereinigen des Chocolatey-Temp-Ordners** Remediation-Skript aus dem [Remediation-Skripte](/de/automatisierung/remediation-scripts.md) Bereich des RealmJoin-Portals bereit. Es entfernt Paketversionsordner, die älter als 7 Tage sind. ## Fehlende / falsche Paketargumente 1. Prüfen Sie die `chocolatey.log` Datei auf die Werte von `packageParameters` im Abschnitt `RJAppDeployToolkit: Resultierende Variablen` * Dies sind die tatsächlichen Werte, die für die Installation verwendet und vom RealmJoin-Backend übergeben werden. 2. Wenn dies nicht die erwarteten Werte sind, prüfen Sie die Paketzuweisung im RealmJoin-Portal auf Überschreibungswerte für Gruppe / Benutzer. ## 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 0 Byte groß ist. 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` -> Registerkarte `Erweitert` -> `Umgebungsvariablen...` * Verwenden Sie eine (Administrator-)Eingabeaufforderung, führen Sie aus: `REG delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /V ChocolateyInstall` 3. Neustart 4. Das RealmJoin-Tray wird Chocolatey neu installieren, 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 Fehlerbehebung, um das Problem einzugrenzen.** * Prüfen Sie auf Logdatei(en) in `C:\WINDOWS\Logs\RealmJoin\Packages\\`. * Versuchen Sie, die Logdatei(en) zu analysieren und das Problem zu finden. * Wenn keine Logdatei vorhanden oder diese 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 verwenden Sie am besten ein Tool wie `psexec` um die Installation unter diesem Konto auszuführen. * Meistens führt die Ausführung der Installation mit einem normalen lokalen Administratorkonto zum gleichen 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 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 so konfiguriert ist, dass es für sekundäre Benutzer verfügbar ist --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.