Troubleshooting
Nachfolgend finden Sie grundlegende Schritte dazu, was Sie im Hinblick auf das Troubleshooting des TrueDEM Agent und/oder des TrueDEM Manager tun können.
Neustart des Betriebssystems
In vielen Fällen hilft ein Neustart des Betriebssystems bei der Behebung von Problemen, daher sollte dies stets die erste Option sein, bevor Sie mit den anderen unten genannten Punkten fortfahren.
TrueDEM Manager — Logs
Der TrueDEM Manager ist für die Bereitstellung des Agent sowie für das Abrufen des neuesten Updates für den Agent selbst verantwortlich. Wenn Sie feststellen, dass Endbenutzer nicht über die neueste Version des Agent verfügen, kann Ihnen das folgende Log weiterhelfen. Die Logs des TrueDEM Manager finden Sie hier:
%localappdata%\panagenda\TrueDEM Manager\Logs
TrueDEM Agent — Logs
Der Agent selbst ist die zentrale Anwendung.
%localappdata%\Packages\PerfraxInc.OfficeExpertEPM_wmk1sxh3zvv7j\LocalCache\Logs
Überträgt der Agent Daten?
Falls Sie überprüfen möchten, ob der Agent für einen Benutzer Daten überträgt, können Sie wie folgt vorgehen:
- Öffnen Sie den TrueDEM Agent.
- Klicken Sie auf Settings und aktivieren Sie die Debugging View (NICHT den Debugging Mode!).
- Klicken Sie im Menü auf Debugging und prüfen Sie die Informationen zu Scan Date, Transmit Date und Pending scans.
- Wenn Sie ein altes Datum oder eine Anzahl ausstehender Scans sehen, deutet dies darauf hin, dass nicht alle Daten erfolgreich übertragen wurden → lesen Sie „Wie löst man einen manuellen Scan aus“.
Erreicht der Agent den Service?
Verwenden Sie die folgenden beiden URLs, um zu prüfen, ob der Agent (Client) das TrueDEM SaaS erreichen kann. Im Falle einer erfolglosen Meldung überprüfen Sie bitte Ihre Netzwerkverbindung/Firewall-Einstellungen.
Wie löst man einen manuellen Scan aus?
In seltenen Fällen kann es vorkommen, dass keine Client-Daten übertragen werden. Sie können Folgendes ausführen, um diese manuell auszulösen:
- Öffnen Sie den TrueDEM Agent.
- Klicken Sie auf Settings und aktivieren Sie die Debugging View (NICHT den Debugging Mode!).
- Klicken Sie im Menü auf Debugging und prüfen Sie die Informationen zu Scan Date, Transmit Date und Pending scans.
- Klicken Sie auf Scan All configurations (untere rechte Ecke) und warten Sie einen Moment. Wenn sich die Situation dadurch nicht verbessert, fahren Sie mit dem Schritt → „Den Agent deinstallieren und erneut beziehen“ fort.
Laufen Background Tasks?
Background Tasks sind für TrueDEM erforderlich und essenziell. Wenn keine Daten an das Portal gesendet werden, sollten Sie prüfen, ob die Background Tasks auf dem Client noch laufen.
- Öffnen Sie auf dem betroffenen Client eine PowerShell als Administrator.
- Führen Sie das folgende Cmdlet aus:
Get-AppBackgroundTask -PerfraxInc.OfficeExpertEPM_wmk1sxh3zvv7j
Wenn die Liste leer ist, öffnen Sie bitte die TrueDEM App manuell (dies erstellt die Background Tasks neu) und führen Sie das PowerShell-Cmdlet erneut aus.
Den Agent deinstallieren und erneut beziehen
- Suchen Sie nach dem Agent und klicken Sie auf Uninstall.
- Warten Sie 2–3 Minuten.
- Starten Sie
C:\Program Files\panagenda\TrueDEM Manager\TrueDEM Manager.exe.- Dies löst den Pull-Request aus und installiert den Agent erneut.
- Anschließend sehen Sie für einige Sekunden einen Splash-Screen (er wird automatisch geschlossen).
- Sie können den Vorgang in der entsprechenden Logdatei verfolgen:
%localappdata%\panagenda\TrueDEM Manager\Logs.
- Warten Sie ca. 20 Minuten und prüfen Sie im TrueDEM Portal, ob nun neue Daten sichtbar sind.
Manager ist installiert, aber die Agent-Installation schlägt fehl — 0x80D03002
In diesem Szenario sehen Sie den Fehlercode 0x80D03002 in den Logs des TrueDEM Manager. Dieser Fehlercode weist darauf hin, dass der Download-Modus das Problem verursacht.
Best Practice ist es, den Standardwert für DODownloadMode auf 1 zu belassen. Siehe Referenz: https://learn.microsoft.com/en-us/windows/deployment/do/waas-delivery-optimization-reference#download-mode
Bitte passen Sie den Registry-Schlüssel/die Gruppenrichtlinie an: HKEY_LOCAL_MACHINE\SOFTWARE\POLICIES\MICROSOFT\WINDOWS\DeliveryOptimization
Durch Ausführen des folgenden PowerShell-Cmdlets können Sie ein vollständiges Log der Delivery Optimization exportieren:
Get-DeliveryOptimizationLog | Set-Content C:\tmp\opti.log
Manager ist installiert, aber die Agent-Installation schlägt fehl — 0x80070005
Die Logs des TrueDEM Manager zeigen Folgendes an: Deployment failed with HRESULT: 0x80070005, Access is denied.
Dieser Fehlercode ist generisch und kann mit allem zusammenhängen, was den Windows-Update-Prozess betrifft. Es ist jedoch sehr wahrscheinlich, dass eine Gruppenrichtlinie vorhanden ist, die Nicht-Administrator-Benutzer daran hindert, paketierte Windows-Apps zu installieren.
Bitte überprüfen/setzen Sie die folgende GPO-Einstellung:
„Prevent non-admin users from installing packaged Windows apps“ → Disabled oder Not configured
Bitte prüfen Sie außerdem, ob der zugrunde liegende Registry-Schlüssel nicht gesetzt ist:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Appx— BlockNonAdminUserInstall — Wert: 0
Manager ist installiert, aber die Agent-Installation schlägt fehl — 0x8007045B ; 0x80070490
Die Logs des TrueDEM Manager zeigen Folgendes an: Deployment failed with HRESULT: 0x8007045B or 0x80070490
Dies sind sehr generische Store-App-Fehlercodes, die potenziell alles bedeuten können. Dennoch sehen wir eine starke Korrelation, wenn die SSL-Inspection für den/die betroffenen Client(s) aktiv ist.
Manager ist installiert, aber die Agent-Installation schlägt fehl — 0x800704EC ; 0x80190193 — AppLocker
Die Logs des TrueDEM Manager weisen darauf hin, dass der Zielort für die msixbundle-App (lokales Gerät) nicht geöffnet/aufgerufen werden konnte. Dies kann an AppLocker liegen.
Dieses Problem kann jedoch auch durch eine Firewall, Proxy-Einstellungen oder einen eingeschränkten Zugriff auf den CDN-Speicherort verursacht werden, von dem die Agents heruntergeladen werden.
Wenn Sie also AppLocker verwenden, fügen Sie bitte eine Ausnahmeregel für die TrueDEM App hinzu → AppLocker — Allow Rule
Manager ist installiert, aber die Agent-Installation schlägt fehl — 0x80073D01 — AppLocker
Der Vorgang zur Paketbereitstellung wird durch eine Richtlinie blockiert.
Bitte fügen Sie eine Ausnahmeregel für die TrueDEM App hinzu → AppLocker — Allow Rule
Manager ist installiert, aber die Agent-Installation schlägt fehl — 0x800B010A — Zertifikate
Error 0x800B010A: The root certificate and all intermediate certificates for the signature in the app package or bundle must be trusted ist die Meldung, die man in den Logs des TrueDEM Manager sehen würde.
Dies kann passieren, wenn das Zwischenzertifikat auf dem lokalen Client fehlt; der Client versucht, es aus dem GlobalSign-Online-Repository abzurufen (siehe URL unten). Wenn der Online-Zugriff verweigert wird, schlägt die Agent-Installation mit diesem Fehler fehl: http://secure.globalsign.com/cacert/gsgccr45evcodesignca2020.crt
Ein Update der Agent-Version auf 1.25.4 oder höher sollte das Problem ebenfalls beheben.
Manager ist installiert, aber die Manager-Logs zeigen ein HTTP-407-Ereignis
Dies tritt auf, wenn der TrueDEM Manager den Dienst autodiscover.truedem.com nicht erreichen kann, von dem der Agent (Store-App) bezogen wird. In diesem Fall weist 407 darauf hin, dass ein HTTP-Proxy dazwischengeschaltet ist, der eine Proxy-Authentifizierung erfordert. Bitte schließen Sie die in unserem Dokument „Client Requirements“ genannten URLs aus.
Citrix: Agent ist im Image installiert, zeigt aber 0x8007010B im Appxlog
Dieser Fehler ist erneut ein sehr generischer (Windows Update, Store). Einer der Gründe, warum ein solcher Fehler bei einer Citrix-Bereitstellung auftritt, ist jedoch, dass während Add-AppxProvisionedPackage keine Lizenzdatei verwendet wurde. Bitte stellen Sie sicher, dass die korrekte Lizenzdatei über -LicensePath in der Installationszeichenfolge (Add-AppxProvisionedPackage) angegeben ist.
Gruppenrichtlinien-„Hinweise“
Um zu überprüfen, ob Gruppenrichtlinien das Problem verursachen, führen Sie bitte den folgenden Befehl aus, um zu prüfen, welche GPOs aktiv sind:
gpresult /h gpreport.html
Es wird ein HTML-Report erstellt, in dem man alle aktiven/inaktiven GPOs auf dem Client sehen kann.
EventViewer-„Hinweise“
Der EventViewer liefert weitere nützliche Hinweise, wenn es um Probleme bei der Store-Installation/-Aktualisierung geht. Dies sind die folgenden Einträge unter Application and Services Logs\Microsoft\Windows\Appx.
AADSTS50158
Dieser Fehlercode kann vieles bedeuten. Bitte führen Sie den folgenden PowerShell-Code aus, um festzustellen, ob der Fehler mit einem veralteten Microsoft AAD Broker Plugin zusammenhängt:
Get-AppxPackage | Where { $_.Name -eq 'Microsoft.AAD.BrokerPlugin' }