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

Ce chapitre détaille comment installer l’enregistrement de session à l’aide du programme d’installation XenApp/XenDesktop. Il contient les sections suivantes :

Liste de contrôle d’installation

Installer les composants d’administration de l’enregistrement de session

Configurer Director pour utiliser le serveur d’enregistrement de session

Installer l’agent d’enregistrement de session

Installer le lecteur d’enregistrement de session

Automatiser les installations

Mettre à niveau l’enregistrement de session

Désinstaller l’enregistrement de session

Liste de contrôle d’installation

À partir de la version 7.14, vous pouvez installer les composants d’enregistrement de session à l’aide du programme d’installation XenApp/XenDesktop.

Avant de commencer l’installation, complétez cette liste :

Étape
  Sélectionnez les machines sur lesquelles vous souhaitez installer chaque composant d’enregistrement de session et assurez-vous que chaque ordinateur répond aux exigences matérielles et logicielles du ou des composants à installer.
  Utilisez les informations d’identification de votre compte Citrix® pour accéder à la page de téléchargement de XenApp et XenDesktop® et télécharger le fichier ISO du produit. Décompressez le fichier ISO ou gravez-le sur un DVD.
  Pour utiliser le protocole TLS pour la communication entre les composants d’enregistrement de session, installez les certificats corrects dans votre environnement.
  Installez tous les correctifs requis pour les composants d’enregistrement de session. Les correctifs sont disponibles auprès du support Citrix.
  Configurez Director pour créer et activer les stratégies d’enregistrement de session. Pour plus d’informations, consultez Configurer Director pour utiliser le serveur d’enregistrement de session.

Remarque :

  • Citrix vous recommande de diviser les applications publiées en groupes de mise à disposition (Delivery Groups) distincts en fonction de vos stratégies d’enregistrement, car le partage de session pour les applications publiées peut entrer en conflit avec les stratégies actives si elles se trouvent dans le même groupe de mise à disposition. L’enregistrement de session associe 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 un QMId unique. Le non-respect de cette consigne peut entraîner des pertes de données d’enregistrement.
  • SQL Server exige que le protocole TCP/IP soit activé, que le service SQL Server Browser soit en cours d’exécution et que l’authentification Windows soit utilisée.
  • Pour utiliser HTTPS, configurez les certificats de serveur pour TLS/HTTPS.
  • Assurez-vous que les utilisateurs sous Utilisateurs et groupes locaux > Groupes > Utilisateurs disposent des autorisations d’écriture sur le dossier C:\windows\Temp.

Installer les composants d’administration de l’enregistrement de session

Citrix vous recommande d’installer les composants d’administration, l’agent et le lecteur de l’enregistrement de session sur des serveurs distincts. Les composants d’administration de l’enregistrement de session comprennent la base de données, le serveur et la console de stratégie de l’enregistrement de session. Vous pouvez choisir lesquels de ces composants installer sur un serveur.

Étape 1 : Télécharger le logiciel du produit et lancer l’assistant

  1. Si vous n’avez pas encore téléchargé l’ISO XenApp® et XenDesktop, utilisez les informations d’identification de votre compte Citrix pour accéder à la page de téléchargement de XenApp et XenDesktop et télécharger le fichier ISO du produit. Décompressez le fichier ISO ou gravez-le sur un DVD.
  2. Utilisez un compte administrateur local pour vous connecter à la machine sur laquelle vous installez les composants d’administration de l’enregistrement de session. Insérez le DVD dans le lecteur ou montez le fichier ISO. Si le programme d’installation ne se lance pas automatiquement, double-cliquez sur l’application AutoSelect ou sur le lecteur monté. L’assistant d’installation se lance.

Étape 2 : Choisissez le produit à installer

image localisée

Cliquez sur Démarrer à côté du produit à installer : XenApp ou XenDesktop.

Étape 3 : Sélectionnez l’enregistrement de session

image localisée

Sélectionnez l’entrée Enregistrement de session.

Étape 4 : Lisez et acceptez le contrat de licence

image localisée

Sur la page Contrat de licence logicielle, lisez le contrat de licence, acceptez-le, puis cliquez sur Suivant.

Étape 5 : Sélectionnez les composants à installer et l’emplacement d’installation

image localisée

