Installieren, Aktualisieren und Deinstallieren

Dieser Artikel enthält die folgenden Abschnitte:

• Installations-Checkliste

• Verwenden von Citrix-Skripts zur Installation der Windows-Rollen- und -Funktionsvoraussetzungen

• Installieren der Session Recording-Verwaltungskomponenten

  • Installieren der Session Recording-Datenbank

  • Installieren des Session Recording-Servers

• Installieren des Session Recording-Agenten

• Installieren des Session Recording Players und des Webplayers

• Installation automatisieren

• Session Recording aktualisieren

• Session Recording deinstallieren

Installations-Checkliste

Sie installieren die Session Recording-Komponenten mit den folgenden Dateien:

• Broker_PowerShellSnapIn_x64.msi

• SessionRecordingAdministrationx64.msi

• SessionRecordingAgentx64.msi

• SessionRecordingPlayer.msi

• SessionRecordingWebPlayer.msi

Bevor Sie mit der Installation beginnen, vervollständigen Sie diese Liste:

Hinweis:

• Wir empfehlen, die veröffentlichten Anwendungen basierend auf Ihren Aufzeichnungsrichtlinien in separate Bereitstellungsgruppen aufzuteilen. Die Sitzungsfreigabe für veröffentlichte Anwendungen kann mit der aktiven Richtlinie in Konflikt geraten, wenn sich die Anwendungen in derselben Bereitstellungsgruppe befinden. Session Recording gleicht die aktive Richtlinie mit der ersten veröffentlichten Anwendung ab, die ein Benutzer öffnet. Ab Version 7.18 können Sie die dynamische Sitzungsaufzeichnungsfunktion verwenden, um Aufzeichnungssitzungen jederzeit während der Sitzungen zu starten oder zu beenden. Diese Funktion kann dazu beitragen, das Konfliktproblem mit der aktiven Richtlinie zu entschärfen. Weitere Informationen finden Sie unter Dynamische Sitzungsaufzeichnung.
• Wenn Sie planen, Machine Creation Services™ (MCS) oder Provisioning Services zu verwenden, bereiten Sie eine eindeutige QMId vor. Die Nichteinhaltung kann zu Datenverlusten bei der Aufzeichnung führen.
• SQL Server erfordert, dass TCP/IP aktiviert ist, der SQL Server Browser-Dienst ausgeführt wird und die Windows-Authentifizierung verwendet wird.
• Um HTTPS zu verwenden, konfigurieren Sie Serverzertifikate für TLS/HTTPS.
• Stellen Sie sicher, dass Benutzer unter Local Users and Groups > Groups > Users Schreibberechtigungen für den Ordner C:\windows\Temp haben.

Verwenden Sie Citrix-Skripte, um die Voraussetzungen für Windows-Rollen und -Features zu installieren

Damit die Sitzungsaufzeichnung ordnungsgemäß funktioniert, verwenden Sie die folgenden Citrix-Skripte, um die erforderlichen Voraussetzungen für Windows-Rollen und -Features zu installieren, bevor Sie die Sitzungsaufzeichnung installieren:

