Workspace Environment Management

Protokolldateien anzeigen

Sie können Protokolle im Zusammenhang mit Workspace Environment Management (WEM) sammeln und anzeigen. Sie verwenden die Protokolle, um Probleme selbst zu beheben oder die Protokolle bereitzustellen, wenn Sie sich an den technischen Support von Citrix wenden, um Unterstützung zu erhalten. Sie können Protokolle sammeln, die sich auf Folgendes beziehen:

Protokolle im Zusammenhang mit dem Agent

Sie können Protokolle sammeln, die sich auf den WEM Agent beziehen. Zu den Protokollen, die Sie auf Computern sammeln können, auf denen der WEM-Agent installiert ist, gehören:

  • WEM-Agent-Protokolle

    • Citrix WEM Agent Init.log. Das Initialisierungsprotokoll, mit dem Sie Probleme mit dem Agent im CMD- oder UI-Modus beheben können. Das Protokoll wird bei der Anmeldung oder beim Aktualisieren erstellt. Wenn der Agent nicht gestartet werden kann, sehen Sie sich diese Protokolldatei an, um Fehlerdetails zu erhalten. Fehler erscheinen als Ausnahmen. Standardmäßig wird diese Protokolldatei im Profilordner des Benutzers (%userprofile%) erstellt.

    • Citrix WEM Agent.log. Das primäre Protokoll, mit dem Sie Probleme mit dem Agent im CMD- oder UI-Modus beheben können. Das Protokoll listet auf, welche Anweisungen der Agent verarbeitet hat. Wenn dem aktuellen Benutzer keine Aktion zugewiesen wird, sehen Sie sich diese Protokolldatei an, um Fehlerdetails zu erhalten. Fehler erscheinen als Ausnahmen. Standardmäßig wird diese Protokolldatei im Profilordner des Benutzers (%userprofile%) erstellt. Um den Standardwert zu ändern, gehen Sie zu Administration Console > Erweiterte Einstellungen > Konfiguration > Agent-Optionen und konfigurieren Sie dann die Einstellung Agent-Protokollierung aktivieren . Um weitere Details anzuzeigen, aktivieren Sie den Debug-Modus auf der Registerkarte Agentoptionen . Alternativ können Sie die Protokollierung aktivieren, indem Sie den folgenden Registrierungsschlüssel konfigurieren:

      Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host

      Name: AgentDebugModeLocalOverride

      Typ: DWORD

      Wert: 0

      Setzen Sie den Wert auf 1, um die Protokolldatei zu aktivieren, und 0, um sie zu deaktivieren. Starten Sie den Citrix WEM Agent Host Service neu, damit die Änderungen wirksam werden. Standardmäßig ist die Protokollierung deaktiviert.

      Achtung:

      Eine unsachgemäße Bearbeitung der Registrierung kann schwerwiegende Probleme verursachen und eine Neuinstallation des Betriebssystems erforderlich machen. Citrix übernimmt keine Garantie dafür, dass Probleme, die auf eine unsachgemäße Verwendung des Registrierungs-Editors zurückzuführen sind, behoben werden können. Die Verwendung des Registrierungs-Editors geschieht daher auf eigene Gefahr. Machen Sie auf jeden Fall ein Backup der Registrierung, bevor Sie sie bearbeiten.

    • Citrix WEM Agent Host Service Debug.log. Das Protokoll, mit dem Sie Probleme mit dem Citrix WEM Agent Host Service beheben können. Standardmäßig befindet sich diese Protokolldatei in %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent. Um die Protokollierung zu aktivieren, aktivieren Sie unbedingt den Debug-Modus für die entsprechende Konfiguration, die auf der Registerkarte Administration Console > Erweiterte Einstellungen > Konfiguration > Dienstoptionen festgelegt wurde. Alternativ können Sie die Protokollierung aktivieren, indem Sie den folgenden Registrierungsschlüssel konfigurieren:

      Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host

      Name: AgentServiceDebugModeLocalOverride

      Typ: DWORD

      Wert: 0

      Setzen Sie den Wert auf 1, um die Protokolldatei zu aktivieren, und 0, um sie zu deaktivieren. Starten Sie den Citrix WEM Agent Host Service neu, damit die Änderungen wirksam werden. Standardmäßig ist die Protokollierung deaktiviert.

      Achtung:

      Eine unsachgemäße Bearbeitung der Registrierung kann schwerwiegende Probleme verursachen und eine Neuinstallation des Betriebssystems erforderlich machen. Citrix übernimmt keine Garantie dafür, dass Probleme, die auf eine unsachgemäße Verwendung des Registrierungs-Editors zurückzuführen sind, behoben werden können. Die Verwendung des Registrierungs-Editors geschieht daher auf eigene Gefahr. Machen Sie auf jeden Fall ein Backup der Registrierung, bevor Sie sie bearbeiten.

  • Windows-Ereignisprotokolle. Informationen, die in das Windows-Ereignisprotokoll geschrieben wurden. Zeigen Sie Protokolle in der Ereignisanzeige > Anwendungs- und Dienstprotokolle > WEM-Agent-Dienst an .

  • Spuren von Windows Communication Foundation (WCF). Protokolle, die hilfreich sind, wenn Probleme im Zusammenhang mit der Kommunikation zwischen dem WEM Agent und dem WEM-Infrastrukturdienst auftreten. Um die Protokollierung zu aktivieren, müssen Sie die WCF-Ablaufverfolgung aktivieren. Weitere Informationen finden Sie unter Windows Communication Foundation-Traces.