Sur la page Composants principaux :

  • Emplacement : Par défaut, les composants sont installés dans C:\Program Files\Citrix. L’emplacement par défaut convient à la plupart des déploiements. Vous pouvez spécifier un emplacement d’installation personnalisé.
  • Composant : Par défaut, toutes les cases à cocher à côté des composants pouvant être installés sont sélectionnées. Le programme d’installation sait s’il s’exécute sur un système d’exploitation de bureau ou un système d’exploitation de serveur. Il permet d’installer les composants d’administration de l’enregistrement de session uniquement sur un système d’exploitation de serveur, et il ne permet pas d’installer l’agent d’enregistrement de session sur une machine sur laquelle aucun VDA n’est préalablement installé. Si vous installez l’agent d’enregistrement de session sur une machine sur laquelle aucun VDA n’est préalablement installé, l’option Agent d’enregistrement de session n’est pas disponible.

Sélectionnez Session Recording Administration et cliquez sur Suivant.

image localisée

Étape 6 : Sélectionnez les fonctionnalités à installer

image localisée

Sur la page Fonctionnalités :

  • Par défaut, toutes les cases à cocher à côté des fonctionnalités pouvant être installées sont sélectionnées. L’installation de toutes ces fonctionnalités sur un seul serveur convient pour une preuve de concept. Cependant, pour un environnement de production étendu, Citrix vous recommande d’installer la Console de stratégie d’enregistrement de session sur un serveur distinct, et le Serveur, la Journalisation de l’administrateur et la Base de données d’enregistrement de session sur un autre serveur distinct. Notez que la Journalisation de l’administrateur d’enregistrement de session est une sous-fonctionnalité facultative du Serveur d’enregistrement de session. Vous devez sélectionner le Serveur d’enregistrement de session avant de pouvoir sélectionner la Journalisation de l’administrateur d’enregistrement de session.
  • Pour ajouter une autre fonctionnalité sur le même serveur après avoir sélectionné et installé une ou plusieurs fonctionnalités sur celui-ci, vous ne pouvez exécuter que le package msi, mais pas l’installateur à nouveau.

Sélectionnez la ou les fonctionnalités que vous souhaitez installer et cliquez sur Suivant.

Étape 6.1 : Installer la base de données d’enregistrement de session

Remarque : La base de données d’enregistrement de session n’est pas une base de données réelle. C’est un composant responsable de la création et de la configuration des bases de données requises dans l’instance Microsoft SQL Server pendant l’installation. L’enregistrement de session prend en charge trois solutions pour la haute disponibilité de la base de données basées sur Microsoft SQL Server. Pour plus d’informations, consultez Installer l’enregistrement de session avec haute disponibilité de la base de données.

