Product Documentation

Installer, mettre à niveau et désinstaller un enregistrement de session

Jun 20, 2017

Check-list d'installation

Avant de commencer l'installation, effectuez les tâches de cette liste :

Étape
  Installez les composants requis avant de commencer l'installation. Consultez les sections Configuration requise et Utiliser un script pour ajouter les fonctionnalités et les rôles Windows requis.
  Sélectionnez les ordinateurs sur lesquels vous souhaitez installer chaque composant d'enregistrement de session et veillez à ce que chaque ordinateur soit conforme aux configurations matérielles et logicielles requises correspondant au(x) composant(s) à y installer.
 

Téléchargez le package d'enregistrement de session à partir de la page de téléchargement de Citrix sous

XenApp > https://www.citrix.com/downloads/xenapp.html

ou

XenDesktop > https://www.citrix.com/downloads/xendesktop.html

  Si vous utilisez le protocole TLS pour les communications entre les composants de l'enregistrement de session, installez les certificats corrects dans votre environnement.
  Installez toute correction requise pour les composants de l'enregistrement de session. Les corrections sont disponibles auprès du support de Citrix
  Configurez Director pour créer et activer des stratégies d'enregistrement de session. Pour de plus amples informations, consultez Configurer Director pour utiliser le serveur d'enregistrement de session.

Remarques :

  • Citrix recommande de séparer les applications publiées dans des groupes de mise à disposition distincts en fonction de vos stratégies d'enregistrement car le partage de session pour les applications publiées peut entrer en conflit avec des stratégies actives si elles se trouvent dans le même groupe de mise à disposition. L'enregistrement de session fait correspondre la stratégie active à la première application publiée qu'un utilisateur ouvre.
  • Si vous prévoyez d'utiliser Machine Creation Services (MCS) ou Provisioning Services, préparez une QMId unique. Pour plus d'informations, veuillez consulter la section Problèmes connus. Si vous ne respectez pas cette consigne, des données d’enregistrement peuvent être perdues.
  • SQL Server requiert que TCP/IP soit activé, que le service SQL Server Browser soit exécuté et que l'authentification Windows soit utilisée.
  • Pour utiliser HTTPS, configurez des certificats de serveur pour TLS/HTTPS.

Fichiers d'installation de l'enregistrement de session :

  • Fichiers d'administration de l'enregistrement de session
    • Broker_PowerShellSnapIn_x64.msi
    • SessionRecordingAdministrationx64.msi
  • Fichiers de l'agent d'enregistrement de session
    • SessionRecordingAgentx64.msi
    • SessionRecordingAgent.msi
  • Fichiers du lecteur d'enregistrement de session
    • SessionRecordingPlayer.msi

Utiliser un script pour ajouter les fonctionnalités et les rôles Windows requis

Pour que l'enregistrement de session fonctionne correctement, vous devez ajouter des fonctionnalités et des rôles Windows requis avant d'installer les composants d'enregistrement de session. Il peut être difficile de rechercher et d'installer certains de ces rôles et fonctionnalités ; c'est pourquoi cet article contient une procédure utilisant un script Citrix. Exécutez le script pour installer les fonctionnalités et les rôles Windows requis avant l'installation des composants d'enregistrement de session.

Pour installer les fonctionnalités et les rôles Windows requis

1.     Si vous souhaitez utiliser les scripts Citrix, consultez la section Scripts pour les fonctionnalités et les rôles Windows requis.

2.     Effectuez les opérations suivantes sur la machine sur laquelle vous allez installer les composants de l'administration d'enregistrement de session :

a)     Vérifiez que la stratégie d'exécution est définie sur RemoteSigned ou Unrestricted dans PowerShell.

Set-ExecutionPolicy RemoteSigned

(b)    Démarrez une invite de commande en tant qu’administrateur, puis exécutez la commande powershell.exe -file InstallPrereqsforSessionRecordingAdministration.ps1.

Le script affiche les fonctionnalités qui ont été ajoutées avec succès et s'arrête.

c)     Une fois que les scripts se sont exécutés, assurez-vous que la stratégie d'exécution est définie sur une valeur correcte en fonction de la stratégie de votre entreprise.

