Dépanner l’enregistrement de session

Les informations de dépannage contiennent des solutions à certains problèmes que vous pourriez rencontrer pendant et après l’installation des composants d’enregistrement de session :

• Les composants ne parviennent pas à se connecter les uns aux autres
• Les sessions ne parviennent pas à s’enregistrer
• Problèmes avec le Session Recording Player ou la console de stratégie d’enregistrement de session
• Problèmes liés à votre protocole de communication

Avertissement :

Toute modification incorrecte du registre peut entraîner de graves problèmes qui pourraient vous obliger à réinstaller votre système d’exploitation. Citrix® ne peut garantir que les problèmes résultant d’une utilisation incorrecte de l’Éditeur du Registre puissent être résolus. Utilisez l’Éditeur du Registre à vos propres risques. Veillez à sauvegarder le registre avant de le modifier.

L’agent d’enregistrement de session ne peut pas se connecter

Lorsque l’agent d’enregistrement de session ne peut pas se connecter, le message d’événement Exception caught while sending poll messages to Session Recording Broker est enregistré, suivi du texte de l’exception. Le texte de l’exception fournit les raisons de l’échec de la connexion. Les raisons incluent :

• La connexion sous-jacente a été fermée. Impossible d’établir une relation de confiance pour le canal sécurisé SSL/TLS. Cette exception signifie que le serveur d’enregistrement de session utilise un certificat signé par une autorité de certification (CA) à laquelle le serveur sur lequel réside l’agent d’enregistrement de session ne fait pas confiance, ou pour laquelle il ne possède pas de certificat d’autorité de certification. Le certificat peut également avoir expiré ou avoir été révoqué.

  Résolution : Vérifiez que le certificat d’autorité de certification correct est installé sur le serveur hébergeant l’agent d’enregistrement de session ou utilisez une autorité de certification de confiance.

• Le serveur distant a renvoyé une erreur : (403) interdit. Il s’agit d’une erreur HTTPS standard affichée lorsque vous tentez de vous connecter à l’aide de HTTP (protocole non sécurisé). L’ordinateur hébergeant le serveur d’enregistrement de session rejette la connexion car il n’accepte que les connexions sécurisées.

  Résolution : Utilisez les propriétés de l’agent d’enregistrement de session pour modifier le protocole du broker d’enregistrement de session en HTTPS.

Le broker d’enregistrement de session a renvoyé une erreur inconnue lors de l’évaluation d’une requête de stratégie d’enregistrement. Code d’erreur 5 (Accès refusé). Pour plus d’informations, consultez le journal des événements sur le serveur d’enregistrement de session. Cette erreur se produit lorsque des sessions sont démarrées et qu’une demande d’évaluation de stratégie d’enregistrement est effectuée. L’erreur est le résultat de la suppression du groupe Utilisateurs authentifiés (qui est le membre par défaut) du rôle de requête de stratégie de la console d’autorisation d’enregistrement de session.

Résolution : Ajoutez le groupe Utilisateurs authentifiés à nouveau à ce rôle, ou ajoutez chaque serveur hébergeant chaque agent d’enregistrement de session au rôle PolicyQuery.

La connexion sous-jacente a été fermée. Une connexion qui devait être maintenue active a été fermée par le serveur. Cette erreur signifie que le serveur d’enregistrement de session est arrêté ou indisponible pour accepter les requêtes. Cela peut être dû au fait qu’IIS est hors ligne ou a été redémarré, ou que le serveur entier est hors ligne.

Résolution : Vérifiez que le serveur d’enregistrement de session est démarré, qu’IIS est en cours d’exécution sur le serveur et que le serveur est connecté au réseau.

L’installation des composants du serveur d’enregistrement de session échoue

L’installation des composants du serveur d’enregistrement de session échoue avec les codes d’erreur 2503 et 2502. Résolution : Vérifiez la liste de contrôle d’accès (ACL) du dossier C:\windows\Temp pour vous assurer que les utilisateurs et groupes locaux disposent des autorisations d’écriture pour ce dossier. Si ce n’est pas le cas, ajoutez manuellement l’autorisation d’écriture.

Le serveur d’enregistrement de session ne peut pas se connecter à la base de données d’enregistrement de session

Lorsque le serveur d’enregistrement de session ne peut pas se connecter à la base de données d’enregistrement de session, vous pouvez voir un message similaire à l’un des suivants :

Source de l’événement :

Une erreur liée au réseau ou spécifique à l’instance s’est produite lors de l’établissement d’une connexion à SQL Server. Cette erreur apparaît dans le journal des événements des applications avec l’ID 2047 dans l’Observateur d’événements de l’ordinateur hébergeant le serveur d’enregistrement de session.