Il existe généralement trois types de déploiements pour la base de données d’enregistrement de session et Microsoft SQL Server :

  • Déploiement 1 : Installez le serveur d’enregistrement de session et la base de données d’enregistrement de session sur la même machine et le Microsoft SQL Server sur une machine distante. (Recommandé)
  • Déploiement 2 : Installez le serveur d’enregistrement de session, la base de données d’enregistrement de session et Microsoft SQL Server sur la même machine.
  • Déploiement 3 : Installez le serveur d’enregistrement de session sur une machine et installez la base de données d’enregistrement de session et Microsoft SQL Server sur une autre machine. (Non recommandé)
  1. Sur la page Fonctionnalités, sélectionnez Base de données d’enregistrement de session et cliquez sur Suivant.

    image localisée

  2. Sur la page Configuration de la base de données et du serveur, spécifiez le nom de l’instance et le nom de la base de données de la base de données d’enregistrement de session ainsi que le compte d’ordinateur du serveur d’enregistrement de session. Cliquez sur Suivant.

    image localisée

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

    • Nom de l’instance : Si l’instance de base de données n’est pas une instance nommée telle que vous l’avez configurée lors de la configuration de l’instance, vous ne pouvez utiliser que le nom d’ordinateur du serveur SQL. Si vous avez nommé l’instance, utilisez computer-name\instance-name comme nom d’instance de base de données. Pour déterminer le nom de l’instance de serveur que vous utilisez, exécutez select @@servername sur le serveur SQL. La valeur renvoyée est le nom exact de l’instance de base de données. Si votre serveur SQL est configuré pour écouter sur un port personnalisé (autre que le port par défaut 1433), définissez le port d’écoute personnalisé en ajoutant une virgule au nom de l’instance. Par exemple, tapez DXSBC-SRD-1,2433 dans la zone de texte Nom de l’instance, où 2433, après la virgule, indique le port d’écoute personnalisé.
    • Nom de la base de données : Saisissez 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 prédéfini dans la zone de texte. Cliquez sur Tester la connexion pour tester la connectivité à l’instance SQL Server et la validité du nom de la base de données.

    Important :

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

    • Vous devez disposer des autorisations de rôle de serveur securityadmin et dbcreator pour la base de données. Si vous ne disposez pas des autorisations, vous pouvez :
      • Demandez à l’administrateur de la base de données d’attribuer les autorisations pour l’installation. 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 en toute sécurité.
      • Ou, utilisez le package SessionRecordingAdministrationx64.msi (décompressez le fichier ISO, et vous trouverez ce package msi sous …\x64\Session Recording). Pendant l’installation du msi, une boîte de dialogue vous invite à saisir les informations d’identification d’un administrateur de base de données disposant des autorisations de rôle de serveur securityadmin et dbcreator. Saisissez les informations d’identification correctes, puis cliquez sur OK pour poursuivre l’installation.

        L’installation crée la nouvelle base de données d’enregistrement de session et ajoute le compte d’ordinateur du serveur d’enregistrement de session en tant que db_owner.

    • Compte d’ordinateur du serveur d’enregistrement de session :
      • Déploiements 1 et 2 : Tapez localhost dans le champ Compte d’ordinateur du serveur d’enregistrement de session.
      • Déploiement 3 : Tapez le nom de l’ordinateur hébergeant le serveur d’enregistrement de session au format domaine\nom-ordinateur. Le compte d’ordinateur du serveur d’enregistrement de session est le compte utilisateur permettant d’accéder à la base de données d’enregistrement de session.

      Remarque : Les tentatives d’installation des composants d’administration de l’enregistrement de session peuvent échouer avec le code d’erreur 1603 lorsqu’un nom de domaine est défini dans le champ Session Recording Server computer account. Pour contourner ce problème, tapez localhost ou le nom de domaine NetBIOS\nom de la machine dans le champ Session Recording Server computer account.

  3. Passez en revue les prérequis et confirmez l’installation.

    image localisée

    La page Summary (Résumé) affiche vos choix d’installation. Vous pouvez cliquer sur Back (Retour) pour revenir aux pages précédentes de l’assistant et apporter des modifications. Ou, cliquez sur Install (Installer) pour démarrer l’installation.

  4. Terminez l’installation.

    image localisée

    La page Finish Installation (Terminer l’installation) affiche des coches vertes pour tous les prérequis et composants qui ont été installés et initialisés avec succès.

    Cliquez sur Finish (Terminer) pour finaliser l’installation de la base de données d’enregistrement de session.