3.     Effectuez les opérations suivantes sur la machine sur laquelle vous allez installer le composant de l'agent d'enregistrement de session :

a)     Vérifiez que la stratégie d'exécution est définie sur RemoteSigned ou Unrestricted dans PowerShell.

Set-ExecutionPolicy RemoteSigned

(b)    Démarrez une invite de commande en tant qu’administrateur, puis exécutez la commande powershell.exe -file InstallPrereqsforSessionRecordingAgent.ps1.

Le script affiche les fonctionnalités qui ont été ajoutées avec succès et s'arrête.

c)     Une fois que les scripts se sont exécutés, assurez-vous que la stratégie d'exécution est définie sur une valeur correcte en fonction de la stratégie de l'entreprise.

4.     Une fois que les rôles et fonctionnalités de Windows sont installés, continuez l'installation de l'enregistrement de session. 

Installer les composants de l'administration de l'enregistrement de session

Les composants de l'administration de l'enregistrement de session sont les suivants : base de données d'enregistrement de session, serveur d'enregistrement de session et console de stratégie d'enregistrement de session. Vous pouvez choisir lequel de ces composants installer sur un serveur.

Avant d'installer les composants de l'administration de l'enregistrement de session, assurez-vous que tous les composants requis sont installés. Pour plus d'informations, veuillez consulter la section Configuration requise.

Pour améliorer la sécurité, vous pouvez supprimer ces droits après l'installation de la base de données.

  1. Cliquez deux fois sur Broker_PowerShellSnapIn_x64.msi puis suivez les invites pour terminer l'installation.
  2. Démarrez l'invite de commande de Windows en tant qu'administrateur, puis exécutez la commande msiexec /i SessionRecordingAdministrationx64.msi  ou cliquez deux fois sur le fichier .msi.
  3. Sur l'interface utilisateur d'installation, cliquez sur Suivant et acceptez le contrat de licence.
  4. Sur l'écran d'installation de l'administration de l'enregistrement de session, sélectionnez les composants d'administration de l'enregistrement de session que vous voulez installer.

Remarque

La journalisation de l'administrateur d'enregistrement de session est un sous-composant facultatif du serveur d'enregistrement de session. Installez ce composant si vous souhaitez activer la fonctionnalité de journalisation de l'administrateur. 

Installer la base de données d'enregistrement de session

Avant d'installer la base de données d''enregistrement de session, assurez-vous que tous les composants requis sont installés. Pour plus d'informations, veuillez consulter la section Configuration requise.

Important : la base de données d'enregistrement de session n'est pas une véritable base de données. Elle est le composant responsable de la création et de la configuration des bases de données requises dans l'instance Microsoft SQL Server au cours de l'installation. L'enregistrement de session prend en charge trois solutions pour la haute disponibilité de base de données basée sur Microsoft SQL Server. Pour plus d’informations, consultez la section Installer l’enregistrement de session avec une haute disponibilité de base de données.

Il existe généralement trois types de déploiement composant Base de données d'enregistrement de session et Microsoft SQL Server :

  • Déploiement 1 : Installer le serveur d'enregistrement de session et la base de données d'enregistrement de session sur le même serveur et la base de données Microsoft SQL Server sur une machine distante. (Recommandé)
  • Déploiement 2 : Installer le serveur d'enregistrement de session, la base de données d'enregistrement de session et la base de données Microsoft SQL Server sur la même machine.
  • Déploiement 3 : Installer le serveur d'enregistrement de session sur un serveur et installer la base de données d'enregistrement de session et Microsoft SQL Server sur la même machine, autre que la machine du serveur d'enregistrement de session (Non recommandé). (Non recommandé).

1. Sur la page Configuration de la base de données et du serveur :

  • Déploiements 1 et 2 : entrez la valeur localhost dans le champ du compte d'ordinateur du serveur d'enregistrement de session.
  • Déploiement 3 : entrez le nom de l'ordinateur hébergeant le serveur d'enregistrement de session dans le format domaine\nom-ordinateur. Le compte d'ordinateur du serveur d'enregistrement de session est le compte utilisateur utilisé pour accéder à la base de données.
