Workspace Environment Management

Afficher les fichiers journaux

Vous pouvez collecter et afficher les journaux liés à Workspace Environment Management (WEM). Vous utilisez les journaux pour résoudre vous-même les problèmes ou fournir les journaux lorsque vous contactez le support technique Citrix pour obtenir de l’aide. Vous pouvez collecter des journaux liés aux éléments suivants :

Journaux liés à l’agent

Vous pouvez collecter des journaux liés à l’agent WEM. Les journaux que vous pouvez collecter sur les machines sur lesquelles l’agent WEM est installé sont les suivants :

  • Journaux de l’agent WEM

    • Citrix WEM Agent Init.log. Journal d’initialisation qui vous permet de résoudre les problèmes avec l’agent en mode CMD ou UI. Le journal est créé lors de l’ouverture de session ou de l’actualisation. Si l’agent ne démarre pas, consultez ce fichier journal pour obtenir des détails sur les erreurs. Les erreurs apparaissent sous forme d’ exceptions. Par défaut, ce fichier journal est créé dans le dossier de profil de l’utilisateur (%userprofile%).

    • Citrix WEM Agent.log. Le journal principal qui vous permet de résoudre les problèmes avec l’agent en mode CMD ou UI. Le journal répertorie les instructions traitées par l’agent. Si une action ne peut pas être attribuée à l’utilisateur actuel, consultez ce fichier journal pour obtenir des détails sur les erreurs. Les erreurs apparaissent sous forme d’ exceptions. Par défaut, ce fichier journal est créé dans le dossier de profil de l’utilisateur (%userprofile%). Pour modifier la valeur par défaut, accédez à Administration Console > Paramètres avancés > Configuration > Options de l’agent, puis configurez le paramètre Activer la journalisation de l’agent . Pour afficher plus de détails, activez le mode de débogage dans l’onglet Options de l’agent . Vous pouvez également activer la journalisation en configurant la clé de Registre suivante :

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

      Nom : AgentDebugModeLocalOverride

      Type : DWORD

      Valeur : 0

      Définissez la valeur sur 1 pour activer le fichier journal et 0 pour le désactiver. Pour que les modifications prennent effet, redémarrez le service hôte Citrix WEM Agent. Par défaut, la journalisation est désactivée.

      Attention :

      Toute utilisation incorrecte de l’Éditeur du Registre peut générer des problèmes sérieux, pouvant vous obliger à réinstaller le système d’exploitation. Citrix ne peut garantir la possibilité de résoudre les problèmes provenant d’une mauvaise utilisation de l’Éditeur du Registre. Vous assumez l’ensemble des risques liés à l’utilisation de l’Éditeur du Registre. Veillez à faire une copie de sauvegarde de votre registre avant de le modifier.

    • Service hôte Citrix WEM Agent Debug.log. Journal qui vous permet de résoudre les problèmes liés au service hôte Citrix WEM Agent. Par défaut, ce fichier journal se trouve dans %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent. Pour activer la journalisation, veillez à activer le mode de débogage pour le jeu de configuration approprié dans Administration Console > Paramètres avancés > Configuration > onglet Options du service . Vous pouvez également activer la journalisation en configurant la clé de Registre suivante :

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

      Nom : AgentServiceDebugModeLocalOverride

      Type : DWORD

      Valeur : 0

      Définissez la valeur sur 1 pour activer le fichier journal et 0 pour le désactiver. Pour que les modifications prennent effet, redémarrez le service hôte Citrix WEM Agent. Par défaut, la journalisation est désactivée.

      Attention :

      Toute utilisation incorrecte de l’Éditeur du Registre peut générer des problèmes sérieux, pouvant vous obliger à réinstaller le système d’exploitation. Citrix ne peut garantir la possibilité de résoudre les problèmes provenant d’une mauvaise utilisation de l’Éditeur du Registre. Vous assumez l’ensemble des risques liés à l’utilisation de l’Éditeur du Registre. Veillez à faire une copie de sauvegarde de votre registre avant de le modifier.

  • Journaux des événements Windows. Informations écrites dans le journal des événements Windows. Afficher les journaux dans le volet Observateur d’événements > Journaux des applications et des services > Service de l’agent WEM .

  • Traces de Windows Communication Foundation (WCF). Journaux utiles lorsque vous rencontrez des problèmes liés aux communications entre l’agent WEM et le service d’infrastructure WEM. Pour activer la journalisation, vous devez activer le suivi WCF. Pour plus d’informations, consultez Traces de Windows Communication Foundation.