Étape 6.2 : Installer le serveur d’enregistrement de session

  1. Sur la page Features (Fonctionnalités), sélectionnez Session Recording Server (Serveur d’enregistrement de session) et Session Recording Administrator Logging (Journalisation de l’administrateur d’enregistrement de session). Cliquez sur Next (Suivant).

    image localisée

    Remarque :

    • La journalisation de l’administrateur d’enregistrement de session est une sous-fonctionnalité facultative du serveur d’enregistrement de session. Vous devez sélectionner le serveur d’enregistrement de session avant de pouvoir sélectionner la journalisation de l’administrateur d’enregistrement de session.
    • Citrix vous recommande d’installer la journalisation de l’administrateur d’enregistrement de session en même temps que le serveur d’enregistrement de session. Si vous ne souhaitez pas activer la fonctionnalité de journalisation de l’administrateur, vous pouvez la désactiver sur une page ultérieure. Cependant, si vous choisissez de ne pas installer cette fonctionnalité au début mais que vous souhaitez l’ajouter plus tard, vous ne pouvez l’ajouter manuellement qu’en utilisant le package SessionRecordingAdministrationx64.msi.
  2. Sur la page Database and Server Configuration (Configuration de la base de données et du serveur), spécifiez les configurations.

    image localisée

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

    • Nom de l’instance : Tapez le nom de votre serveur SQL dans la zone de texte Nom de l’instance. Si vous utilisez une instance nommée, tapez nom-ordinateur\nom-instance ; sinon, tapez uniquement nom-ordinateur. Si votre serveur SQL est configuré pour écouter sur un port personnalisé (autre que le port par défaut 1433), définissez le port d’écoute personnalisé en ajoutant une virgule au nom de l’instance. Par exemple, tapez DXSBC-SRD-1,2433 dans la zone de texte Nom de l’instance, où 2433, après la virgule, indique le port d’écoute personnalisé.
    • Nom de la base de données : Tapez 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 CitrixSessionRecording qui est prédéfini dans la zone de texte.
    • Vous devez disposer des autorisations de rôle de serveur securityadmin et dbcreator de la base de données. Si vous ne disposez pas des autorisations, vous pouvez :
      • Demandez à l’administrateur de la base de données d’attribuer les autorisations pour l’installation. 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 en toute sécurité.
      • Ou, utilisez le package SessionRecordingAdministrationx64.msi pour installer le serveur d’enregistrement de session. Pendant l’installation du fichier msi, une boîte de dialogue vous invite à saisir les informations d’identification d’un administrateur de base de données disposant des autorisations de rôle de serveur securityadmin et dbcreator. Saisissez les informations d’identification correctes, puis cliquez sur OK pour poursuivre l’installation.
    • Après avoir saisi le nom d’instance et le nom de base de données corrects, cliquez sur Tester la connexion pour tester la connectivité à la base de données d’enregistrement de session.
    • Saisissez le compte d’ordinateur du serveur d’enregistrement de session, puis cliquez sur Suivant.
  3. Sur la page Configuration de la journalisation d’administration, spécifiez les configurations pour la fonctionnalité de journalisation d’administration.

    image localisée

    Sur la page Configuration de la journalisation d’administration :

    • La base de données de journalisation d’administration est installée sur l’instance SQL Server : Cette zone de texte n’est pas modifiable. Le nom de l’instance SQL Server de la base de données de journalisation d’administration est automatiquement récupéré à partir du nom d’instance que vous avez saisi sur la page Configuration de la base de données et du serveur.
    • Nom de la base de données de journalisation d’administration : Si vous choisissez d’installer la fonctionnalité de journalisation d’administration d’enregistrement de session, saisissez un nom personnalisé pour cette base de données dans cette zone de texte ou utilisez le nom par défaut CitrixSessionRecordingLogging qui y est prédéfini. Remarque : Le nom de la base de données de journalisation d’administration doit être différent de celui de la base de données d’enregistrement de session défini dans la zone de texte Nom de la base de données de la page précédente, Configuration de la base de données et du serveur.
    • Après avoir saisi le nom de la base de données de journalisation d’administration, cliquez sur Tester la connexion pour tester la connectivité à la base de données de journalisation d’administration.
    • Activer la journalisation d’administration : Par défaut, la fonctionnalité de journalisation d’administration est activée. Vous pouvez la désactiver en décochant la case.
    • Activer le blocage obligatoire : Par défaut, le blocage obligatoire est activé. Les fonctionnalités normales peuvent être bloquées si la journalisation échoue. Vous pouvez désactiver le blocage obligatoire en décochant la case.

    Cliquez sur Suivant pour poursuivre l’installation.

  4. Vérifiez les prérequis et confirmez l’installation.

    image localisée

    La page Résumé affiche vos choix d’installation. Vous pouvez cliquer sur Précédent pour revenir aux pages précédentes de l’assistant et apporter des modifications. Ou, cliquez sur Installer pour démarrer l’installation.

  5. Terminez l’installation.

    image localisée

    La page Fin de l’installation affiche des coches vertes pour tous les prérequis et composants qui ont été installés et initialisés avec succès.

    Cliquez sur Terminer pour achever l’installation du serveur d’enregistrement de session.

    Remarque : L’installation par défaut du serveur d’enregistrement de session utilise HTTPS/TLS pour sécuriser les communications. Si TLS n’est pas configuré dans 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 en accédant au site du broker d’enregistrement de session, en ouvrant les paramètres SSL et en décochant la case Require SSL.