localized image

Si l'instance de base de données n'est pas une instance nommée comme configuré lors de la configuration de l'instance, vous pouvez uniquement utiliser le nom de l'ordinateur du serveur SQL Server. Si vous avez nommé l'instance, utilisez nom-ordinateur\nom-instance comme nom d'instance de la base de données. Pour déterminer le nom de l'instance du serveur que vous utilisez, exécutez select @@servername sur SQL Server et la valeur renvoyée est le nom exact de l'instance de base de données. 

Entrez un nom de base de données personnalisé dans la zone de texte Nom de la base de données ou utilisez le nom de base de données par défaut en sélectionnant Utiliser le nom par défaut de la base de données. Cliquez sur Suivant pour tester la connectivité avec l’instance de SQL Server et la validité du nom de base de données.

Important

Un nom de base de données personnalisé doit contenir uniquement les caractères A-Z, a-z et les chiffres 0-9 et ne doit pas dépasser 123 caractères.

2.  Suivez les instructions pour terminer l'installation. Durant l'installation, si l'utilisateur actuel n'est pas l'administrateur de la base de données, une boîte de dialogue s'affiche, demandant les informations d'identification d'un administrateur de base de données avec les autorisations de rôle de serveur securityadmin et dbcreator. Entrez les informations d'identification correctes et cliquez sur OK pour continuer l'installation. L'installation crée la nouvelle base de données d'enregistrement de session et ajoute le compte de machine du serveur d'enregistrement de session en tant que db-owner.

Une fois l'installation terminée, les autorisations de rôle de serveur securityadmin et dbcreator ne sont plus nécessaires et peuvent être supprimées pour l'utilisateur actuel.

Installer le serveur d'enregistrement de session

Avant d'installer le serveur d'enregistrement de session, assurez-vous que tous les composants requis sont installés. Pour plus d'informations, veuillez consulter la section Configuration requise.

  1. Entrez le nom de votre serveur SQL Server dans la case Nom de l'instance. Si vous utilisez une instance nommée, entrez nom-ordinateur\nom-instance ; sinon, entrez un nom-ordinateur uniquement. 
  2. Entrez un nom de base de données personnalisé dans la zone de texte Nom de la base de données ou utilisez le nom de base de données par défaut en sélectionnant Utiliser le nom par défaut de la base de données.
  3. Assurez-vous que vous avez l’autorisation de rôle public sur SQL Server et que vous entrez un nom de base de données correct. Ensuite, cliquez sur Suivant pour continuer l'installation et suivez les instructions pour terminer l'installation.
  4. Sur la page suivante, si vous choisissez d’installer la fonctionnalité de journalisation de l’administrateur d’enregistrement de session, entrez un nom de base de données personnalisé pour la base de données de journalisation de l’administrateur dans la zone de texte Nom de base de données de journalisation ou utilisez le nom de la base de données par défaut en sélectionnant Utiliser le nom par défaut de la base de données.
  5. À la fin de l'assistant d'installation, vous pouvez indiquer si vous voulez participer au Programme d'amélioration de l'expérience utilisateur Citrix. Lorsque vous participez à ce programme, des informations d'utilisation et des statistiques anonymes sont envoyées à Citrix. Pour plus d'informations, veuillez consulter la section À propos du Programme d'amélioration de l'expérience utilisateur Citrix (CEIP).
  6. L'installation du serveur d'enregistrement de session utilise par défaut HTTPS/TLS pour sécuriser les communications. Si TLS n'est pas configuré sur le site IIS par défaut du serveur d'enregistrement de session, utilisez HTTP. Pour ce faire, annulez la sélection de SSL dans la console de gestion IIS : accédez au site du broker d'enregistrement de session, ouvrez les paramètres SSL et désélectionnez la case Exiger SSL.

Configurer Director pour utiliser le serveur d'enregistrement de session

