Gestion de l'environnement de travail 2407

Afficher les fichiers journaux

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

Journaux liés à l’agent

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

  • Journaux des agents WEM

    • Journal d’initialisation de l’agent Citrix WEM. Le 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 la connexion ou lors de l’actualisation. Si l’agent ne parvient pas à démarrer, consultez ce fichier journal pour obtenir les détails de l’erreur. Les erreurs apparaissent sous la forme d’exceptions **. Par défaut, ce fichier journal est créé dans le dossier de profil de l’utilisateur (%userprofile%).

    • Agent Citrix WEM.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 parvient pas à être attribuée à l’utilisateur actuel, consultez ce fichier journal pour obtenir les détails de l’erreur. Les erreurs apparaissent sous la 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 àConsole d’administration > Paramètres avancés > Configuration > Options de l’agentpuis configurez le paramètreActiver la journalisation de l’agent. Pour afficher plus de détails, activezMode de débogagedans l’ongletOptions de l’agent** . Vous pouvez également activer la journalisation en configurant la clé de registre suivante :

      Ordinateur\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nclés\Agent Host

      Nom : AgentDebugModeLocalOverride

      Type : DWORD

      Valeur: 0

      Définissez la valeur sur 1 pour activer le fichier journal et sur 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.

    • Journal de débogage du service hôte de l’agent Citrix WEM. Le journal qui vous permet de résoudre les problèmes liés au service hôte de l’agent Citrix WEM. Par défaut, ce fichier journal se trouve dans %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent. Pour activer la journalisation, assurez-vous d’activer Mode de débogage pour la configuration appropriée définie dans l’onglet Console d’administration > Paramètres avancés > Configuration > Options de service . Vous pouvez également activer la journalisation en configurant la clé de registre suivante :

      Ordinateur\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nclés\Agent Host

      Nom : AgentServiceDebugModeLocalOverride

      Type : DWORD

      Valeur: 0

      Définissez la valeur sur 1 pour activer le fichier journal et sur 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 d’é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 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 traçage WCF. Pour plus d’informations, voir Traces Windows Communication Foundation.

Journaux liés au service d’infrastructure

Vous pouvez collecter les 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é incluent :

  • Journaux d’é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 d’infrastructure WEM .

  • Journal de débogage du service d’infrastructure Citrix WEM. Le journal qui vous permet de résoudre les problèmes avec le service d’infrastructure Citrix WEM (Norskale Broker Service.exe). Par défaut, ce fichier journal se trouve dans %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Infrastructure Services. Pour activer ce fichier journal, suivez ces étapes pour activer le mode débogage :

    1. Ouvrez l’utilitaire de configuration du service d’infrastructure WEM ** à partir du menu Démarrer.
    2. Dans l’onglet Paramètres avancés , sélectionnez Activer le mode débogage.
    3. Cliquez sur Enregistrer la configuration et cliquez sur Oui pour démarrer le service afin d’appliquer la modification.
    4. Fermez la fenêtre Utilitaire de configuration du service d’infrastructure WEM .
  • 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 traçage WCF. Pour plus d’informations, voir Traces Windows Communication Foundation.

Journaux liés à la console d’administration

Vous pouvez collecter les 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 incluent :

  • Journal de suivi de la console Citrix WEM. Le journal qui vous permet de résoudre les problèmes avec 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, suivez ces étapes pour activer le mode débogage :

    1. Ouvrez la Console d’administration WEM depuis le menu Démarrer et cliquez sur Connecter.
    2. Dans la fenêtre Nouvelle connexion au serveur d’infrastructure , vérifiez les informations, puis cliquez sur 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 traçage WCF. Pour plus d’informations, voir Traces Windows Communication Foundation.

Journaux lié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. Consultez le fichier journal suivant pour plus de détails :

  • Journal de débogage de l’utilitaire de gestion de base de données Citrix WEM.log. Le journal qui vous permet de résoudre les problèmes avec la base de données WEM. Ce fichier journal est créé par défaut et se trouve dans C:\Program Files (x86)\Citrix\Workspace Environment Management Infrastructure Services.

Journaux liés à la console Web WEM

Vous pouvez collecter les journaux liés à la console Web WEM. Les journaux sont créés lorsque vous utilisez l’utilitaire de configuration de la console Web WEM pour configurer la console Web. De plus, des journaux sont créés lorsque le service de console Web est en cours d’exécution. Pour plus de détails, consultez les fichiers journaux suivants :

  • Utilitaire de configuration de la console Web.log. Le journal qui vous permet de résoudre les problèmes avec l’utilitaire de configuration de la console Web WEM. Ce fichier journal est créé par défaut et se trouve dans C:\ProgramData.

  • API publique Citrix WEM.log. Le journal qui vous permet de résoudre les problèmes avec le service de console Web WEM. Lorsque vous configurez le service de console Web à l’aide de l’utilitaire Configuration de la console Web pour activer la journalisation, assurez-vous d’activer l’option Activer la journalisation de la console . Ce fichier journal est situé dans C:\ProgramData.

Traces de Windows Communication Foundation

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

Résoudre les problèmes de communication 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. Recherchez 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 entre le marqueur <configuration> et le marqueur </configSections> .
  5. Sauvegarder 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. Afficher 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. Mettre fin au service hôte de l’agent Citrix WEM.
  4. Recherchez 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 marqueur </configSections> .
  6. Sauvegarder 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 rencontré.
  9. Afficher le fichier journal nommé NorskaleAgentHostService-Traces.svclog dans C:\Trace.

Résoudre les problèmes de communication liés 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. Connectez-vous à la machine sur laquelle le service d’infrastructure WEM est installé.
  2. Mettre fin au service d’infrastructure Citrix WEM.
  3. Recherchez le fichier Norskale Broker Service.exe.config dans %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management 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 marqueur <configuration> .

      <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. Sauvegarder 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 d’infrastructure Citrix WEM, puis reproduisez le problème rencontré.
  8. Afficher le fichier journal nommé NorskaleInfrastructureBrokerService-Traces.svclog dans C:\Trace.

Résoudre les problèmes de communication 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. Connectez-vous à la machine de la console d’administration WEM.
  2. Fermez la console d’administration WEM.
  3. Recherchez le fichier Norskale Administration Console.exe.config dans %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management 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 marqueur <configuration> .

      <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. Sauvegarder 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 rencontré.
  8. Afficher le fichier journal nommé WEMConsole-Traces.svclog dans C:\Trace.
Afficher les fichiers journaux