Étape 6.3 : Installer la console de stratégie d’enregistrement de session

  1. Sur la page Fonctionnalités, sélectionnez Console de stratégie d’enregistrement de session et cliquez sur Suivant.

    image localisée

  2. Vérifiez les prérequis et confirmez l’installation.

    image localisée

    La page Résumé affiche vos choix d’installation. Vous pouvez cliquer sur Retour pour revenir aux pages précédentes de l’assistant et apporter des modifications. Ou, cliquez sur Installer pour démarrer l’installation.

  3. Terminez l’installation.

    image localisée

    La page Fin de l’installation affiche des coches vertes pour tous les prérequis et composants qui ont été installés et initialisés avec succès.

    Cliquez sur Terminer pour finaliser l’installation de la console de stratégie d’enregistrement de session.

Étape 7 : Installer Broker_PowerShellSnapIn_x64.msi

Important : Pour utiliser la console de stratégie d’enregistrement de session, vous devez avoir installé le composant logiciel enfichable Broker PowerShell (Broker_PowerShellSnapIn_x64.msi). Le composant logiciel enfichable ne peut pas être installé automatiquement par le programme d’installation. Localisez le composant logiciel enfichable sur l’ISO XenApp/XenDesktop (\layout\image-full\x64\Citrix Desktop Delivery Controller) et suivez les instructions pour l’installer manuellement. Le non-respect de cette consigne peut entraîner une erreur.

Configurer Director pour utiliser le serveur d’enregistrement de session

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

  1. Pour une connexion HTTPS, installez le certificat pour faire confiance au serveur d’enregistrement de session dans les certificats racines de confiance du serveur Director.
  2. Pour configurer le serveur Director afin qu’il utilise le serveur d’enregistrement de session, exécutez la commande C:\inetpub\wwwroot\Director\tools\DirectorConfig.exe /configsessionrecording.
  3. Saisissez l’adresse IP ou le nom de domaine complet (FQDN) du serveur d’enregistrement de session, ainsi que le numéro de port et le type de connexion (HTTP/HTTPS) que l’agent d’enregistrement de session utilise pour se connecter au Broker d’enregistrement de session sur le serveur Director.

Installer l’agent d’enregistrement de session

Vous devez installer l’agent d’enregistrement de session sur la machine VDA ou VDI sur laquelle vous souhaitez enregistrer des sessions.

Étape 1 : Téléchargez le logiciel du produit et lancez l’assistant

Utilisez un compte administrateur local pour vous connecter à la machine sur laquelle vous installez le composant Agent d’enregistrement de session. Insérez le DVD dans le lecteur ou montez le fichier ISO. Si le programme d’installation ne se lance pas automatiquement, double-cliquez sur l’application AutoSelect ou sur le lecteur monté.

L’assistant d’installation se lance.

Étape 2 : Choisissez le produit à installer

image localisée

Cliquez sur Démarrer à côté du produit à installer : XenApp ou XenDesktop.

Étape 3 : Sélectionnez Enregistrement de session

image localisée

Sélectionnez l’entrée Enregistrement de session.

Étape 4 : Lisez et acceptez le contrat de licence

image localisée

Sur la page Contrat de licence logicielle, lisez le contrat de licence, acceptez-le, puis cliquez sur Suivant.

Étape 5 : Sélectionnez le composant à installer et l’emplacement d’installation

image localisée

Sélectionnez Agent d’enregistrement de session et cliquez sur Suivant.

Étape 6 : Spécifier la configuration de l’agent

image localisée

Sur la page Configuration de l’agent :

  • Si vous avez installé le serveur d’enregistrement de session à l’avance, 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 pour la connexion au serveur d’enregistrement de session. Si vous n’avez pas encore installé l’enregistrement de session, vous pouvez modifier ces informations ultérieurement dans les Propriétés de l’agent d’enregistrement de session.

Remarque : Il existe une limitation avec la fonction de test de connexion de l’installateur. Elle ne prend pas en charge le scénario « HTTPS requiert TLS 1.2 ». Si vous utilisez l’installateur dans ce scénario, le test de connexion échoue, mais vous pouvez ignorer l’échec et cliquer sur Suivant pour poursuivre l’installation. Cela n’affecte pas le fonctionnement normal.

Étape 7 : Vérifier les prérequis et confirmer l’installation

image localisée