Journaux liés au service d’infrastructure

Vous pouvez collecter des journaux liés au service d’infrastructure WEM. Les journaux que vous pouvez collecter sur les machines sur lesquelles le service d’infrastructure WEM est installé sont les suivants :

  • Journaux des événements Windows. Informations écrites dans le journal des événements Windows. Affichez les journaux dans le volet Observateur d’événements > Journaux des applications et des services > Norskale Broker Service .

  • Citrix WEM Infrastructure Service Debug.log. Journal qui vous permet de résoudre les problèmes liés au service d’infrastructure Citrix WEM (Norskale Broker Service.exe). Par défaut, ce fichier journal se trouve dans %PROGRAMFILES(X86)%\ Norskale\Norskale Infrastructure Services. Pour activer ce fichier journal, procédez comme suit pour activer le mode de débogage :

    1. Ouvrez l’ utilitaire de configuration du service WEM Infrastructure dans le menu Démarrer.
    2. Dans l’onglet Paramètres avancés, sélectionnez Activer le mode de débogage.
    3. Cliquez sur Enregistrer la configuration, puis sur Oui pour démarrer le service afin d’appliquer la modification.
    4. Fermez la fenêtre Utilitaire de configuration du service WEM Infrastructure .
  • Traces WCF. Journaux utiles lorsque vous rencontrez des problèmes de communication liés au service d’infrastructure WEM. Pour activer la journalisation, vous devez activer le suivi WCF. Pour plus d’informations, consultez Traces de Windows Communication Foundation.

Journaux associés à la console d’administration

Vous pouvez collecter des journaux liés à la console d’administration WEM. Les journaux que vous pouvez collecter sur les machines sur lesquelles la console d’administration est installée sont les suivants :

  • Citrix WEM Console Trace.log. Journal qui vous permet de résoudre les problèmes liés à la console d’administration WEM. Par défaut, ce fichier journal est créé dans le dossier de profil de l’utilisateur (%userprofile%). Pour activer la journalisation, procédez comme suit pour activer le mode de débogage :

    1. Ouvrez la console d’administration WEM dans le menu Démarrer, puis cliquez sur Connexion.
    2. Dans la fenêtre Nouvelle connexion au serveur d’infrastructure, vérifiez les informations, puis cliquez sur Se connecter.
    3. Dans l’onglet À propos, cliquez sur Options et sélectionnez Activer le mode de débogage.
    4. Cliquez sur Appliquer pour appliquer la modification.
  • Traces WCF. Journaux utiles lorsque vous rencontrez des problèmes liés aux communications entre la console d’administration WEM et la base de données WEM. Pour activer la journalisation, vous devez activer le suivi WCF. Pour plus d’informations, consultez Traces de Windows Communication Foundation.

Journaux associés à la base de données WEM

Vous pouvez collecter des journaux liés à la base de données WEM. Les journaux sont créés lorsque vous utilisez l’utilitaire de gestion de base de données WEM pour créer ou mettre à niveau une base de données. Pour plus de détails, consultez le fichier journal suivant :

  • Utilitaire de gestion de base de données Citrix WEM Debug Log.log. Le journal qui vous permet de résoudre les problèmes liés à la base de données WEM. Ce fichier journal est créé par défaut et se trouve dans C:\Program Files (x86)\Norskale\Norskale Infrastructure Services.

Traces de Windows Communication Foundation

Vous pouvez afficher les traces de Windows Communication Foundation (WCF) pour vous aider à résoudre les problèmes suivants :

Dépannage des communications entre l’agent et le service d’infrastructure