• InstallPrereqsforSessionRecordingAdministration.ps1

   <#
   .Synopsis
       Installs Prereqs for Session Recording Administration
   .Description
       Supports Windows Server 2022, Windows Server 2019 and Windows Server 2016.
       Install below windows feature on this machine:
       -Application Development
       -Security - Windows Authentication
       -Management Tools - IIS 6 Management Compatibility
           IIS 6 Metabase Compatibility
           IIS 6 WMI Compatibility
           IIS 6 Scripting Tools
           IIS 6 Management Console
       -Microsoft Message Queuing (MSMQ), with Active Directory integration disabled, and MSMQ HTTP support enabled.
   #>
   function AddFeatures($featurename)
   {
       try
       {
           $feature=Get-WindowsFeature | ? {$_.DisplayName -eq $featurename -or $_.Name -eq $featurename}
           Add-WindowsFeature $feature
       }
       catch
       {
           Write-Host "Addition of Windows feature $featurename failed"
           Exit 1
       }
       Write-Host "Addition of Windows feature $featurename succeeded"
   }
  
   $system= gwmi win32_operatingSystem | select name
  
   if (-not (($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*') -or ($system -Like '*Microsoft Windows Server 2016*')))
   {
       Write-Host("This is not a supported server platform. Installation aborted.")
       Exit
   }
  
   # Start to install Windows feature
   Import-Module ServerManager
  
   AddFeatures('Web-Asp-Net45') #ASP.NET 4.5
   AddFeatures('Web-Mgmt-Console') #IIS Management Console
   AddFeatures('Web-Windows-Auth') # Windows Authentication
   AddFeatures('Web-Metabase') #IIS 6 Metabase Compatibility
   AddFeatures('Web-WMI') #IIS 6 WMI Compatibility
   AddFeatures('Web-Lgcy-Scripting')#IIS 6 Scripting Tools
   AddFeatures('Web-Lgcy-Mgmt-Console') #IIS 6 Management Console
   AddFeatures('MSMQ-HTTP-Support') #MSMQ HTTP Support
   AddFeatures('web-websockets') #IIS Web Sockets
   AddFeatures('NET-WCF-HTTP-Activation45') #http activate
   <!--NeedCopy-->
  

• InstallPrereqsforSessionRecordingAgent.ps1

   <#
   .Synopsis
       Installs Prereqs for Session Recording Agent
   .Description
       Supports  Windows Server 2022, Windows Server 2019, Windows Server 2016, and Windows 10.
       Install below windows feature on this machine:
       -Microsoft Message Queuing (MSMQ), with Active Directory integration disabled, and MSMQ HTTP support enabled.
   #>
   function AddFeatures($featurename)
   {
       try
       {
           $feature=Get-WindowsFeature | ? {$_.DisplayName -eq $featurename -or $_.Name -eq $featurename}
           Add-WindowsFeature $feature
       }
       catch
       {
           Write-Host "Addition of Windows feature $featurename failed"
           Exit 1
       }
       Write-Host "Addition of Windows feature $featurename succeeded"
   }
  
   # Start to install Windows feature
   $system= gwmi win32_operatingSystem | select name
  
   if (-not (($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows 10*')))
   {
       Write-Host("This is not a supported platform. Installation aborted.")
       Exit
   }
  
   if ($system -Like '*Microsoft Windows Server*')
   {
       Import-Module ServerManager
       AddFeatures('MSMQ') #Message Queuing
       AddFeatures('MSMQ-HTTP-Support')#MSMQ HTTP Support
   }
   else
   {
       try
       {
           dism /online /enable-feature /featurename:MSMQ-HTTP /all
       }
       catch
       {
           Write-Host "Addition of Windows feature MSMQ HTTP Support failed"
           Exit 1
       }
       write-Host "Addition of Windows feature MSMQ HTTP Support succeeded"
   }
   <!--NeedCopy-->
  

Um die Voraussetzungen für Windows-Rollen und -Features zu installieren, führen Sie die folgenden Schritte aus:

1. Auf dem Computer, auf dem Sie die Sitzungsaufzeichnungs-Verwaltungskomponenten installieren möchten:

   1. Stellen Sie sicher, dass die Ausführungsrichtlinie in PowerShell auf RemoteSigned oder Unrestricted festgelegt ist.

      Set-ExecutionPolicy RemoteSigned
      <!--NeedCopy-->
      

   2. Starten Sie eine Eingabeaufforderung als Administrator und führen Sie den Befehl powershell.exe -file InstallPrereqsforSessionRecordingAdministration.ps1 aus.

      Das Skript zeigt die erfolgreich hinzugefügten Features an und wird dann beendet.

   3. Nachdem das Skript ausgeführt wurde, stellen Sie sicher, dass die Ausführungsrichtlinie basierend auf Ihrer Unternehmensrichtlinie auf einen geeigneten Wert festgelegt ist.

2. Auf dem Computer, auf dem Sie die Sitzungsaufzeichnungs-Agent-Komponente installieren möchten:

   1. Stellen Sie sicher, dass die Ausführungsrichtlinie in PowerShell auf RemoteSigned oder Unrestricted festgelegt ist.

      Set-ExecutionPolicy RemoteSigned
      <!--NeedCopy-->
      

   2. Starten Sie eine Eingabeaufforderung als Administrator und führen Sie den Befehl powershell.exe -file InstallPrereqsforSessionRecordingAgent.ps1 aus.

      Das Skript zeigt die erfolgreich hinzugefügten Funktionen an und wird dann beendet.

   3. Nachdem das Skript ausgeführt wurde, stellen Sie sicher, dass die Ausführungsrichtlinie basierend auf der Unternehmensrichtlinie auf einen geeigneten Wert festgelegt ist.

Installieren Sie die Session Recording-Verwaltungskomponenten

Wir empfehlen, dass Sie die Komponenten Session Recording-Verwaltung, Session Recording-Agent und Session Recording-Player auf separaten Servern installieren.

Die Session Recording-Verwaltungskomponenten umfassen die Session Recording-Datenbank, den Session Recording-Server und die Session Recording-Richtlinienkonsole. Sie können die Komponente auswählen, die auf einem Server installiert werden soll.

1. Installieren Sie Broker_PowerShellSnapIn_x64.msi.

   Wichtig:

   Um die Session Recording-Richtlinienkonsole zu verwenden, muss das Broker PowerShell Snap-in (Broker_PowerShellSnapIn_x64.msi) installiert sein. Suchen Sie das Snap-in auf der Citrix Virtual Apps and Desktops-ISO (\layout\image-full\x64\Citrix Desktop Delivery Controller) und befolgen Sie die Anweisungen zur manuellen Installation. Die Nichteinhaltung kann zu einem Fehler führen.

2. Starten Sie die Windows-Eingabeaufforderung als Administrator, und führen Sie dann den Befehl msiexec /i SessionRecordingAdministrationx64.msi aus oder doppelklicken Sie auf die .msi-Datei.

3. Klicken Sie in der Installations-Benutzeroberfläche auf Weiter und akzeptieren Sie die Lizenzvereinbarung.

4. Wählen Sie auf dem Bildschirm Session Recording Administration Setup die Session Recording-Verwaltungskomponenten aus, die Sie installieren möchten.

   

   Hinweis:

   Die Installation aller Session Recording Administration components auf einem einzelnen Server ist für einen Machbarkeitsnachweis ausreichend. Für eine große Produktionsumgebung empfehlen wir jedoch, die Session Recording Policy Console auf einem separaten Server und den Session Recording Server, das Session Recording Administrator Logging sowie die Session Recording Database auf einem anderen separaten Server zu installieren. Das Session Recording Administrator Logging ist eine optionale Unterfunktion des Session Recording Server. Wählen Sie den Session Recording Server aus, bevor Sie das Session Recording Administrator Logging auswählen können.

Installieren der Session Recording Database

Hinweis:

• Die Session Recording Database ist keine eigentliche Datenbank. Sie ist eine Komponente, die für das Erstellen und Konfigurieren der erforderlichen Datenbanken in der Microsoft SQL Server-Instanz während der Installation zuständig ist. Session Recording unterstützt drei Lösungen für Datenbank-Hochverfügbarkeit auf Basis von Microsoft SQL Server. Weitere Informationen finden Sie unter Datenbank-Hochverfügbarkeit.

• Sie können die Session Recording Database auf Azure SQL Managed Instance, auf SQL Server on Azure Virtual Machines (VMs) und auf AWS RDS bereitstellen. Weitere Informationen finden Sie unter Bereitstellen der Session Recording Database auf Azure SQL Managed Instance oder auf AWS RDS und Bereitstellen der Session Recording Database auf SQL Server on Azure VMs.

Es gibt typischerweise drei Bereitstellungstypen für die Session Recording Database und Microsoft SQL Server:

• Bereitstellung 1: Installieren Sie den Session Recording Server und die Session Recording Database auf demselben Computer und den Microsoft SQL Server auf einem Remotecomputer. (Empfohlen)
• Bereitstellung 2: Installieren Sie den Session Recording Server, die Session Recording Database und Microsoft SQL Server auf demselben Computer.
• Bereitstellung 3: Installieren Sie den Session Recording Server auf einem Computer und sowohl die Session Recording Database als auch Microsoft SQL Server auf einem anderen Computer. (Nicht empfohlen)

1. Geben Sie auf der Seite Database and Server Configuration den Instanznamen und den Datenbanknamen der Session Recording Database sowie das Computerkonto des Session Recording Server an. Klicken Sie auf Next.

   • Instanzname: Wenn die Datenbankinstanz keine benannte Instanz ist, wie Sie sie beim Einrichten der Instanz konfiguriert haben, können Sie nur den Computernamen des SQL Servers verwenden. Wenn Sie die Instanz benannt haben, verwenden Sie computername\instanzname als Datenbankinstanznamen. Um den verwendeten Serverinstanznamen zu ermitteln, führen Sie select @@servername auf dem SQL Server aus. Der Rückgabewert ist der genaue Datenbankinstanzname. Wenn Ihr SQL Server so konfiguriert ist, dass er auf einem benutzerdefinierten Port (außer dem Standardport 1433) lauscht, legen Sie den benutzerdefinierten Listener-Port fest, indem Sie dem Instanznamen ein Komma anhängen. Geben Sie beispielsweise DXSBC-SRD-1,2433 in das Textfeld Instanzname ein, wobei 2433, nach dem Komma, den benutzerdefinierten Listener-Port bezeichnet.

   • Datenbankname: Geben Sie einen benutzerdefinierten Datenbanknamen in das Textfeld Datenbankname ein oder verwenden Sie den im Textfeld voreingestellten Standarddatenbanknamen. Klicken Sie auf Test connection, um die Konnektivität zur SQL Server-Instanz und die Gültigkeit des Datenbanknamens zu testen.

     Wichtig:

     Ein benutzerdefinierter Datenbankname darf nur A-Z, a-z, 0–9 und Unterstriche enthalten und darf 123 Zeichen nicht überschreiten.

     • Sie müssen über die Serverrollenberechtigungen securityadmin und dbcreator der Datenbank verfügen. Wenn Sie diese Berechtigungen nicht haben, können Sie:
       • Bitten Sie den Datenbankadministrator, die Berechtigungen für die Installation zuzuweisen. Nach Abschluss der Installation sind die Serverrollenberechtigungen securityadmin und dbcreator nicht mehr erforderlich und können sicher entfernt werden.
       • Oder während der MSI-Installation fordert ein Dialogfeld die Anmeldeinformationen eines Datenbankadministrators mit den Serverrollenberechtigungen securityadmin und dbcreator an. Geben Sie die korrekten Anmeldeinformationen ein und klicken Sie dann auf OK, um die Installation fortzusetzen.

       Die Installation erstellt die Session Recording-Datenbank und fügt das Computerkonto des Session Recording-Servers als db_owner hinzu.

   • Computerkonto des Session Recording-Servers:

     • Bereitstellungen 1 und 2: Geben Sie localhost in das Textfeld Computerkonto des Session Recording-Servers ein.

     • Bereitstellung 3: Geben Sie den Namen des Computers ein, auf dem der Session Recording-Server gehostet wird, im Format Domäne\Computername. Das Computerkonto des Session Recording-Servers ist das Benutzerkonto für den Zugriff auf die Session Recording-Datenbank.

     Hinweis:

     Versuche, die Session Recording-Verwaltungskomponenten zu installieren, können mit dem Fehlercode 1603 fehlschlagen, wenn ein Domänenname im Textfeld Computerkonto des Session Recording-Servers festgelegt ist. Als Problemumgehung geben Sie localhost oder NetBIOS-Domänenname\Computername in das Textfeld Computerkonto des Session Recording-Servers ein. Um den NetBIOS-Domänennamen zu erhalten, führen Sie $env:userdomain in PowerShell oder echo %UserDomain% in einer Eingabeaufforderung auf dem Computer aus, auf dem der Session Recording-Server installiert ist.

2. Befolgen Sie die Anweisungen, um die Installation abzuschließen.

Installieren des Session Recording-Servers

1. Wählen Sie Session Recording-Server und Session Recording-Administratorprotokollierung aus.

   Hinweis:

   • Die Session Recording-Administratorprotokollierung ist eine optionale Unterfunktion des Session Recording-Servers. Wählen Sie den Session Recording-Server aus, bevor Sie die Session Recording-Administratorprotokollierung auswählen können.
   • Wir empfehlen, die Session Recording-Administratorprotokollierung zusammen mit dem Session Recording-Server gleichzeitig zu installieren. Wenn Sie die Administratorprotokollierungsfunktion nicht aktivieren möchten, können Sie sie auf einer späteren Seite deaktivieren.

2. Geben Sie auf der Seite Datenbank- und Serverkonfiguration die Einstellungen an.

   • Instanzname: Geben Sie den Namen Ihres SQL Servers in das Textfeld Instanzname ein. Wenn Sie eine benannte Instanz verwenden, geben Sie Computername\Instanzname ein; andernfalls geben Sie nur den Computernamen ein. Wenn Ihr SQL-Server so konfiguriert ist, dass er auf einem benutzerdefinierten Port (außer dem Standardport 1433) lauscht, legen Sie den benutzerdefinierten Listener-Port fest, indem Sie dem Instanznamen ein Komma anhängen. Beispiel: Geben Sie DXSBC-SRD-1,2433 in das Textfeld Instanzname ein, wobei 2433, nach dem Komma, den benutzerdefinierten Listener-Port bezeichnet.
   • Datenbankname: Geben Sie einen benutzerdefinierten Datenbanknamen in das Textfeld Datenbankname ein oder verwenden Sie den Standarddatenbanknamen CitrixSessionRecording, der im Textfeld voreingestellt ist. Sie müssen über die Serverrollenberechtigungen securityadmin und dbcreator für die Datenbank verfügen. Wenn Sie die Berechtigungen nicht haben, können Sie:
     • Bitten Sie den Datenbankadministrator, die Berechtigungen für die Installation zuzuweisen. Nach Abschluss der Installation sind die Serverrollenberechtigungen securityadmin und dbcreator nicht mehr erforderlich und können sicher entfernt werden.
     • Oder, während der MSI-Installation, fordert ein Dialogfeld die Anmeldeinformationen eines Datenbankadministrators mit den Serverrollenberechtigungen securityadmin und dbcreator an. Geben Sie die korrekten Anmeldeinformationen ein und klicken Sie dann auf OK, um die Installation fortzusetzen.

   • Nachdem Sie den korrekten Instanznamen und Datenbanknamen eingegeben haben, klicken Sie auf Verbindung testen, um die Konnektivität zur Session Recording-Datenbank zu testen.

   • Geben Sie das Computerkonto des Session Recording-Servers ein und klicken Sie dann auf Weiter.

3. Auf der Seite Konfiguration der Administrationsprotokollierung geben Sie Konfigurationen für die Funktion Administrationsprotokollierung an.

   • Protokollierungsdatenbank ist auf der SQL Server-Instanz installiert: Dieses Textfeld ist nicht bearbeitbar. Der SQL Server-Instanzname der Administrationsprotokollierungsdatenbank wird automatisch aus dem Instanznamen übernommen, den Sie auf der Seite Datenbank- und Serverkonfiguration eingegeben haben.
   • Name der Protokollierungsdatenbank: Um die Funktion Session Recording-Administratorprotokollierung zu installieren, geben Sie einen benutzerdefinierten Datenbanknamen für die Administratorprotokollierungsdatenbank in dieses Textfeld ein oder verwenden Sie den Standarddatenbanknamen CitrixSessionRecordingLogging, der im Textfeld voreingestellt ist.

     Hinweis:

     Der Name der Administratorprotokollierungsdatenbank muss sich vom Namen der Session Recording-Datenbank unterscheiden, der im Textfeld Datenbankname auf der vorherigen Seite Datenbank- und Serverkonfiguration festgelegt ist.

   • Standarddatenbanknamen verwenden: Wenn Sie diese Option auswählen, wird der Standardname der Protokollierungsdatenbank verwendet.
   • Protokollierungsdienst aktivieren: Standardmäßig ist die Funktion Administrationsprotokollierung aktiviert. Sie können sie deaktivieren, indem Sie das Kontrollkästchen deaktivieren.
   • Obligatorische Blockierung aktivieren: Standardmäßig ist die obligatorische Blockierung aktiviert. Die normalen Funktionen können blockiert werden, wenn die Protokollierung fehlschlägt. Sie können die obligatorische Blockierung deaktivieren, indem Sie das Kontrollkästchen deaktivieren.

4. Klicken Sie auf Weiter und fahren Sie fort, um die Installation abzuschließen.

Hinweis:

Die Standardinstallation des Session Recording Servers verwendet HTTPS/TLS zur Sicherung der Kommunikation. Wenn TLS auf der Standard-Internetinformationsdienste (IIS)-Site des Session Recording Servers nicht konfiguriert ist, verwenden Sie HTTP. Deaktivieren Sie dazu die Auswahl von SSL in der IIS-Verwaltungskonsole, indem Sie zur Session Recording Broker-Site navigieren, die SSL-Einstellungen öffnen und das Kontrollkästchen Require SSL deaktivieren.

Installieren des Session Recording Agent

Installieren Sie den Session Recording Agent auf der VDA- oder VDI-Maschine, auf der Sie Sitzungen aufzeichnen möchten.

1. Auf der Seite Session Recording Agent Configuration: Wenn Sie den Session Recording Server bereits installiert haben, geben Sie den Computernamen der Maschine, auf der Sie den Session Recording Server installiert haben, sowie die Protokoll- und Portinformationen für die Verbindung zum Session Recording Server ein. Wenn Sie Session Recording noch nicht installiert haben, können Sie diese Informationen später in den Session Recording Agent Properties ändern.
2. Befolgen Sie die Anweisungen, um die Installation abzuschließen.

Hinweis:

Wenn Machine Creation Services (MCS) oder Provisioning Services (PVS) mehrere VDAs mit dem konfigurierten Masterimage und installiertem Microsoft Message Queuing (MSMQ) erstellen, können diese VDAs unter bestimmten Bedingungen dieselbe QMId haben. Dieser Fall kann verschiedene Probleme verursachen, zum Beispiel:

• Sitzungen werden möglicherweise nicht aufgezeichnet, selbst wenn die Aufzeichnungsvereinbarung akzeptiert wird.
• Der Sitzungsaufzeichnungsserver kann möglicherweise keine Abmeldesignale für Sitzungen empfangen, und daher bleiben Sitzungen möglicherweise immer im Live-Status.

Als Workaround erstellen Sie eine eindeutige QMId für jeden VDA, die je nach Bereitstellungsmethode unterschiedlich ist.

Es sind keine zusätzlichen Maßnahmen erforderlich, wenn Single-Session-OS-VDAs mit installiertem Session Recording Agent mit PVS 7.7 oder höher und MCS 7.9 oder höher im statischen Desktop-Modus erstellt werden, der beispielsweise so konfiguriert ist, dass alle Änderungen mit einer separaten Personal vDisk oder der lokalen Festplatte Ihres VDA persistent gemacht werden.

Für Multi-Session-OS-VDAs, die mit MCS oder PVS erstellt wurden, und Single-Session-OS-VDAs, die so konfiguriert sind, dass alle Änderungen beim Abmelden eines Benutzers verworfen werden, verwenden Sie das Skript GenRandomQMID.ps1, um die QMId beim Systemstart zu ändern. Ändern Sie die Energieverwaltungsstrategie, um sicherzustellen, dass genügend VDAs vor Benutzeranmeldeversuchen ausgeführt werden.

Um das Skript GenRandomQMID.ps1 zu verwenden, gehen Sie wie folgt vor:

1. Stellen Sie sicher, dass die Ausführungsrichtlinie in PowerShell auf RemoteSigned oder Unrestricted eingestellt ist.

Set-ExecutionPolicy RemoteSigned

2. Erstellen Sie eine geplante Aufgabe, legen Sie den Trigger auf Systemstart fest und führen Sie sie mit dem SYSTEM-Konto auf dem PVS- oder MCS-Masterimage-Computer aus.

3. Fügen Sie den Befehl als Startaufgabe hinzu.

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

Zusammenfassung des Skripts GenRandomQMID.ps1:

1. Entfernen Sie die aktuelle QMId aus der Registrierung.
2. Fügen Sie SysPrep = 1 zu HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parameters hinzu.
3. Beenden Sie zugehörige Dienste, einschließlich CitrixSmAudAgent und MSMQ.
4. Um eine zufällige QMId zu generieren, starten Sie die zuvor beendeten Dienste.

Beispiel GENRANDOMQMID.PS1:

# 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
        }
}

}
<!--NeedCopy-->

Installieren Sie den Session Recording Player und den Webplayer

Installieren Sie den Session Recording Player auf dem Session Recording Server oder auf Workstations in der Domäne. Installieren Sie den Webplayer nur auf dem Session Recording Server.

Doppelklicken Sie auf SessionRecordingPlayer.msi und SessionRecordingWebPlayer.msi und folgen Sie den Anweisungen, um die Installation abzuschließen.

Installation automatisieren

Session Recording unterstützt die unbeaufsichtigte Installation mit Optionen. Schreiben Sie ein Skript, das die unbeaufsichtigte Installation verwendet, und führen Sie die entsprechenden Befehle aus.

Installation der Session Recording Verwaltungskomponenten automatisieren

Installieren Sie den vollständigen Satz der Session Recording Verwaltungskomponenten mit einem einzigen Befehl

Beispielsweise installiert einer der folgenden Befehle den vollständigen Satz der Session Recording-Verwaltungskomponenten und erstellt eine Protokolldatei, um die Installationsinformationen zu erfassen.

msiexec /i "c:\SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="WNBIO-SRD-1" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" DATABASEUSER="localhost" /q /l*vx "yourinstallationlog"
<!--NeedCopy-->

msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log"
<!--NeedCopy-->

Hinweis:

Die Datei SessionRecordingAdministrationx64.msi befindet sich auf der Citrix Virtual Apps and Desktops-ISO unter \layout\image-full\x64\Session Recording.

Dabei gilt:

• ADDLOCAL bietet die Funktionen zur Auswahl. Sie können mehr als eine Option auswählen. SsRecServer ist der Session Recording-Server. PolicyConsole ist die Session Recording-Richtlinienkonsole. SsRecLogging ist die Administratorprotokollierungsfunktion. StorageDatabase ist die Session Recording-Datenbank. Die Session Recording-Administratorprotokollierung ist eine optionale Unterfunktion des Session Recording-Servers. Wählen Sie den Session Recording-Server aus, bevor Sie die Session Recording-Administratorprotokollierung auswählen können.
• DATABASEINSTANCE ist der Instanzname der Session Recording-Datenbank. Zum Beispiel .\SQLEXPRESS,computer-name\SQLEXPRESS,computer-name oder tcp:srt-sql-support.public.ca7b16b60789.database.windows.net,3342, wenn Sie Azure SQL Managed Instance verwenden.
• DATABASENAME ist der Datenbankname der Session Recording-Datenbank.
• LOGGINGDATABASENAME ist der Name der Administratorprotokollierungsdatenbank.
• AZURESQLSERVICESUPPORT bestimmt, ob Cloud SQL unterstützt wird. Um Cloud SQL zu verwenden, setzen Sie es auf 1.
• DATABASEUSER ist das Computerkonto des Session Recording-Servers.
• AZUREUSERNAME ist der Cloud SQL-Administratorname.
• AZUREPASSWORD ist das Cloud SQL-Administratorpasswort.
• /q gibt den unbeaufsichtigten Modus an.
• /l*v gibt die ausführliche Protokollierung an.
• yourinstallationlog ist der Speicherort Ihrer Installationsprotokolldatei.

Ein Masterimage für die Bereitstellung des Session Recording Servers erstellen

Möglicherweise verfügen Sie bereits über die Session Recording-Datenbank und die Administrationsprotokollierungsdatenbank aus einer vorhandenen Bereitstellung. In solchen Szenarien können Sie jetzt auf Datenbankprüfungen verzichten, wenn Sie die Session Recording-Verwaltungskomponenten mit SessionRecordingAdministrationx64.msi installieren. Sie können einfach ein Masterimage für die Bereitstellung des Session Recording Servers auf vielen anderen Maschinen erstellen. Nach der Bereitstellung des Servers auf Zielmaschinen mit dem Masterimage führen Sie auf jeder Maschine einen Befehl aus, um eine Verbindung zur vorhandenen Session Recording-Datenbank und Administrationsprotokollierungsdatenbank herzustellen. Diese Masterimage-Unterstützung erleichtert die Bereitstellung und minimiert die potenziellen Auswirkungen menschlicher Fehler. Sie gilt nur für Neuinstallationen und umfasst die folgenden Schritte:

1. Starten Sie eine Eingabeaufforderung und führen Sie einen Befehl ähnlich dem folgenden aus:

   msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="sqlnotexists" DATABASENAME="CitrixSessionRecording2" LOGGINGDATABASENAME="CitrixSessionRecordingLogging2" DATABASEUSER="localhost" /q /l*vx "c:\WithLogging.log" IGNOREDBCHECK="True"
   <!--NeedCopy-->
   

   Dieser Befehl installiert die Session Recording-Verwaltungskomponenten, ohne die Konnektivität zur Session Recording-Datenbank und zur Administrationsprotokollierungsdatenbank zu konfigurieren und zu testen.

   Setzen Sie den Parameter IGNOREDBCHECK auf True und verwenden Sie zufällige Werte für DATABASEINSTANCE, DATABASENAME und LOGGINGDATABASENAME.

2. Erstellen Sie ein Masterimage auf der Maschine, die Sie bedienen.

3. Stellen Sie das Masterimage auf anderen Maschinen zur Bereitstellung des Session Recording Servers bereit.

4. Führen Sie auf jeder der Maschinen Befehle ähnlich den folgenden aus:

   .\SsRecUtils.exe -modifydbconnectionpara DATABASEINSTANCE DATABASENAME LOGGINGDATABASENAME
   
   iisreset /noforce
   <!--NeedCopy-->
   

   Die Befehle verbinden den zuvor installierten Session Recording Server mit einer vorhandenen Session Recording-Datenbank und Administrationsprotokollierungsdatenbank.

   Die Datei SsRecUtils.exe befindet sich in \Citrix\SessionRecording\Server\bin\. Legen Sie die Parameter DATABASEINSTANCE, DATABASENAME und LOGGINGDATABASENAME nach Bedarf fest.

Datenbanken beim Deinstallieren der Session Recording-Verwaltungskomponenten beibehalten

Wenn KEEPDB auf True gesetzt ist, behält der folgende Befehl die Session Recording-Datenbank und die Administrationsprotokollierungsdatenbank beim Deinstallieren der Session Recording-Verwaltungskomponenten bei:

msiexec /x "SessionRecordingAdministrationx64.msi" KEEPDB="True"
<!--NeedCopy-->

Installation des Session Recording Players und Webplayers automatisieren

Zum Beispiel installieren die folgenden Befehle den Session Recording Player bzw. den Webplayer.

msiexec /i "c:\SessionRecordingPlayer.msi" /q /l*\vx "yourinstallationlog"
<!--NeedCopy-->

msiexec /i "c:\SessionRecordingWebPlayer.msi" /q /l*vx "yourinstallationlog"
<!--NeedCopy-->

Hinweis:

Die Datei SessionRecordingPlayer.msi befindet sich auf der Citrix Virtual Apps and Desktops ISO unter \layout\image-full\x86\Session Recording.

Die Datei SessionRecordingWebPlayer.msi befindet sich auf der Citrix Virtual Apps and Desktops ISO unter \layout\image-full\x64\Session Recording.

Dabei gilt:

• /q gibt den stillen Modus an.
• /l*v gibt die ausführliche Protokollierung an.
• yourinstallationlog ist der Speicherort Ihrer Installationsprotokolldatei.

Automatisierte Installation des Session Recording Agent

Zum Beispiel installiert der folgende Befehl den Session Recording Agent und erstellt eine Protokolldatei, um die Installationsinformationen zu erfassen.

Für 64-Bit-Systeme:

msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->

Hinweis:

Die Datei SessionRecordingAgentx64.msi befindet sich auf der Citrix Virtual Apps and Desktops ISO unter \layout\image-full\x64\Session Recording.

Für 32-Bit-Systeme:

msiexec /i SessionRecordingAgent.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->

Hinweis:

Die Datei SessionRecordingAgent.msi befindet sich auf der Citrix Virtual Apps and Desktops ISO unter \layout\image-full\x86\Session Recording.

Dabei gilt:

• yourservername ist der NetBIOS-Name oder FQDN des Computers, auf dem der Session Recording Server gehostet wird. Wenn nicht angegeben, ist der Standardwert localhost.
• yourbrokerprotocol ist HTTP oder HTTPS, das der Session Recording Agent für die Kommunikation mit dem Session Recording Broker verwendet. Wenn nicht angegeben, ist der Standardwert HTTPS.
• yourbrokerport ist die Portnummer, die der Session Recording Agent für die Kommunikation mit dem Session Recording Broker verwendet. Wenn nicht angegeben, ist der Standardwert Null, wodurch der Session Recording Agent angewiesen wird, die Standardportnummer für das ausgewählte Protokoll zu verwenden: 80 für HTTP oder 443 für HTTPS.
• /q gibt den stillen Modus an.
• /l*v gibt die ausführliche Protokollierung an.
• yourinstallationlog ist der Speicherort Ihrer Installationsprotokolldatei.

Upgrade von Session Recording

Sie können bestimmte Bereitstellungen auf neuere Versionen aktualisieren, ohne zuvor neue Maschinen oder Sites einrichten zu müssen. Sie können vom neuesten CU von Session Recording 7.15 LTSR und von jeder späteren Version auf die neueste Version von Session Recording aktualisieren.

Hinweis:

Wenn Sie Session Recording Administration von 7.6 auf 7.13 oder höher aktualisieren und in Session Recording Administration die Option Ändern wählen, um den Administrator-Protokollierungsdienst hinzuzufügen, wird der SQL Server-Instanzname auf der Seite Administrator-Protokollierungskonfiguration nicht angezeigt. Die folgende Fehlermeldung wird angezeigt, wenn Sie auf Weiter klicken: Datenbankverbindungstest fehlgeschlagen. Bitte geben Sie den korrekten Datenbankinstanznamen ein. Als Problemumgehung fügen Sie die Leseberechtigung für localhost-Benutzer zum folgenden SmartAuditor Server-Registrierungsordner hinzu: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.

Ein Upgrade von einer Technical Preview-Version ist nicht möglich.

Anforderungen, Vorbereitung und Einschränkungen

• Verwenden Sie die grafische oder Befehlszeilenschnittstelle des Session Recording-Installationsprogramms, um die Session Recording-Komponenten auf dem Computer zu aktualisieren, auf dem Sie die Komponenten installiert haben.
• Sichern Sie vor jeder Upgrade-Aktivität die Datenbank namens CitrixSessionRecording in der SQL Server-Instanz. Auf diese Weise können Sie sie wiederherstellen, falls nach dem Datenbank-Upgrade Probleme auftreten.
• Sie müssen nicht nur ein Domänenbenutzer, sondern auch ein lokaler Administrator auf den Computern sein, auf denen Sie die Session Recording-Komponenten aktualisieren.
• Wenn der Session Recording Server und die Session Recording-Datenbank nicht auf demselben Server installiert sind, müssen Sie über die Datenbankrollenberechtigung verfügen, um die Session Recording-Datenbank zu aktualisieren. Andernfalls können Sie:
  • Bitten Sie den Datenbankadministrator, die Serverrollenberechtigungen securityadmin und dbcreator für das Upgrade zuzuweisen. Nachdem das Upgrade abgeschlossen ist, sind die Serverrollenberechtigungen securityadmin und dbcreator nicht mehr erforderlich und können sicher entfernt werden.
  • Oder verwenden Sie die Datei SessionRecordingAdministrationx64.msi für das Upgrade. Während des MSI-Upgrades fordert ein Dialogfeld die Anmeldeinformationen eines Datenbankadministrators an, der über die Serverrollenberechtigungen securityadmin und dbcreator verfügt. Geben Sie die korrekten Anmeldeinformationen ein und klicken Sie dann auf OK, um das Upgrade fortzusetzen.
• Wenn Sie nicht planen, alle Session Recording Agents gleichzeitig zu aktualisieren, ist Session Recording Agent 7.6.0 (und höher) mit der neuesten (aktuellen) Version des Session Recording Servers kompatibel. Einige neue Funktionen und Fehlerbehebungen werden jedoch möglicherweise nicht wirksam.
• Alle Sitzungen, die während des Upgrades des Session Recording Servers gestartet werden, werden nicht aufgezeichnet.
• Die Option Grafikanpassung in den Session Recording Agent-Eigenschaften ist nach einer Neuinstallation oder einem Upgrade standardmäßig aktiviert, um mit dem Desktop Composition Redirection-Modus kompatibel zu bleiben. Sie können diese Option nach einer Neuinstallation oder einem Upgrade manuell deaktivieren.
• Die Administratorprotokollierungsfunktion wird nicht installiert, nachdem Sie Session Recording von einer früheren Version aktualisiert haben, in der die Funktion nicht verfügbar ist. Um die Funktion hinzuzufügen, ändern Sie die Installation nach dem Upgrade.
• Wenn Live-Aufzeichnungssitzungen vorhanden sind, wenn der Upgrade-Prozess beginnt, ist die Wahrscheinlichkeit gering, dass die Aufzeichnung abgeschlossen werden kann.
• Überprüfen Sie die folgende Upgradereihenfolge, damit Sie potenzielle Ausfälle planen und mindern können.

Upgradereihenfolge

1. Wenn die Session Recording-Datenbank und der Session Recording Server auf verschiedenen Servern installiert sind, beenden Sie den Session Recording Storage Manager-Dienst manuell auf dem Session Recording Server. Aktualisieren Sie dann zuerst die Session Recording-Datenbank.
2. Stellen Sie über den Internet Information Services (IIS) Manager sicher, dass der Session Recording Broker ausgeführt wird. Aktualisieren Sie den Session Recording Server. Wenn die Session Recording-Datenbank und der Session Recording Server auf demselben Server installiert sind, wird auch die Session Recording-Datenbank aktualisiert.
3. Der Session Recording-Dienst ist automatisch wieder online, wenn das Upgrade des Session Recording Servers abgeschlossen ist.
4. Aktualisieren Sie den Session Recording Agent (auf dem Masterimage).
5. Aktualisieren Sie die Session Recording Policy Console mit oder nach dem Session Recording Server.
6. Aktualisieren Sie den Session Recording Player.

Bereitstellen der Session Recording-Datenbank auf Cloud-SQL-Datenbankdiensten

Dieser Abschnitt beschreibt, wie die Session Recording-Datenbank auf Azure SQL Managed Instance, auf AWS RDS und auf SQL Server auf Azure-VMs bereitgestellt wird.

Bereitstellen der Session Recording-Datenbank auf Azure SQL Managed Instance oder auf AWS RDS

Tipp:

Sie können auch einen einzelnen Befehl ähnlich dem folgenden ausführen, um die Session Recording-Datenbank auf Azure SQL Managed Instance oder auf AWS RDS bereitzustellen. Weitere Informationen finden Sie im vorhergehenden Abschnitt Installation automatisieren in diesem Artikel.

msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log"
<!--NeedCopy-->

1. Erstellen Sie eine Azure SQL Managed Instance oder eine SQL Server-Instanz über die Amazon RDS-Konsole.

2. (Nur für Azure SQL) Notieren Sie sich die Server-Zeichenfolgen, die im Eigenschaftenbereich angezeigt werden. Die Zeichenfolgen sind der Instanzname der Session Recording-Datenbank. Ein Beispiel finden Sie im folgenden Screenshot.

   

3. (Nur für AWS RDS) Notieren Sie sich die Informationen zu Endpunkt und Port. Wir verwenden sie als Instanznamen Ihrer Datenbank im Format <Endpunkt, Port>.

   

4. Führen Sie SessionRecordingAdministrationx64.msi aus, um die Session Recording-Datenbank zu installieren.

   Aktivieren Sie das Kontrollkästchen Cloud-SQL aktivieren und geben Sie den Cloud-SQL-Administratornamen und das Kennwort ein. Nehmen Sie weitere erforderliche Konfigurationen vor.

   

   Hinweis: Wenn Sie das Cloud-SQL-Administratorkennwort ändern, müssen Sie das Kennwort in den Session Recording Server Properties aktualisieren. Wenn Sie die Session Recording Server Properties öffnen, wird eine Fehlermeldung angezeigt. Klicken Sie auf OK, um fortzufahren, wählen Sie die Registerkarte Cloud-DB aus und geben Sie das neue Cloud-SQL-Administratorkennwort ein. Starten Sie den Citrix Session Recording Analytics-Dienst, den Citrix Session Recording Storage Manager-Dienst und den IIS-Dienst neu.

   Cloud SQL-Administratorpasswort aktualisieren(/de-de/session-recording/2107/media/updating-cloud-sql-admin-password.png)

Eine lokale Datenbank zu einer Cloud SQL Managed Instance migrieren

1. Migrieren Sie Ihre lokale Datenbank gemäß https://docs.microsoft.com/de-de/data-migration/ oder https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/migrate-an-on-premises-microsoft-sql-server-database-to-amazon-rds-for-sql-server.html.

2. Damit Session Recording nach der Migration ordnungsgemäß funktioniert, führen Sie SsRecUtils.exe auf dem Session Recording-Server aus.

   C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifyazuredbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} {AzureAdminName}{AzureAdminPassword} iisreset /noforce

3. Starten Sie auf dem Session Recording-Server den Citrix Session Recording Analytics-Dienst, den Citrix Session Recording Storage Manager-Dienst und den IIS-Dienst neu.

Eine Produktionsdatenbank von einer Azure SQL Managed Instance zu einer lokalen Datenbank migrieren

1. Migrieren Sie die Datenbank gemäß https://docs.microsoft.com/de-de/data-migration/.

2. Damit Session Recording nach der Migration ordnungsgemäß funktioniert, führen Sie SsRecUtils.exe auf dem Session Recording-Server aus.

   C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifydbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} iisreset /noforce

3. Starten Sie auf dem Session Recording-Server den Citrix Session Recording Analytics-Dienst, den Citrix Session Recording Storage Manager-Dienst und den IIS-Dienst neu.

Die Session Recording-Datenbank auf SQL Server auf Azure-VMs bereitstellen

Auf SQL Server auf Azure-VMs können Sie die Session Recording-Datenbank bereitstellen.

1. Stellen Sie eine Azure SQL-VM bereit.
2. Konfigurieren Sie die VM und fügen Sie sie der Domäne hinzu, in der Sie die Session Recording-Komponenten installieren.
3. Verwenden Sie den FQDN der VM als Instanznamen während der Installation der Session Recording-Datenbank. Hinweis: Wenn Sie SessionRecordingAdministrationx64.msi für die Installation verwenden, deaktivieren Sie das Kontrollkästchen Enable cloud SQL.
4. Befolgen Sie die Anweisungen, um die Installation abzuschließen.

Deinstallation von Session Recording

Um die Session Recording-Komponenten von einem Server oder einer Workstation zu entfernen, verwenden Sie die Option zum Deinstallieren oder Entfernen von Programmen in der Windows-Systemsteuerung. Um die Session Recording-Datenbank zu entfernen, müssen Sie dieselben SQL Server-Rollenberechtigungen als securityadmin und dbcreator besitzen wie bei der Installation.

Aus Sicherheitsgründen wird die Administrator-Protokollierungsdatenbank nach der Deinstallation der Komponenten nicht entfernt.