La page Résumé affiche vos choix d’installation. Vous pouvez cliquer sur Précédent pour revenir aux pages précédentes de l’assistant et apporter des modifications. Ou, cliquez sur Installer pour démarrer l’installation.

Étape 8 : Terminer l’installation

image localisée

La page Fin de l’installation affiche des coches vertes pour tous les prérequis et composants qui ont été installés et initialisés avec succès.

Cliquez sur Terminer pour terminer l’installation de l’agent d’enregistrement de session.

Remarque : Lorsque Machine Creation Services (MCS) ou Provisioning Services (PVS) crée plusieurs VDA avec l’image principale configurée et Microsoft Message Queuing (MSMQ) installé, ces VDA peuvent avoir le même QMId dans certaines conditions. Cela peut entraîner divers problèmes, par exemple :

  • Les sessions peuvent ne pas être enregistrées même si l’accord d’enregistrement est accepté.
  • Le serveur d’enregistrement de session pourrait ne pas être en mesure de recevoir les signaux de fermeture de session et par conséquent, les sessions pourraient toujours être en statut En direct.

En guise de solution de contournement, créez un QMId unique pour chaque VDA, et il diffère selon les méthodes de déploiement.

Aucune action supplémentaire n’est requise si les VDA de système d’exploitation de bureau avec l’agent d’enregistrement de session installé sont créés avec PVS 7.7 ou version ultérieure et MCS 7.9 ou version ultérieure en mode bureau statique, c’est-à-dire, par exemple, configurés pour rendre toutes les modifications persistantes avec un vDisk personnel distinct ou le disque local de votre VDA.

Pour les VDA de système d’exploitation de serveur créés avec MCS ou PVS et les VDA de système d’exploitation de bureau configurés pour ignorer toutes les modifications lorsqu’un utilisateur se déconnecte, utilisez le script GenRandomQMID.ps1 pour modifier le QMId au démarrage du système. Modifiez la stratégie de gestion de l’alimentation pour vous assurer qu’un nombre suffisant de VDA sont en cours d’exécution avant les tentatives de connexion des utilisateurs.

Pour utiliser le script GenRandomQMID.ps1, procédez comme suit :

  1. Assurez-vous que la stratégie d’exécution est définie sur RemoteSigned ou Unrestricted dans PowerShell.

    Set-ExecutionPolicy RemoteSigned

  2. Créez une tâche planifiée, définissez le déclencheur sur le démarrage du système et exécutez-la avec le compte SYSTEM sur la machine d’image principale PVS ou MCS.

  3. Ajoutez la commande en tant que tâche de démarrage.

    powershell .exe -file C:\\GenRandomQMID.ps1

Résumé du script GenRandomQMID.ps1 :

  1. Supprimez le QMId actuel du registre.
  2. Ajoutez SysPrep = 1 à HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parameters.
  3. Arrêtez les services associés, y compris CitrixSmAudAgent et MSMQ.
  4. Pour générer un QMId aléatoire, démarrez les services qui ont été arrêtés précédemment.
# Remove old QMId from registry and set SysPrep flag for MSMQ
Remove-Itemproperty -Path HKLM:Software\Microsoft\MSMQ\Parameters\MachineCache -Name QMId -Force
Set-ItemProperty -Path HKLM:Software\Microsoft\MSMQ\Parameters -Name "SysPrep" -Type DWord -Value 1
# Get dependent services
\$depServices = Get-Service -name MSMQ -dependentservices | Select -Property Name
# Restart MSMQ to get a new QMId
Restart-Service -force MSMQ
# Start dependent services
if ($depServices -ne $null) {
    foreach ($depService in $depServices) {
        \$startMode = Get-WmiObject win32\_service -filter \"NAME = '\$\(\$depService.Name)'\" | Select -Property StartMode
        if ($startMode.StartMode -eq "Auto") {
            Start-Service $depService.Name
        }

}
}

Installer le lecteur d’enregistrement de session

Installez le lecteur d’enregistrement de session sur le serveur d’enregistrement de session ou sur une ou plusieurs stations de travail du domaine pour les utilisateurs qui consultent les enregistrements de session.

Étape 1 : Téléchargez le logiciel du produit et lancez l’assistant