Si l’agent WEM ne communique pas correctement avec le service d’infrastructure WEM, vous pouvez afficher les traces WCF du service VUEMUIAgent.exe. Suivez ces étapes pour activer le traçage WCF :

  1. Connectez-vous à la machine de l’agent WEM.
  2. Cliquez avec le bouton droit sur l’icône de l’agent dans la barre des tâches, puis sélectionnez Quitter pour fermer l’agent.
  3. Localisez le fichier VuemuiAgent.exe.config dans, %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent puis créez une copie de sauvegarde du fichier.
  4. Ouvrez le fichier dans le Bloc-notes ou WordPad et insérez l’extrait suivant dans la section située entre le marqueur <configuration> et le </configSections> marqueur.
  5. Enregistrez le fichier.

    <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. Sur la machine agent, créez un dossier racine appelé « Trace » sur le lecteur C (C:\Trace). Ignorez cette étape si le dossier existe déjà.
  7. Reproduisez le problème que vous avez rencontré, puis terminez le processus VUEMUIAgent.exe.
  8. Affichez le fichier journal nommé vuemUIAgent-Traces.svclog dans C:\Trace.

Vous pouvez également afficher les traces WCF du service Citrix.WEM.Agent.Service.exe. Suivez ces étapes :

  1. Connectez-vous à la machine de l’agent WEM.
  2. Cliquez avec le bouton droit sur l’icône de l’agent dans la barre des tâches, puis sélectionnez Quitter pour fermer l’agent.
  3. Terminez le service hôte Citrix WEM Agent.
  4. Localisez le fichier Citrix.WEM.Agent.Service.exe.config dans, %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent puis créez une copie de sauvegarde du fichier.
  5. Ouvrez le fichier dans le Bloc-notes ou WordPad et insérez l’extrait suivant dans le fichier, en commençant par la quatrième ligne juste après le </configSections> marqueur.
  6. Enregistrez le fichier.

    <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. Sur la machine agent, créez un dossier racine appelé « Trace » sur le lecteur C (C:\Trace). Ignorez cette étape si le dossier existe déjà.
  8. Démarrez le service Windows appelé Citrix WEM Agent Host Service, puis reproduisez le problème que vous avez rencontré.
  9. Affichez le fichier journal nommé NorskaleAgentHostService-Traces.svclog dans C:\Trace.

Dépannage des communications liées au service d’infrastructure WEM

Si vous rencontrez des problèmes de communication liés au service d’infrastructure WEM, vous pouvez afficher les traces WCF du service Norskale Broker. Suivez ces étapes pour activer le traçage WCF :

  1. Ouvrez une session sur la machine sur laquelle le service d’infrastructure WEM est installé.
  2. Mettre fin au service d’infrastructure Norskale.
  3. Localisez le fichier Norskale Broker Service.exe.config dans, %PROGRAMFILES(X86)%\Norskale\Norskale Infrastructure Services puis créez une copie de sauvegarde du fichier.
  4. Ouvrez le fichier dans le bloc-notes ou WordPad et insérez l’extrait suivant dans le fichier, en commençant par la troisième ligne juste après le <configuration> marqueur.

    <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. Enregistrez le fichier.
  6. Sur la machine de service d’infrastructure WEM, créez un dossier racine appelé « Trace » sur le lecteur C (C:\Trace). Ignorez cette étape si le dossier existe déjà.
  7. Démarrez le service Norskale Infrastructure, puis reproduisez le problème que vous avez rencontré.
  8. Affichez le fichier journal nommé NorskaleInfrastructureBrokerService-Traces.svclog dans C:\Trace.

Dépannage des communications entre la console d’administration WEM et la base de données WEM

Si vous rencontrez des problèmes liés aux communications entre la console d’administration WEM et la base de données WEM, vous pouvez afficher les traces WCF du service Norskale Administration Console.exe. Suivez ces étapes pour activer le traçage WCF :

  1. Ouvrez une session sur la machine de console d’administration WEM.
  2. Fermez la console d’administration WEM.
  3. Localisez le fichier Norskale Administration Console.exe.config dans, %PROGRAMFILES(X86)%\Norskale\Norskale Administration Console puis créez une copie de sauvegarde du fichier.
  4. Ouvrez le fichier dans le Bloc-notes ou WordPad et ajoutez l’extrait suivant dans le fichier, en commençant par la troisième ligne juste après le <configuration> marqueur.

    <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. Enregistrez le fichier.
  6. Sur la machine de la console d’administration, créez un dossier racine appelé « Trace » sur le lecteur C (C:\Trace). Ignorez cette étape si le dossier existe déjà.
  7. Ouvrez la console d’administration WEM, puis reproduisez le problème que vous avez rencontré.
  8. Affichez le fichier journal nommé WEMConsole-Traces.svclog dans C:\Trace.