Protokolle im Zusammenhang mit dem Infrastrukturdienst

Sie können Protokolle sammeln, die sich auf den WEM-Infrastrukturdienst beziehen. Zu den Protokollen, die Sie auf Computern sammeln können, auf denen der WEM-Infrastrukturdienst installiert ist, gehören:

  • Windows-Ereignisprotokolle. In das Windows-Ereignisprotokoll geschriebene Informationen. Zeigen Sie Protokolle in der Ereignisanzeige > Anwendungs- und Dienstprotokolle > WEM Infrastructure Service an.

  • Citrix WEM Infrastructure Service Debug.log. Das Protokoll, mit dem Sie Probleme mit dem Citrix WEM-Infrastrukturdienst (Norskale Broker Service.exe) beheben können. Standardmäßig befindet sich diese Protokolldatei in %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Infrastructure Services. Gehen Sie folgendermaßen vor, um diese Protokolldatei zu aktivieren, um den Debug-Modus zu aktivieren:

    1. Öffnen Sie das WEM Infrastructure Service Configuration Utility über das Startmenü.
    2. Wählen Sie auf der Registerkarte Erweiterte Einstellungen den Debug-Modus aktivierenaus.
    3. Klicken Sie auf Konfiguration speichern und dann auf Ja, um den Dienst zu starten, um die Änderung zu übernehmen.
    4. Schließen Sie das Fenster WEM Infrastructure Service Configuration Utility .
  • WCF-Spuren. Protokolle, die hilfreich sind, wenn Kommunikationsprobleme im Zusammenhang mit dem WEM-Infrastrukturdienst auftreten. Um die Protokollierung zu aktivieren, müssen Sie die WCF-Ablaufverfolgung aktivieren. Weitere Informationen finden Sie unter Windows Communication Foundation-Traces.

Protokolle im Zusammenhang mit der Verwaltungskonsole

Sie können Protokolle sammeln, die sich auf die WEM-Verwaltungskonsole beziehen. Zu den Protokollen, die Sie auf Computern sammeln können, auf denen die Verwaltungskonsole installiert ist, gehören:

  • Citrix WEM Console Trace.log. Das Protokoll, mit dem Sie Probleme mit der WEM-Verwaltungskonsole beheben können. Standardmäßig wird diese Protokolldatei im Profilordner des Benutzers (%userprofile%) erstellt. Um die Protokollierung zu aktivieren, führen Sie diese Schritte aus, um den Debug-Modus zu aktivieren:

    1. Öffnen Sie die WEM Administration Console über das Startmenü und klicken Sie auf Verbinden .
    2. Überprüfen Sie im Fenster Neue Infrastrukturserververbindung die Informationen und klicken Sie dann auf Verbinden .
    3. Klicken Sie auf der Registerkarte Info auf Optionen und wählen Sie Debug-Modus aktivierenaus.
    4. Klicken Sie auf Anwenden, um die Änderung zu übernehmen.
  • WCF-Spuren. Protokolle, die hilfreich sind, wenn Probleme im Zusammenhang mit der Kommunikation zwischen der WEM-Verwaltungskonsole und der WEM-Datenbank auftreten. Um die Protokollierung zu aktivieren, müssen Sie die WCF-Ablaufverfolgung aktivieren. Weitere Informationen finden Sie unter Windows Communication Foundation-Traces.

Protokolle im Zusammenhang mit der WEM-Datenbank

Sie können Protokolle sammeln, die sich auf die WEM-Datenbank beziehen. Protokolle werden erstellt, wenn Sie das WEM-Datenbankverwaltungsdienstprogramm zum Erstellen oder Aktualisieren einer Datenbank verwenden. Weitere Informationen finden Sie in der folgenden Protokolldatei:

  • Citrix WEM Datenbankverwaltungsdienstprogramm Debug Log.log. Das Protokoll, mit dem Sie Probleme mit der WEM-Datenbank beheben können. Diese Protokolldatei wird standardmäßig erstellt und befindet sich in C:\Program Files (x86)\Citrix\Workspace Environment Management Infrastructure Services.