Vous pouvez utiliser la console Director pour créer et activer des stratégies d'enregistrement de session.

  1. Dans le cas d'une connexion HTTPS, installez le certificat destiné à approuver le serveur d'enregistrement de session dans les certificats racines de confiance du serveur Director.
  2. Pour configurer le serveur Director pour utiliser le serveur d'enregistrement de session, exécutez la commande :C:\inetpub\wwwroot\Director\tools\DirectorConfig.exe /configsessionrecording
  3. Entrez l'adresse IP ou le nom de domaine complet du serveur d'enregistrement de session, le numéro de port et le type de connexion (HTTP/HTTPS) que l'agent d'enregistrement de session utilise pour se connecter broker d'enregistrement de session sur le serveur Director.

Installer l'agent d'enregistrement de session

L'agent d'enregistrement de session doit être installé sur la machine VDA ou VDI sur laquelle vous voulez enregistrer les sessions.

  1. Utilisez le Gestionnaire de serveur pour installer .NET Framework et Microsoft Message Queuing (MSMQ) avec prise en charge HTTP sur la machine VDI ou le VDA pour OS de serveur.
  2. Démarrez l'invite de commande de Windows en tant qu'administrateur, puis exécutez la commande msiexec /i SessionRecordingAgentx64.msi ou msiexec /i SessionRecordingAgent.msi  ou cliquez deux fois sur le fichier .msi.
    Utilisez le fichier .msi en fonction du type de plate-forme : SessionRecordingAgent.msi pour les systèmes 32 bits et SessionRecordingAgentx64.msi pour les systèmes 64 bits.
  3. Sur l'interface utilisateur d'installation, sélectionnez Suivant et acceptez le contrat de licence.
  4. Dans la page Configuration de l'agent d'enregistrement de session, entrez le nom de l'ordinateur sur lequel vous avez installé le serveur d'enregistrement de session ainsi que les informations de protocole et de port requises pour la connexion au serveur d'enregistrement de session.
localized image

  5. Suivez les instructions pour terminer l'installation.

Installer le lecteur d'enregistrement de session

Installez le lecteur d'enregistrement de session sur le serveur d'enregistrement de session ou sur l'un ou plusieurs des postes de travail du domaine pour les utilisateurs qui visionnent les enregistrements de session.

Cliquez deux fois sur SessionRecordingPlayer.msi puis suivez les invites pour terminer l'installation.

Automatiser les installations

Pour installer l'agent d'enregistrement de session sur plusieurs serveurs, créez un script utilisant l'installation silencieuse.

La ligne de commande suivante installe l'agent d'enregistrement de session et crée un fichier journal pour capturer les informations d'installation.

Pour les systèmes 64 bits :

msiexec /i SessionRecordingAgentx64.msi sessionrecordingservername=nom_de_votre_serveur sessionrecordingbrokerprotoco=protocole_de_votre_broker  sessionrecordingbrokerport=port_de_votre_broker /l*v votre_journal_installation /q

Pour les systèmes 32 bits :

msiexec /i SessionRecordingAgent.msi sessionrecordingservername=nom_de_votre_serveur sessionrecordingbrokerprotoco=protocole_de_votre_broker sessionrecordingbrokerport=port_de_votre_broker /l*v votre_journal_installation /q

où :

nom_de_votre_serveur correspond au nom NetBIOS ou au nom de domaine complet de l'ordinateur hébergeant le serveur d'enregistrement de session. Si elle n'est pas précisée, cette valeur prend par défaut la valeur localhost.

protocole_de_votre_broker est le protocole, HTTP ou HTTPS, que l'agent d'enregistrement de session utilise pour communiquer avec le broker d'enregistrement de session. Si elle n'est pas précisée, cette valeur prend par défaut la valeur HTTPS.

port_de_votre_broker est le numéro de port que l'agent d'enregistrement de session utilise pour communiquer avec le broker d'enregistrement de session. Si elle n'est pas précisée, la valeur par défaut de cette valeur est zéro, qui amène l'agent d'enregistrement de session à utiliser le numéro de port par défaut pour le protocole sélectionné : 80 pour HTTP ou 443 pour HTTPS.

/l*v spécifie l'enregistrement détaillé.

votre_journal_installation est l’emplacement de votre fichier journal d’installation.

/q spécifie le mode silencieux.