Utilisez un compte administrateur local pour vous connecter à la machine où vous installez le composant Lecteur d’enregistrement de session. Insérez le DVD dans le lecteur ou montez le fichier ISO. Si le programme d’installation ne se lance pas automatiquement, double-cliquez sur l’application AutoSelect ou sur le lecteur monté.

L’assistant d’installation se lance.

Étape 2 : Choisissez le produit à installer

image localisée

Cliquez sur Démarrer à côté du produit à installer : XenApp ou XenDesktop.

Étape 3 : Sélectionnez Enregistrement de session

image localisée

Sélectionnez l’entrée Enregistrement de session.

Étape 4 : Lisez et acceptez le contrat de licence

image localisée

Sur la page Contrat de licence du logiciel, lisez le contrat de licence, acceptez-le, puis cliquez sur Suivant.

Étape 5 : Sélectionnez le composant à installer et l’emplacement d’installation

image localisée

Sélectionnez Session Recording Player et cliquez sur Suivant.

Étape 6 : Vérifier les prérequis et confirmer l’installation

image localisée

La page Résumé affiche vos choix d’installation. Vous pouvez cliquer sur Précédent pour revenir aux pages précédentes de l’assistant et apporter des modifications. Ou, cliquez sur Installer pour démarrer l’installation.

Étape 7 : Terminer l’installation

image localisée

La page Fin de l’installation affiche des coches vertes pour tous les prérequis et composants qui ont été installés et initialisés avec succès.

Cliquez sur Terminer pour finaliser l’installation du Session Recording Player.

Automatiser les installations

Pour installer le Session Recording Agent sur plusieurs serveurs, écrivez un script qui utilise l’installation silencieuse.

La ligne de commande suivante installe le Session Recording Agent et crée un fichier journal pour capturer les informations d’installation.

Pour les systèmes 64 bits :

msiexec /i SessionRecordingAgentx64.msi /q /l*vx votrejournaldinstallation SESSIONRECORDINGSERVERNAME=yourservername SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport

Remarque : Le fichier SessionRecordingAgentx64.msi dans l’ISO XenApp/XenDesktop se trouve sous \layout\image-full\x64\Session Recording.

Pour les systèmes 32 bits :

msiexec /i SessionRecordingAgent.msi /q /l*vx votrejournaldinstallation SESSIONRECORDINGSERVERNAME=votrenomserveur SESSIONRECORDINGBROKERPROTOCOL=votreprotocolebroker SESSIONRECORDINGBROKERPORT=votreportbroker

Remarque : Le fichier SessionRecordingAgent.msi dans l’ISO XenApp/XenDesktop se trouve sous \layout\image-full\x86\Session Recording.

où :

votrenomserveur est le nom NetBIOS ou le FQDN de l’ordinateur hébergeant le Session Recording Server. S’il n’est pas spécifié, cette valeur est par défaut localhost.

votreprotocolebroker est HTTP ou HTTPS que l’agent d’enregistrement de session utilise pour communiquer avec le broker d’enregistrement de session. S’il n’est pas spécifié, cette valeur est par défaut HTTPS.

votreportbroker est le numéro de port que l’agent d’enregistrement de session utilise pour communiquer avec le broker d’enregistrement de session. S’il n’est pas spécifié, cette valeur est par défaut zéro, ce qui indique à l’agent d’enregistrement de session d’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 la journalisation détaillée.

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

/q spécifie le mode silencieux.

Mettre à niveau Session Recording

Vous pouvez mettre à niveau certains déploiements vers des versions ultérieures sans avoir à configurer de nouvelles machines ou de nouveaux Sites. Vous pouvez effectuer une mise à niveau de Session Recording 7.6 (ou version ultérieure) vers la dernière version de Session Recording.

Remarques :

  • Lorsque vous mettez à niveau Session Recording Administration de la version 7.6 vers la version 7.13 ou ultérieure et que vous choisissez Modifier dans Session Recording Administration pour ajouter le service de journalisation d’administration, le nom de l’instance SQL Server n’apparaît pas sur la page Configuration de la journalisation d’administration. Le message d’erreur suivant apparaît lorsque vous cliquez sur Suivant : Database connection test failed. Please enter correct Database instance name. Pour contourner ce problème, ajoutez l’autorisation de lecture pour les utilisateurs localhost au dossier de registre SmartAuditor Server suivant : HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.
  • Les tentatives de mise à niveau de la base de données Session Recording peuvent échouer si vous n’avez que ce composant installé sur une machine. Dans ce cas, vérifiez si les entrées de registre suivantes existent sous HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\SmartAuditor\Database. Si ce n’est pas le cas, ajoutez manuellement les entrées avant la mise à niveau.