Protokolle im Zusammenhang mit der WEM-Webkonsole

Sie können Protokolle zur WEM-Webkonsole sammeln. Protokolle werden erstellt, wenn Sie das Konfigurationsprogramm für die WEM-Webkonsole verwenden, um die Webkonsole zu konfigurieren. Darüber hinaus werden Protokolle erstellt, wenn der Webkonsolendienst ausgeführt wird. Weitere Informationen finden Sie in den folgenden Protokolldateien:

  • Konfiguration der Webkonsole Utility.log. Das Protokoll, mit dem Sie Probleme mit dem Konfigurationsprogramm der WEM-Webkonsole beheben können. Diese Protokolldatei wird standardmäßig erstellt und befindet sich in C:\ProgramData.

  • Citrix WEM Public API.log. Das Protokoll, mit dem Sie Probleme mit dem WEM-Webkonsolendienst beheben können. **Wenn Sie den Webkonsolendienst mithilfe des Konfigurationsprogramms für die Webkonsole konfigurieren, um die Protokollierung zu aktivieren, stellen Sie sicher, dass die Option Konsolenprotokollierung **aktivieren aktiviert ist. Diese Protokolldatei befindet sich in C:\ProgramData.

Spuren der Windows-Kommunikation Foundation

Sie können die Spuren von Windows Communication Foundation (WCF) anzeigen, um die folgenden Probleme zu beheben:

Problembehandlung bei der Kommunikation zwischen dem Agent und dem Infrastrukturdienst

Wenn der WEM-Agent nicht ordnungsgemäß mit dem WEM-Infrastrukturdienst kommuniziert, können Sie WCF-Spuren des Dienstes VUEMUIAgent.exe anzeigen. Gehen Sie folgendermaßen vor, um die WCF-Tracing zu aktivieren:

  1. Melden Sie sich am WEM-Agent-Computer an.
  2. Klicken Sie mit der rechten Maustaste auf das Agent-Symbol in der Taskleiste und wählen Sie dann Beenden aus, um den Agent
  3. Suchen Sie die Datei VuemuiAgent.exe.config in %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent und erstellen Sie dann eine Sicherungskopie der Datei.
  4. Öffnen Sie die Datei in Notepad oder WordPad und fügen Sie das folgende Snippet in den Abschnitt zwischen dem <configuration> und dem </configSections> Marker ein.
  5. Speichern Sie die Datei.

    <system.diagnostics>
        <sources>
                <source name="System.ServiceModel"
                        switchValue="Information, ActivityTracing"
                        propagateActivity="true">
                <listeners>
                <add name="traceListener"
                    type="System.Diagnostics.XmlWriterTraceListener"
                    initializeData= "c:\trace\vuemUIAgent-Traces.svclog" />
                </listeners>
            </source>
        </sources>
    </system.diagnostics>
    <!--NeedCopy-->
    
  6. Erstellen Sie auf dem Agent-Computer einen Stammordner namens “Trace” auf dem Laufwerk C (C:\Trace). Überspringen Sie diesen Schritt, wenn der Ordner bereits vorhanden ist.
  7. Reproduzieren Sie das aufgetretene Problem und beenden Sie dann den Prozess VUEMUIAgent.exe.
  8. Zeigen Sie die unter benannte Protokolldatei vuemUIAgent-Traces.svclog an C:\Trace.

Sie können auch WCF-Spuren des Citrix.Wem.Agent.Service.exe-Dienstes anzeigen. Führen Sie die folgenden Schritte aus:

  1. Melden Sie sich am WEM-Agent-Computer an.
  2. Klicken Sie mit der rechten Maustaste auf das Agent-Symbol in der Taskleiste und wählen Sie dann Beenden aus, um den Agent
  3. Beenden Sie den Citrix WEM Agent Hostdienst.
  4. Suchen Sie die Datei Citrix.Wem.Agent.Service.exe.config in %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent und erstellen Sie dann eine Sicherungskopie der Datei.
  5. Öffnen Sie die Datei in Notepad oder WordPad und fügen Sie das folgende Snippet in die Datei ein, beginnend in der vierten Zeile direkt nach der </configSections> Markierung.
  6. Speichern Sie die Datei.

    <system.diagnostics>
        <sources>
                <source name="System.ServiceModel"
                        switchValue="Information, ActivityTracing"
                        propagateActivity="true">
                <listeners>
                <add name="traceListener"
                    type="System.Diagnostics.XmlWriterTraceListener"
                    initializeData= "c:\trace\NorskaleAgentHostService-Traces.svclog" />
                </listeners>
            </source>
        </sources>
    </system.diagnostics>
    <!--NeedCopy-->
    
  7. Erstellen Sie auf dem Agent-Computer einen Stammordner namens “Trace” auf dem Laufwerk C (C:\Trace). Überspringen Sie diesen Schritt, wenn der Ordner bereits vorhanden ist.
  8. Starten Sie den Windows-Dienst namens Citrix WEM Agent Host Service und reproduzieren Sie dann das aufgetretene Problem.
  9. Zeigen Sie die unter benannte Protokolldatei NorskaleAgentHostService-Traces.svclog an C:\Trace.