Mettre à niveau l'enregistrement de session

Vous pouvez mettre à niveau certains déploiements vers des versions ultérieures sans devoir d'abord configurer les nouvelles machines ou sites. Vous pouvez mettre à niveau à partir de l'enregistrement de session 7.6.0 (ou version ultérieure) vers la dernière version de l'enregistrement de session.

Configuration requise, préparation et limites

Remarque : vous ne pouvez pas mettre à niveau à partir d'une version Technology Preview.

  • Vous devez utiliser l'interface graphique ou l'interface de ligne de commande du programme d'installation de l'enregistrement de session pour mettre à niveau les composants d'enregistrement de session sur la machine sur laquelle vous avez installé les composants.
  • Avant de procéder à toute activité de mise à niveau, sauvegardez la base de données nommée CitrixSessionRecording dans l'instance de SQL Server, afin de pouvoir la restaurer en cas de problème après la mise à niveau de la base de données.
  • En plus d'être un utilisateur du domaine, vous devez être un administrateur local sur les machines sur lesquelles vous mettez à niveau les composants d'enregistrement de session.
  • Si le serveur d'enregistrement de session et la base de données d'enregistrement de session ne sont pas installés sur le même serveur, vous devez disposer de l'autorisation de rôle de base de données pour mettre à niveau la base de données d'enregistrement de session ; sinon, vous êtes invité à entrer les informations d'identification des rôles securityadmin et dbcreator lors de la mise à niveau.
  • Si vous n'envisagez pas de mettre à niveau tous les agents d'enregistrement de session en même temps, l'agent d'enregistrement de session 7.6.0 (ou une version ultérieure) peut fonctionner avec la dernière version (courante) du serveur d'enregistrement de session. Cependant, certaines nouvelles fonctionnalités et des corrections de bogues risquent de ne pas être appliquées.
  • Les sessions lancées durant la mise à niveau du serveur d'enregistrement de session ne sont pas enregistrées.
  • La fonctionnalité Journalisation de l'administrateur n'est pas installée après la mise à niveau de l'enregistrement de session à partir d'une version précédente qui ne contient pas cette fonctionnalité. Pour ajouter la nouvelle fonctionnalité, modifiez l'installation après la mise à niveau.
  • S'il existe des sessions d'enregistrement actives lorsque le processus de mise à niveau démarre, l'enregistrement ne pourra probablement pas se terminer.
  • Vérifiez la séquence de mise à niveau ci-dessous afin de pouvoir planifier et réduire tout problème potentiel.

Séquence de mise à niveau

  1. Si la base de données d'enregistrement de session et le serveur d'enregistrement de session sont installés sur des serveurs différents, arrêtez le service Gestionnaire de stockage d'enregistrement de session manuellement sur le serveur d'enregistrement de session, puis mettez à niveau la base de données d'enregistrement de session.
  2. Assurez-vous que le broker d'enregistrement de session est exécuté avec le service IIS. Mettez à niveau le serveur d'enregistrement de session. Si la base de données d'enregistrement de session et le serveur d'enregistrement de session sont installés sur le même serveur, la base de données d'enregistrement de session doit également être mise à niveau.
  3. Le service d'enregistrement de session est automatiquement reconnecté lorsque la mise à niveau du serveur d'enregistrement de session est terminée.
  4. Mettez à niveau l'agent d'enregistrement de session (sur l'image principale).
  5. Mettez à niveau la console de stratégie d'enregistrement de session avec ou après le serveur d'enregistrement de session.
  6. Mettez à niveau le lecteur d'enregistrement de session.

Désinstaller l'enregistrement de session

Pour supprimer tous les composants d'enregistrement de session d'un serveur ou d'une station de travail, utilisez la capacité de désinstallation ou de suppression des programmes disponible au travers du Panneau de configuration Windows. Pour supprimer la base de données d'enregistrement de session, vous devez avoir les mêmes droits d'administrateur système SQL Server securityadmin et dbcreator que lorsque vous l'avez installée.

Pour des raisons de sécurité, la base de données de Journalisation de l'administrateur n'est pas supprimée après la désinstallation des composants.