Description du gestionnaire de stockage d’enregistrement de session Citrix : Exception détectée lors de l’établissement de la connexion à la base de données. Cette erreur apparaît dans le journal des événements des applications dans l’Observateur d’événements de l’ordinateur hébergeant le serveur d’enregistrement de session.

Impossible de se connecter au serveur d’enregistrement de session. Assurez-vous que le serveur d’enregistrement de session est en cours d’exécution. Ce message d’erreur apparaît lorsque vous lancez la console de stratégie d’enregistrement de session.

Résolution :

• L’édition Express de Microsoft SQL Server 2008 R2, Microsoft SQL Server 2012, Microsoft SQL Server 2014 ou Microsoft SQL Server 2016 est installée sur un serveur autonome et ne dispose pas des services ou paramètres corrects configurés pour l’enregistrement de session. Le serveur doit avoir le protocole TCP/IP activé et le service SQL Server Browser en cours d’exécution. Consultez la documentation Microsoft pour plus d’informations sur l’activation de ces paramètres.
• Lors de l’installation de l’enregistrement de session (partie administration), des informations de serveur et de base de données incorrectes ont été fournies. Désinstallez la base de données d’enregistrement de session et réinstallez-la en fournissant les informations correctes.
• Le serveur de base de données d’enregistrement de session est arrêté. Vérifiez que le serveur dispose d’une connectivité.
• L’ordinateur hébergeant le Session Recording Server ou l’ordinateur hébergeant le Session Recording Database Server ne peut pas résoudre le nom FQDN ou NetBIOS de l’autre. Utilisez la commande ping pour vérifier que les noms peuvent être résolus.
• Vérifiez la configuration du pare-feu sur la base de données Session Recording pour vous assurer que les connexions SQL Server sont autorisées. Pour plus d’informations, consultez l’article Microsoft à l’adresse https://docs.microsoft.com/fr-fr/sql/sql-server/install/configure-the-windows-firewall-to-allow-sql-server-access.

Échec de l’ouverture de session pour l’utilisateur ‘NT_AUTHORITY\ANONYMOUS LOGON’. Ce message d’erreur signifie que les services sont connectés de manière incorrecte en tant que .\administrator.

Résolution : Redémarrez les services en tant qu’utilisateur système local et redémarrez les services SQL.

Les sessions ne sont pas enregistrées

Si vos sessions d’application ne sont pas enregistrées correctement, commencez par vérifier le journal des événements d’application dans l’Observateur d’événements sur le VDA pour OS de serveur qui exécute l’agent d’enregistrement de session et le serveur d’enregistrement de session. Cela pourrait fournir des informations de diagnostic précieuses.

Si les sessions ne sont pas enregistrées, les problèmes suivants peuvent en être la cause :

• Connectivité des composants et certificats. Si les composants d’enregistrement de session ne peuvent pas communiquer entre eux, cela peut entraîner l’échec des enregistrements de session. Pour résoudre les problèmes d’enregistrement, vérifiez que tous les composants sont configurés correctement pour pointer vers les ordinateurs appropriés et que tous les certificats sont valides et correctement installés.
• Environnements de domaine non-Active Directory. L’enregistrement de session est conçu pour fonctionner dans un environnement de domaine Microsoft Active Directory. Si vous n’opérez pas dans un environnement Active Directory, vous pourriez rencontrer des problèmes d’enregistrement. Assurez-vous que tous les composants d’enregistrement de session s’exécutent sur des ordinateurs membres d’un domaine Active Directory.
• Le partage de session est en conflit avec la stratégie active. L’enregistrement de session associe la stratégie active à la première application publiée qu’un utilisateur ouvre. Les applications suivantes ouvertes au cours de la même session continuent de suivre la stratégie en vigueur pour la première application. Pour éviter que le partage de session n’entre en conflit avec la stratégie active, publiez les applications en conflit sur des VDA distincts pour OS de serveur.
• L’enregistrement n’est pas activé. Par défaut, l’installation de l’agent d’enregistrement de session sur un VDA pour OS de serveur active le serveur pour l’enregistrement. L’enregistrement ne se produira pas tant qu’une stratégie d’enregistrement active n’est pas configurée pour l’autoriser.
• La stratégie d’enregistrement active n’autorise pas l’enregistrement. Pour qu’une session soit enregistrée, la stratégie d’enregistrement active doit autoriser l’enregistrement des sessions pour l’utilisateur, le serveur ou l’application publiée.
• Les services d’enregistrement de session ne sont pas en cours d’exécution. Pour que les sessions soient enregistrées, le service Agent d’enregistrement de session doit être en cours d’exécution sur un VDA pour OS de serveur et le service Gestionnaire de stockage d’enregistrement de session doit être en cours d’exécution sur l’ordinateur hébergeant le serveur d’enregistrement de session.
• MSMQ n’est pas configuré. Si MSMQ n’est pas correctement configuré sur le serveur exécutant l’agent d’enregistrement de session et l’ordinateur hébergeant le serveur d’enregistrement de session, des problèmes d’enregistrement peuvent survenir.