Problembehandlung bei der Kommunikation im Zusammenhang mit dem WEM-Infrastrukturdienst

Wenn Kommunikationsprobleme im Zusammenhang mit dem WEM-Infrastrukturdienst auftreten, können Sie WCF-Spuren des Norskale Broker Service anzeigen. Gehen Sie folgendermaßen vor, um die WCF-Tracing zu aktivieren:

  1. Melden Sie sich bei dem Computer an, auf dem der WEM-Infrastrukturdienst installiert ist.
  2. Beenden Sie den Citrix WEM Infrastructure Service.
  3. Suchen Sie die Norskale Broker Service.exe.config-Datei in %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Infrastructure Services und erstellen Sie dann eine Sicherungskopie der Datei.
  4. Öffnen Sie die Datei in Notepad oder WordPad und fügen Sie das folgende Snippet in die Datei ein, beginnend in der dritten Zeile direkt nach dem <configuration> Marker.

    <system.diagnostics>
        <sources>
                <source name="System.ServiceModel"
                        switchValue="Information, ActivityTracing"
                        propagateActivity="true">
                <listeners>
                <add name="traceListener"
                    type="System.Diagnostics.XmlWriterTraceListener"
                    initializeData= "c:\trace\NorskaleInfrastructureBrokerService-Traces.svclog" />
                </listeners>
            </source>
        </sources>
    </system.diagnostics>
    <!--NeedCopy-->
    
  5. Speichern Sie die Datei.
  6. Erstellen Sie auf dem WEM-Infrastrukturdienstcomputer einen Stammordner namens “Trace” auf dem Laufwerk C (C:\Trace). Überspringen Sie diesen Schritt, wenn der Ordner bereits vorhanden ist.
  7. Starten Sie den Citrix WEM Infrastructure Service und reproduzieren Sie dann das aufgetretene Problem.
  8. Zeigen Sie die unter benannte Protokolldatei NorskaleInfrastructureBrokerService-Traces.svclog an C:\Trace.

Problembehandlung bei der Kommunikation zwischen der WEM-Verwaltungskonsole und der WEM-Datenbank

Wenn Probleme im Zusammenhang mit der Kommunikation zwischen der WEM-Verwaltungskonsole und der WEM-Datenbank auftreten, können Sie WCF-Spuren des Norskale Administration Console.exe Service anzeigen. Gehen Sie folgendermaßen vor, um die WCF-Tracing zu aktivieren:

  1. Melden Sie sich beim Computer der WEM-Verwaltungskonsole an.
  2. Schließen Sie die WEM-Verwaltungskonsole.
  3. Suchen Sie die Norskale Administration Console.exe.config Datei in %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Administration Console und erstellen Sie dann eine Sicherungskopie der Datei.
  4. Öffnen Sie die Datei in Notepad oder WordPad und fügen Sie das folgende Snippet in die Datei ein, beginnend in der dritten Zeile direkt nach dem <configuration> Marker.

    <system.diagnostics>
        <sources>
                <source name="System.ServiceModel"
                        switchValue="Information, ActivityTracing"
                        propagateActivity="true">
                <listeners>
                <add name="traceListener"
                    type="System.Diagnostics.XmlWriterTraceListener"
                    initializeData= "c:\trace\WEMConsole-Traces.svclog" />
                </listeners>
            </source>
        </sources>
    </system.diagnostics>
    <!--NeedCopy-->
    
  5. Speichern Sie die Datei.
  6. Erstellen Sie auf dem Computer der Verwaltungskonsole einen Stammordner namens “Trace” auf dem Laufwerk C (C:\Trace). Überspringen Sie diesen Schritt, wenn der Ordner bereits vorhanden ist.
  7. Öffnen Sie die WEM-Verwaltungskonsole und reproduzieren Sie dann das Problem, auf das Sie gestoßen sind.
  8. Zeigen Sie die unter benannte Protokolldatei WEMConsole-Traces.svclog an C:\Trace.