Nom de la clé Type de clé Valeur de la clé
SmAudDatabaseInstance Chaîne Le nom d’instance de votre base de données d’enregistrement de session
DatabaseName Chaîne Le nom de la base de données de votre base de données d’enregistrement de session

Exigences, préparation et limitations

Remarque : Vous ne pouvez pas effectuer de mise à niveau à partir d’une version Technology Preview.

  • Vous devez utiliser l’interface graphique ou l’interface de ligne de commande de l’installeur d’enregistrement de session pour mettre à niveau les composants d’enregistrement de session sur la machine où vous avez installé les composants.
  • Avant de commencer toute activité de mise à niveau, sauvegardez la base de données nommée CitrixSessionRecording dans l’instance SQL Server, afin de pouvoir la restaurer si des problèmes sont découverts après la mise à niveau de la base de données.
  • En plus d’être un utilisateur de domaine, vous devez être un administrateur local sur les machines où 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 pouvez
    • Demandez à l’administrateur de la base de données d’attribuer les autorisations de rôle de serveur securityadmin et dbcreator pour la mise à niveau. Une fois la mise à niveau terminée, les autorisations de rôle de serveur securityadmin et dbcreator ne sont plus nécessaires et peuvent être supprimées en toute sécurité.
    • Ou, utilisez le package SessionRecordingAdministrationx64.msi pour la mise à niveau. Pendant la mise à niveau msi, une boîte de dialogue demande 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, puis cliquez sur OK pour continuer la mise à niveau.
  • Si vous ne prévoyez 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 version ultérieure) peut fonctionner avec la dernière version (actuelle) du serveur d’enregistrement de session. Cependant, certaines nouvelles fonctionnalités et corrections de bogues pourraient ne pas prendre effet.
  • Toutes les sessions lancées pendant la mise à niveau du serveur d’enregistrement de session ne sont pas enregistrées.
  • L’option Ajustement graphique dans les propriétés de l’agent d’enregistrement de session est activée par défaut après une nouvelle installation ou une mise à niveau pour rester compatible avec le mode de redirection de composition de bureau. Vous pouvez désactiver cette option manuellement après une nouvelle installation ou une mise à niveau.
  • La fonctionnalité de 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 cette nouvelle fonctionnalité, modifiez l’installation après la mise à niveau.
  • S’il y a des sessions d’enregistrement en direct au début du processus de mise à niveau, il y a très peu de chances que l’enregistrement puisse être terminé.
  • Examinez la séquence de mise à niveau ci-dessous afin de pouvoir planifier et atténuer les pannes potentielles.

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 manuellement le service Session Recording Storage Manager sur le serveur d’enregistrement de session, puis mettez à niveau la base de données d’enregistrement de session en premier.
  2. Assurez-vous que le broker d’enregistrement de session est en cours d’exécution 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 sera également mise à niveau.
  3. Le service d’enregistrement de session est automatiquement remis en ligne une fois la mise à niveau du serveur d’enregistrement de session 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.

Remarque : L’erreur suivante peut se produire lors de la mise à niveau du composant d’administration de l’enregistrement de session sur Windows Server 2008 R2.

image localisée(/fr-fr/xenapp-and-xendesktop/7-15-ltsr/media/upgrading_error1.png)

Dans ce cas, modifiez la « .NET Framework version » de « SessionRecordingAppPool » en « .NET Framework v4 » dans IIS et effectuez la mise à niveau à nouveau.

image localisée(/fr-fr/xenapp-and-xendesktop/7-15-ltsr/media/upgrading_workaround.png)

Désinstaller Session Recording

Pour supprimer les composants de Session Recording d’un serveur ou d’une station de travail, utilisez l’option de désinstallation ou de suppression de programmes disponible dans le Panneau de configuration de Windows. Pour supprimer la base de données Session Recording, vous devez disposer des mêmes autorisations de rôle SQL Server securityadmin et dbcreator que lors de son installation.

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.

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