Installieren, Aktualisieren und Deinstallieren

Dieser Artikel enthält die folgenden Abschnitte:

• Installations-Checkliste

• Citrix-Skripte zur Installation der Windows-Rollen und -Funktionsvoraussetzungen verwenden

• 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 mithilfe der 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, den Konflikt mit der aktiven Richtlinie zu entschärfen. Weitere Informationen finden Sie unter Dynamische Sitzungsaufzeichnung.
• Wenn Sie Machine Creation Services™ (MCS) oder Provisioning Services verwenden möchten, 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 Schreibberechtigung für den Ordner C:\windows\Temp haben.

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

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

• InstallPrereqsforSessionRecordingAdministration.ps1

   <#
   .Synopsis
       Installs Prereqs for Session Recording Administration
   .Description
       Supports Windows Server 2012 R2, Windows Server 2016, Windows Server 2019.
       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 2012 R2*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows Server 2019*')))
   {
       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 2012 R2, Windows Server 2016,  Windows Server 2019, Windows 7, Windows 8, Windows 8.1 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 2012 R2*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows Server 2019*')-or ($system -Like '*Microsoft Windows 7*')-or ($system -Like '*Microsoft Windows 8*')-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
       {
           if($system -Like '*Microsoft Windows 7*')
           {
               dism /online /enable-feature /featurename:IIS-WebServerRole /featurename:IIS-WebServer /featurename:IIS-IIS6ManagementCompatibility /featurename:IIS-Metabase /featurename:IIS-ManagementConsole /featurename:IIS-ApplicationDevelopment /featurename:IIS-NetFxExtensibility /featurename:IIS-ISAPIExtensions /featurename:IIS-CommonHttpFeatures /featurename:IIS-DefaultDocument /featurename:IIS-DirectoryBrowsing /featurename:IIS-HttpErrors /featurename:IIS-HttpRedirect /featurename:IIS-StaticContent /featurename:IIS-HealthAndDiagnostics /featurename:IIS-RequestMonitor /featurename:IIS-Performance /featurename:IIS-HttpCompressionStatic /featurename:IIS-Security /featurename:IIS-RequestFiltering /featurename:IIS-LoggingLibraries /featurename:IIS-HttpTracing
               dism /online /enable-feature /featurename:MSMQ-Container
               dism /online /enable-feature /featurename:MSMQ-Server
               dism /online /enable-feature /featurename:MSMQ-HTTP
           }
           else
           {
               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-->
  

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

1. Auf dem Computer, auf dem Sie die Verwaltungskomponenten von Session Recording 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. Stellen Sie nach dem Ausführen des Skripts sicher, dass die Ausführungsrichtlinie gemäß Ihrer Unternehmensrichtlinie auf einen geeigneten Wert eingestellt ist.

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

   1. Stellen Sie sicher, dass die Ausführungsrichtlinie in PowerShell auf RemoteSigned oder Unrestricted eingestellt 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 eingestellt ist.

Installieren der Session Recording Verwaltungskomponenten

Wir empfehlen, dass Sie die Komponenten Session Recording Administration, 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-Verwaltungskomponenten auf einem einzelnen Server ist für einen Machbarkeitsnachweis in Ordnung. Für eine große Produktionsumgebung empfehlen wir jedoch, die Session Recording-Richtlinienkonsole auf einem separaten Server und den Session Recording-Server, die Session Recording-Administratorprotokollierung und die Session Recording-Datenbank auf einem weiteren separaten Server zu installieren. 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.

Installieren der Session Recording-Datenbank

Hinweis:

• Die Session Recording-Datenbank 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 basierend auf Microsoft SQL Server. Weitere Informationen finden Sie unter Datenbank-Hochverfügbarkeit.

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

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

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

1. Auf der Seite Datenbank- und Serverkonfiguration geben Sie den Instanznamen und den Datenbanknamen der Session Recording-Datenbank sowie das Computerkonto des Session Recording-Servers an. Klicken Sie auf Weiter.

   • 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 computer-name\instance-name 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 angibt.

   • Datenbankname: Geben Sie einen benutzerdefinierten Datenbanknamen in das Textfeld Datenbankname ein oder verwenden Sie den voreingestellten Standarddatenbanknamen im Textfeld. Klicken Sie auf Verbindung testen, 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 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.
       • Alternativ fordert ein Dialogfeld während der msi-Installation 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 Database 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, auf dem der Session Recording Server gehostet wird, im Format domain\computer-name ein. Das Computerkonto des Session Recording Servers ist das Benutzerkonto für den Zugriff auf die Session Recording Database.

     Hinweis:

     Versuche, die Session Recording Administration components 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 den NetBIOS-Domänennamen\Maschinennamen 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 Administrator Logging aus.

   Hinweis:

   • Das Session Recording Administrator Logging ist eine optionale Unterfunktion des Session Recording Servers. Wählen Sie den Session Recording Server aus, bevor Sie das Session Recording Administrator Logging auswählen können.
   • Wir empfehlen, das Session Recording Administrator Logging gleichzeitig mit dem Session Recording Server zu installieren. Wenn Sie die Administrator Logging-Funktion 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 Computername 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. 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 Standarddatenbanknamen CitrixSessionRecording, der im Textfeld voreingestellt ist. Sie müssen über die Serverrollenberechtigungen securityadmin und dbcreator für die 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.

   • 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 die Konfigurationen für die Administrationsprotokollierungsfunktion an.

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

     Hinweis:

     Der Name der Administrationsprotokollierungsdatenbank muss sich von dem Namen der Session Recording-Datenbank unterscheiden, der im Textfeld Datenbankname auf der vorherigen Seite Datenbank- und Serverkonfiguration festgelegt wurde.

   • Standarddatenbanknamen verwenden: Wenn Sie diese Option auswählen, wird der Standardname der Protokollierungsdatenbank verwendet.
   • Protokollierungsdienst aktivieren: Standardmäßig ist die Administrationsprotokollierungsfunktion 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-Internet Information Services (IIS)-Site des Session Recording Servers nicht konfiguriert ist, verwenden Sie HTTP. Heben Sie dazu die Auswahl von SSL in der IIS-Verwaltungskonsole auf, indem Sie zur Session Recording Broker-Site navigieren, die SSL-Einstellungen öffnen und das Kontrollkästchen Require SSL deaktivieren.

Installieren Sie den 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-Konfiguration: Wenn Sie den Session Recording Server bereits installiert haben, geben Sie den Computernamen des Computers ein, auf dem Sie den Session Recording Server installiert haben, sowie die Protokoll- und Portinformationen für die Verbindung zum Session Recording Server. Wenn Sie Session Recording noch nicht installiert haben, können Sie diese Informationen später in den Session Recording Agent-Eigenschaften ä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. Dies kann verschiedene Probleme verursachen, zum Beispiel:

• Sitzungen werden möglicherweise nicht aufgezeichnet, selbst wenn die Aufzeichnungsvereinbarung akzeptiert wurde.
• Der Session Recording Server kann möglicherweise keine Abmeldesignale für Sitzungen empfangen, und daher können Sitzungen immer den Status “Live” haben.

Erstellen Sie als Problemumgehung eine eindeutige QMId für jeden VDA; diese unterscheidet sich je nach Bereitstellungsmethode.

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 Desktopmodus 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 der PVS- oder MCS-Masterimage-Maschine aus.

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

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

Zusammenfassung des GenRandomQMID.ps1-Skripts:

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 die zugehörigen 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 des Session Recording Players und des Webplayers

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

Zum Beispiel installiert einer der folgenden Befehle den vollständigen Satz der Sitzungsaufzeichnungs-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.

Wobei:

• ADDLOCAL bietet die Funktionen zur Auswahl. Sie können mehrere Optionen auswählen. SsRecServer ist der Sitzungsaufzeichnungsserver. PolicyConsole ist die Sitzungsaufzeichnungs-Richtlinienkonsole. SsRecLogging ist die Administratorprotokollierungsfunktion. StorageDatabase ist die Sitzungsaufzeichnungsdatenbank. Die Sitzungsaufzeichnungs-Administratorprotokollierung ist eine optionale Unterfunktion des Sitzungsaufzeichnungsservers. Wählen Sie den Sitzungsaufzeichnungsserver aus, bevor Sie die Sitzungsaufzeichnungs-Administratorprotokollierung auswählen können.
• DATABASEINSTANCE ist der Instanzname der Sitzungsaufzeichnungsdatenbank. 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 Sitzungsaufzeichnungsdatenbank.
• 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 Sitzungsaufzeichnungsservers.
• AZUREUSERNAME ist der Cloud SQL-Administratorname.
• AZUREPASSWORD ist das Cloud SQL-Administratorpasswort.
• /q gibt den stillen Modus an.
• /l*v gibt die ausführliche Protokollierung an.
• yourinstallationlog ist der Speicherort Ihrer Installationsprotokolldatei.

Ein Master-Image zur Bereitstellung des Session Recording Servers erstellen

Möglicherweise verfügen Sie bereits über die Session Recording-Datenbank und die Administrationsprotokollierungsdatenbank aus einer bestehenden 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 Master-Image zur Bereitstellung des Session Recording Servers auf vielen anderen Maschinen erstellen. Nachdem Sie den Server auf Zielmaschinen mit dem Master-Image bereitgestellt haben, führen Sie auf jeder Maschine einen Befehl aus, um eine Verbindung zur vorhandenen Session Recording-Datenbank und Administrationsprotokollierungsdatenbank herzustellen. Diese Master-Image-Unterstützung erleichtert die Bereitstellung und minimiert die potenziellen Auswirkungen menschlicher Fehler. Sie gilt nur für Neuinstallationen und umfasst die folgenden Schritte:

1. Öffnen 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 Master-Image auf der Maschine, die Sie bedienen.

3. Stellen Sie das Master-Image 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 SsRecUtils.exe-Datei 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 des 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 SessionRecordingPlayer.msi Datei befindet sich auf der Citrix Virtual Apps and Desktops ISO unter \layout\image-full\x86\Session Recording.

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

Wobei:

• /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 SessionRecordingAgentx64.msi Datei 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 SessionRecordingAgent.msi Datei befindet sich auf der Citrix Virtual Apps and Desktops ISO unter \layout\image-full\x86\Session Recording.

Wobei:

• yourservername ist der NetBIOS-Name oder FQDN des Computers, auf dem der Session Recording Server gehostet wird. Wenn nicht angegeben, ist dieser Wert standardmäßig 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 dieser Wert standardmäßig HTTPS.
• yourbrokerport ist die Portnummer, die der Session Recording Agent für die Kommunikation mit dem Session Recording Broker verwendet. Wenn nicht angegeben, ist dieser Wert standardmäßig Null, wodurch der Session Recording Agent angewiesen wird, die Standardportnummer für Ihr ausgewähltes 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.

Session Recording aktualisieren

Sie können bestimmte Bereitstellungen auf spätere 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:

When you upgrade Session Recording Administration from 7.6 to 7.13 or later and choose Modify in Session Recording Administration to add the Administrator Logging service, the SQL Server instance name does not appear on the Administrator Logging Configuration page. The following error message appears when you click Next: Database connection test failed. Please enter correct Database instance name. As a workaround, add the read permission for localhost users to the following SmartAuditor Server registry folder: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.

Sie können nicht von einer Technical Preview-Version aktualisieren.

Anforderungen, Vorbereitung und Einschränkungen

• Use the Session Recording installer’s graphical or command line interface to upgrade the Session Recording components on the machine where you installed the components.
• 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 sein, sondern auch ein lokaler Administrator auf den Maschinen, 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. Nach Abschluss des Upgrades 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.
• 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 die Kompatibilität mit dem Desktop Composition Redirection-Modus zu gewährleisten. Sie können diese Option nach einer Neuinstallation oder einem Upgrade manuell deaktivieren.
• Die Administratorprotokollierungsfunktion wird nach dem Upgrade von Session Recording aus einer früheren Version, in der die Funktion nicht verfügbar war, nicht installiert. Um die Funktion hinzuzufügen, ändern Sie die Installation nach dem Upgrade.
• Wenn zum Zeitpunkt des Starts des Upgrade-Vorgangs Live-Aufzeichnungssitzungen vorhanden sind, 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 Sie die Session Recording-Datenbank auf Azure SQL Managed Instance, auf AWS RDS und auf SQL Server auf Azure-VMs bereitstellen.

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 Automatisierte Installation 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-Eigenschaften aktualisieren. Wenn Sie die Session Recording Server-Eigenschaften ö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.

   Aktualisieren Sie das Cloud SQL-Administratorpasswort(/de-de/session-recording/2104/media/updating-cloud-sql-admin-password.png)

Migrieren einer lokalen Datenbank zu einer Cloud SQL Managed Instance

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 die Sitzungsaufzeichnung nach der Migration ordnungsgemäß funktioniert, führen Sie SsRecUtils.exe auf dem Sitzungsaufzeichnungsserver 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 Sitzungsaufzeichnungsserver den Citrix Session Recording Analytics-Dienst, den Citrix Session Recording Storage Manager-Dienst und den IIS-Dienst neu.

Migrieren einer Produktionsdatenbank von einer Azure SQL Managed Instance zu einer lokalen Datenbank

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

2. Damit die Sitzungsaufzeichnung nach der Migration ordnungsgemäß funktioniert, führen Sie SsRecUtils.exe auf dem Sitzungsaufzeichnungsserver 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 Sitzungsaufzeichnungsserver den Citrix Session Recording Analytics-Dienst, den Citrix Session Recording Storage Manager-Dienst und den IIS-Dienst neu.

Bereitstellen der Sitzungsaufzeichnungsdatenbank auf SQL Server auf Azure-VMs

Auf SQL Server auf Azure-VMs können Sie die Sitzungsaufzeichnungsdatenbank 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 Sitzungsaufzeichnungskomponenten 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.

Deinstallieren 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 securityadmin und dbcreator besitzen wie bei der Installation.

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