Impossible d’afficher la lecture de session en direct

Si vous rencontrez des difficultés lors de la visualisation des enregistrements à l’aide du lecteur d’enregistrement de session, le message d’erreur suivant peut apparaître :

Le téléchargement du fichier d’enregistrement de session a échoué. La lecture de session en direct n’est pas autorisée. Le serveur a été configuré pour interdire cette fonctionnalité. Cette erreur indique que le serveur est configuré pour interdire l’action.

Résolution : Dans les Propriétés du serveur d’enregistrement de session, choisissez l’onglet Lecture et cochez la case Autoriser la lecture de session en direct.

Les enregistrements sont corrompus ou incomplets

• Si les enregistrements sont corrompus ou incomplets lorsque vous les visualisez à l’aide du lecteur d’enregistrement de session, vous pouvez également voir des avertissements dans les journaux d’événements sur l’agent d’enregistrement de session.

  Source de l’événement : Citrix Session Recording Storage Manager

  Description : Données perdues lors de l’enregistrement du fichier <icl file name>

  Cela se produit généralement lorsque Machine Creation Services™ (MCS) ou Provisioning Services (PVS) est utilisé pour créer des VDA avec une image principale configurée et Microsoft Message Queuing (MSMQ) installé. Dans cette condition, les VDA ont le même QMId pour MSMQ.

  Pour contourner ce problème, créez un QMId unique pour chaque VDA. Pour plus d’informations, consultez l’étape 8 dans la section Installer l’agent d’enregistrement de session de Installer, mettre à niveau et désinstaller l’enregistrement de session.

• Le lecteur d’enregistrement de session peut signaler une erreur interne avec ce message - “Le fichier en cours de lecture a signalé qu’une erreur système interne (code d’erreur : 9) s’est produite lors de son enregistrement initial. Le fichier peut toujours être lu jusqu’au point où l’erreur d’enregistrement s’est produite” lors de la lecture d’un certain fichier d’enregistrement.

  Cela est généralement dû à une taille de tampon insuffisante de l’agent d’enregistrement de session lors de l’enregistrement de sessions graphiquement intensives.

  Pour contourner ce problème, modifiez la valeur de registre de HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\SmAudBufferSizeMB à une valeur plus élevée dans l’agent d’enregistrement de session, puis redémarrez la machine.

Le test de connexion de l’instance de base de données a échoué lors de l’installation de la base de données d’enregistrement de session ou du serveur d’enregistrement de session

Lorsque vous installez la base de données d’enregistrement de session ou le serveur d’enregistrement de session, le test de connexion échoue avec le message d’erreur Le test de connexion à la base de données a échoué. Veuillez corriger le nom de l’instance de base de données même si le nom de l’instance de base de données est correct.

Dans ce cas, assurez-vous que l’utilisateur actuel dispose de l’autorisation de rôle public SQL Server pour corriger l’échec de limitation des autorisations.

Journalisation de l’administrateur

Sous Windows Server 2008 R2 SP1, avant d’installer la fonctionnalité Journalisation de l’administrateur, installez Fonctionnalités .Net Framework 3.5 > Activation WCF > Activation HTTP, puis installez .Net Framework 4.5 ou une version ultérieure. Assurez-vous de ne pas installer ces deux prérequis dans l’ordre inverse. Si vous ne respectez pas cette consigne, la Journalisation de l’administrateur pourrait ne pas fonctionner comme prévu. Vous pourriez rencontrer un blocage des opérations lorsque vous tentez de modifier les configurations d’enregistrement de session avec la console des propriétés du serveur ou de mettre à jour les stratégies d’enregistrement de session avec la console de stratégie lorsque la journalisation obligatoire est activée.

Pour résoudre ce problème :

1. Ouvrez le Gestionnaire des services Internet (IIS) et accédez au nœud Pools d’applications.
2. Cliquez avec le bouton droit sur SessionRecordingLoggingAppPool et ouvrez la boîte de dialogue Paramètres de base.
3. Modifiez la version du .NET Framework en .NET Framework v4.0.