Session Recording

Installieren, Aktualisieren und Deinstallieren

Hinweis:

Informationen zum Konfigurieren einer hohen Serververfügbarkeit durch Lastausgleich finden Sie unter Konfigurieren des Lastausgleichs in einer vorhandenen Bereitstellung und Bereitstellen und Lastausgleich der Sitzungsaufzeichnung in Azure.

Weitere Informationen zur schnellen Einrichtung und Konfiguration der Sitzungsaufzeichnung und des Citrix Sitzungsaufzeichnungsdiensts finden Sie in dem Citrix Tech Zone-Artikel POC Guide: Citrix Session Recording.

Sie können den Sitzungsaufzeichnungsserver und den Agenten auf einer mit Azure AD verbundenen Maschine installieren und die Azure AD-Unterstützung für sie aktivieren. Wenn Sie später verschiedene Richtlinien und Wiedergabeberechtigungen aus der Cloud konfigurieren, können Sie Azure AD-Benutzer und -Gruppen angeben, die Sitzungen von Maschinen starten, die mit Azure AD verbunden sind. Die Option Azure AD-Support aktivieren ist auf der GUI nicht verfügbar, wenn Sie den Sitzungsaufzeichnungsserver mit dem Citrix Virtual Apps and Desktops-Installationsprogramm installieren.

Dieser Artikel enthält folgende Abschnitte:

Installationscheckliste

Citrix-Skript zum Installieren der Voraussetzungen für Windows-Rollen und -Features verwenden

Sitzungsaufzeichnung mit dem Citrix Virtual Apps and Desktops-Installationsprogramm installieren

Installation automatisieren

Datenbank für die Sitzungsaufzeichnung in Cloud-SQL-Datenbankdiensten installieren

Upgrade der Sitzungsaufzeichnung

Sitzungsaufzeichnung deinstallieren

Integration mit Citrix Analytics für Sicherheit

Installationscheckliste

Stellen Sie vor der Installation sicher, dass Sie die in dieser Liste aufgeführten Schritte abgeschlossen haben:

Schritt
  Wählen Sie die Maschinen aus, auf denen Sie die Sitzungsaufzeichnungskomponenten installieren möchten. Stellen Sie sicher, dass jede Maschine die Hardware- und Softwareanforderungen für die zu installierenden Komponenten erfüllt.
  Rufen Sie unter Angabe Ihrer Citrix-Anmeldeinformationen die Citrix Virtual Apps and Desktops-Downloadseite auf und laden Sie die ISO-Datei für das Produkt herunter. Entpacken Sie die ISO-Datei oder brennen Sie sie auf DVD.
  Installieren Sie die relevanten Zertifikate in der Umgebung zur Kommunikation zwischen den Komponenten der Sitzungsaufzeichnung per TLS.
  Installieren Sie die für die Komponenten der Sitzungsaufzeichnung benötigten Hotfixes. Die Hotfixes sind unter Citrix Support verfügbar.
  Konfigurieren Sie Citrix Director zum Erstellen und Aktivieren von Sitzungsaufzeichnungsrichtlinien. Weitere Informationen finden Sie unter Director zur Verwendung des Sitzungsaufzeichnungsservers konfigurieren.

Hinweis:

  • Wir empfehlen, dass Sie die veröffentlichten Anwendungen basierend auf den Aufzeichnungsrichtlinien in eigene Bereitstellungsgruppen unterteilen. Die Sitzungsfreigabe für veröffentlichte Anwendungen kann Konflikte mit aktiven Richtlinien auslösen, wenn die Anwendungen in derselben Bereitstellungsgruppe sind. Die Sitzungsaufzeichnung ordnet die aktive Richtlinie der ersten veröffentlichten Anwendung zu, die ein Benutzer öffnet. Ab Version 7.18 können Sie die dynamischen Sitzungsaufzeichnung verwenden, um jederzeit während der Sitzungen das Aufzeichnen der Sitzung zu starten oder zu beenden. Dieses Feature hilft, Konflikte mit der aktiven Richtlinie zu mildern. Weitere Informationen finden Sie unter Dynamische Sitzungsaufzeichnung.
  • Wenn Sie beabsichtigen, Maschinenerstellungsdienste (MCS) oder Provisioning Services zu verwenden, bereiten Sie eine eindeutige QMID vor. Wenn Sie dies nicht tun, kann dies zum Verlust von Aufzeichnungsdaten führen.
  • Für SQL Server sind TCP/IP, ein ausgeführter SQL Server-Browserdienst und die aktivierte Windows-Authentifizierung erforderlich.
  • Zur Verwendung von HTTPS konfigurieren Sie Serverzertifikate für TLS/HTTPS.
  • Stellen Sie sicher, dass Benutzer unter Lokale Benutzer und Grupen > Gruppen > Benutzer Schreibrechte für den Ordner C:\windows\Temp haben.

(Nur für die MSI-Installation erforderlich) Verwenden Sie Citrix-Skripts, um die erforderlichen Windows-Rollen und Funktionen zu installieren

Damit die Sitzungsaufzeichnung ordnungsgemäß funktioniert, verwenden Sie zuvor die folgenden Citrix-Skripts, um die erforderlichen Windows-Rollen und -Funktionen zu installieren Installation der Sitzungsaufzeichnung:

  • InstallPrereqsforSessionRecordingAdministration.ps1

    <# .Synopsis Installs Prereqs for Session Recording Administration .Description Supports Windows Server 2025, Windows Server 2022, 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 2025*') -or ($system -Like '*Microsoft Windows Server 2022*') -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 if (($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*')) { 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 AddFeatures('Web-IP-Security')#IIS-IPSecurity
  • InstallPrereqsforSessionRecordingAgent.ps1

    <# .Synopsis Installs Prereqs for Session Recording Agent .Description Supports Windows Server 2025, Windows Server 2022, Windows Server 2019, windows 11, 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 2025*') -or ($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*') -or ($system -Like '*Microsoft Windows 11*') -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" }

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

  1. Führen Sie auf der Maschine, auf der Sie die Verwaltungskomponenten der Sitzungsaufzeichnung installieren möchten, die folgenden Schritte aus:

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

      Set-ExecutionPolicy RemoteSigned
    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 angehalten.

    3. Stellen Sie nach der Skriptausführung sicher, dass die Ausführungsrichtlinie auf den für Ihre Unternehmensrichtlinie erforderlichen Wert festgelegt ist.

  2. Führen Sie auf der Maschine, auf der Sie den Sitzungsaufzeichnungsagent installieren möchten, die folgenden Schritte aus:

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

      Set-ExecutionPolicy RemoteSigned
    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 Features an und wird dann angehalten.

    3. Stellen Sie nach der Skriptausführung sicher, dass die Ausführungsrichtlinie auf den für die Unternehmensrichtlinie erforderlichen Wert festgelegt ist.

Sitzungsaufzeichnung mit dem Citrix Virtual Apps and Desktops-Installationsprogramm installieren

Citrix Sitzungsaufzeichnung umfasst die folgenden Komponenten:

  • Verwaltung der Sitzungsaufzeichnung (einschließlich der Sitzungsaufzeichnungsdatenbank, des Sitzungsaufzeichnungsservers und der Sitzungsaufzeichnungsrichtlinienkonsole)
  • Sitzungsaufzeichnungsagent
  • Sitzungsaufzeichnungsplayer
  • Webplayer für die Sitzungsaufzeichnung

Obwohl die Installation aller Komponenten auf einem einzigen Server für einen Proof of Concept akzeptabel ist, empfehlen wir die Installation auf separaten Servern wie folgt:

  • Installieren Sie Microsoft SQL Server auf Computer A.
  • Installieren Sie den Sitzungsaufzeichnungsserver, die Sitzungsaufzeichnungsadministratorprotokollierung und die Sitzungsaufzeichnungsdatenbank auf Maschine B.

    Hinweis:

    Bei der Sitzungsaufzeichnungsdatenbank handelt es sich nicht um eine echte Datenbank. Mit dieser Komponente werden während der Installation die erforderlichen Datenbanken in der Microsoft SQL Server-Instanz erstellt und konfiguriert.

    Mit der Installation des Sitzungsaufzeichnungsservers können Sie den Webplayer für die Sitzungsaufzeichnung automatisch installieren lassen.

  • Installieren Sie die Richtlinienkonsole zur Sitzungsaufzeichnung auf Maschine C.
  • Installieren Sie den Sitzungsaufzeichnungsplayer entweder auf Maschine C oder Maschine D.
  • Installieren Sie den Sitzungsaufzeichnungsagenten auf dem VDA.

Verwaltungskomponenten der Sitzungsaufzeichnung installieren

Sitzungsaufzeichnungsagent installieren

Sitzungsaufzeichnungsplayer installieren

Verwaltungskomponenten der Sitzungsaufzeichnung installieren

Hinweis:

Führen Sie die folgenden Schritte aus, bevor Sie die Komponenten für die Sitzungsaufzeichnungsverwaltung auf Windows Server installieren, wenn TLS 1.0 deaktiviert ist und die Version von .NET Framework älter als 4.6 ist:

  1. Installieren Sie Microsoft OLE DB Driver für SQL Server.
  2. Fügen Sie unter dem Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319 den DWORD-Wert SchuseStrongCrypto (32-Bit) hinzu und setzen Sie die Wertdaten auf 1.

  3. Starten Sie Windows Server neu.

Weitere Informationen finden Sie unter Bewährte Methoden für Transport Layer Security (TLS) mit .NET Framework.

Die Verwaltungskomponenten der Sitzungsaufzeichnung umfassen die Datenbank für die Sitzungsaufzeichnung, den Sitzungsaufzeichnungsserver und die Richtlinienkonsole für die Sitzungsaufzeichnung. Sie können festlegen, welche dieser Komponenten auf einem Server installiert werden.

Schritt 1: Herunterladen der Produktsoftware und Starten des Assistenten

  1. Rufen Sie unter Angabe Ihrer Citrix-Anmeldeinformationen die Citrix Virtual Apps and Desktops-Downloadseite auf und laden Sie die ISO-Datei für das Produkt herunter. Entpacken Sie die ISO-Datei oder brennen Sie sie auf DVD.
  2. Melden Sie sich mit einem lokalen Administratorkonto bei der Maschine an, auf der Sie die Verwaltungskomponenten der Sitzungsaufzeichnung installieren. Legen Sie die DVD in das Laufwerk ein oder stellen Sie die ISO-Datei bereit. Wenn das Installationsprogramm nicht automatisch gestartet wird, doppelklicken Sie auf die Anwendung AutoSelect oder das bereitgestellte Laufwerk.
    Der Installationsassistent wird gestartet.

Schritt 2: Auswählen des zu installierenden Produkts

Zu installierendes Produkt auswählen

Klicken Sie auf Start neben dem zu installierenden Produkt: Citrix Virtual Apps oder Citrix Virtual Desktops.

Schritt 3: Auswählen der Sitzungsaufzeichnung

Sitzungsaufzeichnung auswählen

Wählen Sie den Eintrag Sitzungsaufzeichnung.

Schritt 4: Lesen und Akzeptieren der Lizenzvereinbarung

Installationsvereinbarung

Lesen Sie die Lizenzvereinbarung, akzeptieren Sie sie und klicken Sie auf Weiter.

Schritt 5: Auswählen der Komponenten und des Speicherorts für die Installation

Komponenten und Installationspfad wählen

Treffen Sie auf der Seite Kernkomponenten folgende Auswahl:

  • Speicherort: Standardmäßig werden die Komponenten in C:\Programme\Citrix installiert. Der Standardspeicherort eignet sich für die meisten Installationen. Sie können einen benutzerdefinierten Installationsspeicherort angeben.
  • Komponente: In der Standardeinstellung sind alle Kontrollkästchen neben Komponenten, die installiert werden können, ausgewählt. Das Installationsprogramm erkennt, ob es auf einem Einzelsitzungs-OS oder einem Multisitzungs-OS ausgeführt wird. Die Komponenten der Sitzungsaufzeichnungsverwaltung können nur auf einem Multisitzungs-OS installiert werden. Der Sitzungsaufzeichnungsagent kann nur auf einer Maschine mit vorhandenem VDA installiert werden. Auf einer Maschine ohne VDA ist die Option Sitzungsaufzeichnungsagent nicht verfügbar.

Wählen Sie Sitzungsaufzeichnungsverwaltung und klicken Sie auf Weiter.

Sitzungsaufzeichnungsverwaltung auswählen

Schritt 6: Auswählen der zu installierenden Features

Zu installierenden Features wählen

Auf der Seite Features:

  • In der Standardeinstellung sind alle Kontrollkästchen neben Features, die installiert werden können, ausgewählt. Die Installation dieser Features auf einem einzelnen Server ist für eine Machbarkeitsstudie geeignet. Installieren Sie für große Produktionsumgebungen die Richtlinienkonsole für die Sitzungsaufzeichnung auf einem eigenen Server. Installieren Sie den Sitzungsaufzeichnungsserver, die Administratorprotokollierung und die Datenbank auf einem anderen Server.
  • Die Administratorprotokollierung ist ein optionales Teilfeature des Sitzungsaufzeichnungsservers. Sie müssen den Sitzungsaufzeichnungsserver auswählen, bevor Sie die Administratorprotokollierung auswählen können. Die Datenbank für die Sitzungsaufzeichnung ist ein obligatorisches Teilfeature des Sitzungsaufzeichnungsservers. Wenn der Sitzungsaufzeichnungsserver für die Installation ausgewählt wird, wird die Datenbank für die Sitzungsaufzeichnung ebenfalls automatisch ausgewählt und kann nicht abgewählt werden.

    Sitzungsaufzeichnungsserver nicht ausgewählt

    Sitzungsaufzeichnungsserver ausgewählt

  • Wenn Sie den Sitzungsaufzeichnungsserver auswählen, wird auch der Webplayer für die Sitzungsaufzeichnung installiert.
  • Zum Hinzufügen von Features auf einem Server nach Installation eines Features müssen Sie das MSI-Paket verwenden. Sie können das Installationsprogramm nicht noch einmal ausführen.
  • Sitzungsaufzeichnungsserver

    Der Sitzungsaufzeichnungsserver ist ein Server, der Folgendes hostet:

    • Broker: Eine von IIS 6.0+ gehostete Webanwendung, die folgenden Zwecken dient:
      • Verarbeitung von Such- und Dateidownloadanfragen von Sitzungsaufzeichnungsplayer und Webplayer.
      • Verarbeitung von Richtlinienverwaltungsanforderungen von der Richtlinienkonsole der Sitzungsaufzeichnung.
      • Auswertung von Aufzeichnungsrichtlinien für jede Citrix Virtual Apps and Desktops- oder Citrix DaaS (früher Citrix Virtual Apps and Desktops Service)-Sitzung.
    • Speichermanager: Ein Windows-Dienst, der Sitzungsaufzeichnungsdateien verwaltet, die von jedem für die Sitzungsaufzeichnung aktivierten VDA empfangen werden.
    • Administratorprotokollierung: Optionale Teilkomponente, die auf dem Sitzungsaufzeichnungsserver zum Protokollieren von Verwaltungsaktivitäten installiert wird. Alle Protokollierungsdaten werden in einer separaten SQL Server-Datenbank gespeichert, die standardmäßig CitrixSessionRecordingLogging heißt. Sie können den Datenbanknamen anpassen.
  • Datenbank für die Sitzungsaufzeichnung

    • Die Datenbank für die Sitzungsaufzeichnung ist eigentlich keine Datenbank. Mit dieser Komponente werden während der Installation die erforderlichen Datenbanken in der Microsoft SQL Server-Instanz erstellt und konfiguriert. Die Sitzungsaufzeichnung unterstützt drei Lösungen für die hohe Verfügbarkeit der Datenbank basierend auf Microsoft SQL Server. Weitere Informationen finden Sie unter Hohe Datenbankverfügbarkeit.

    • Sie können Datenbank für die Sitzungsaufzeichnung in den folgenden Cloud-SQL-Datenbankdiensten installieren:

      • Azure SQL-Datenbank
      • Azure SQL Managed Instance
      • SQL Server auf virtuellen Azure-Maschinen (VMs)
      • AWS RDS
      • Google Cloud SQL Server
  • Administratorprotokollierung der Sitzungsaufzeichnung

    Wir empfehlen, dass Sie die Administratorprotokollierung zusammen mit dem Sitzungsaufzeichnungsserver installieren. Wenn Sie die Administratorprotokollierung nicht aktivieren möchten, können Sie sie auf einer nachfolgenden Seite deaktivieren. Wenn Sie das Feature nicht gleich zu Beginn installieren und es später hinzufügen möchten, ist dies nur manuell mit SessionRecordingAdministrationx64.msi möglich.

  • Richtlinienkonsole für die Sitzungsaufzeichnung

    Sie können die Richtlinienkonsole für die Sitzungsaufzeichnung verwenden, um Richtlinien zu konfigurieren.

Schritt 6.1: Sitzungsaufzeichnungsserver, Datenbank und Administratorprotokollierung installieren

Wie bereits beschrieben, ist die Datenbank für die Sitzungsaufzeichnung ein obligatorisches Teilfeature des Sitzungsaufzeichnungsservers. Es wird empfohlen, die Administratorprotokollierung für den Sitzungsaufzeichnungsserver zusammen mit dem Sitzungsaufzeichnungsserver zu installieren. Daher werden Sie in diesem Abschnitt Schritt für Schritt durch die Installation der drei Komponenten auf derselben Maschine geführt.

  1. Wählen Sie auf der Seite Features die Optionen Sitzungsaufzeichnungsserver und Administratorprotokollierung der Sitzungsaufzeichnung. Wenn Sitzungsaufzeichnungsserver ausgewählt ist, wird auch die Datenbank für die Sitzungsaufzeichnung automatisch ausgewählt. Klicken Sie auf Weiter.

    Sitzungsaufzeichnungsserver ausgewählt

  2. Geben Sie auf der Seite Datenbank- und Serverkonfiguration den Instanznamen und den Datenbanknamen der Datenbank für die Sitzungsaufzeichnung an, aktivieren Sie nach Bedarf die SQL Server-Authentifizierung und klicken Sie auf Weiter.

    Seite Datenbank- und Serverkonfiguration

    Hinweis:

    Ab 2411 unterstützt die Sitzungsaufzeichnung zusätzlich zur SQL Server-Authentifizierung die Entra ID-Authentifizierung (früher Azure Active Directory) für Cloud-basierte SQL-Datenbanken, einschließlich Azure SQL Database und Azure SQL Managed Instance. Weitere Informationen finden Sie unter Installieren der Sitzungsaufzeichnungsdatenbank auf Azure SQL-Datenbank und Installieren der Sitzungsaufzeichnungsdatenbank auf Azure SQL Managed Instance oder auf AWS RDS.

    Führen Sie auf der Seite Datenbank- und Serverkonfiguration folgende Schritte aus:

    • SQL Server-Authentifizierung aktivieren: Mit dieser Option können Sie mithilfe der SQL Server-Authentifizierung eine Verbindung zur Datenbank für die Sitzungsaufzeichnung herstellen.

      SQL Server-Authentifizierung aktivieren

    • Instanzname: Wenn die Datenbankinstanz keine benannte Instanz ist, können Sie nur den Computernamen des SQL Server-Computers verwenden. Wenn Sie die Instanz während der Einrichtung der Instanz benannt haben, verwenden Sie Computername\ Instanzname als Namen der Datenbankinstanz. Um den verwendeten Serverinstanznamen zu ermitteln, führen Sie select @@servername auf dem SQL Server aus. Der zurückgegebene Name ist der Datenbankinstanzname. Wenn Ihr SQL-Server statt des Standardports 1433 einen benutzerdefinierten Port verwendet, hängen Sie an den Instanznamen ein Komma und den benutzerdefinierten Port an. Geben Sie beispielsweise DXSBC-SRD-1,2433 in das Textfeld Instanzname ein, wobei 2433 den benutzerdefinierten Port bezeichnet.
    • Datenbankname: Geben Sie einen benutzerdefinierten Datenbanknamen in das Textfeld Datenbankname ein oder übernehmen Sie den Standardnamen. Klicken Sie auf Verbindung testen zum Testen der Verbindung mit der SQL Server-Instanz und der Gültigkeit des Datenbanknamens.

      Hinweis:

      Standardmäßig verwendet der Sitzungsaufzeichnungsserver HTTPS/TLS für die sichere Kommunikation. Wenn TLS nicht in der IIS-Standardsite des Sitzungsaufzeichnungsservers konfiguriert ist, verwenden Sie HTTP. Hierfür löschen Sie die SSL-Auswahl in der IIS-Verwaltungskonsole, indem Sie die Site des Sitzungsaufzeichnungsbrokers aufrufen, die SSL-Einstellungen öffnen und das Kontrollkästchen SSL erforderlich deaktivieren.

      Wichtig!

      Ein benutzerdefinierter Datenbankname darf nur Buchstaben (A–Z, a–z), Ziffern (0–9) und Unterstreichungsstriche enthalten und nicht länger als 123 Zeichen sein.

      Sie müssen die Serverrollenberechtigungen securityadmin und dbcreator für die SQL Server-Instanz haben. Wenn Sie diese Berechtigungen nicht haben, gibt es folgende Möglichkeiten:

      • Bitten Sie den Datenbankadministrator darum, Berechtigungen für die Installation zuzuweisen. Nach Abschluss der Installation werden die Serverrollenberechtigungen securityadmin und dbcreator nicht mehr benötigt und können entfernt werden.
      • Alternativ können Sie das Paket SessionRecordingAdministrationx64.msi unter \x64\Session Recording im ISO-Image von Citrix Virtual Apps and Desktops verwenden. Während der MSI-Installation wird ein Dialogfeld angezeigt, in dem die Anmeldeinformationen eines Datenbankadministrators mit den Serverrollenberechtigungen securityadmin und dbcreator eingegeben werden müssen. Geben Sie die richtigen Anmeldeinformationen ein und klicken Sie auf OK, um mit der Installation fortzufahren.

        Bei der Installation wird die Datenbank für die Sitzungsaufzeichnung erstellt und das Maschinenkonto des Sitzungsaufzeichnungsservers als db\ _owner hinzugefügt.

  3. Geben Sie auf der Seite Konfiguration der Administratorprotokollierung die Konfigurationen für die Administratorprotokollierung an.

    Seite Administratorprotokollierung - Konfiguration

    Treffen Sie auf der Seite Administratorprotokollierung - Konfiguration folgende Auswahl:

    • Datenbank für Administratorprotokollierung installieren auf SQL Server-Instanz: Dieses Feld kann nicht bearbeitet werden. Der Name der SQL Server-Instanz der Datenbank für die Administratorprotokollierung wird automatisch aus dem Instanznamen abgerufen, den Sie auf der Seite Datenbank und Server eingegeben haben. Ab Version 2411 können Sie die Administratorprotokollierungsdatenbank zur Sitzungsaufzeichnung auf einer anderen Instanz als die Sitzungsaufzeichnungsdatenbank installieren. Führen Sie dazu vor der Installation die folgenden Schritte aus:

      1. Gehen Sie zu der Maschine, auf der Sie den Sitzungsaufzeichnungsserver installieren möchten.
      2. Öffnen Sie den Registrierungs-Editor.
      3. Ändern Sie die Registrierung:
        • Navigieren Sie zu HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.
        • Fügen Sie den DWORD-Wert (32-Bit) SmAudDatabaseLoggingState hinzu und legen Sie die Wertdaten auf 1fest.
        • Fügen Sie den Wert SmAudDatabaseLoggingInstance hinzu und legen Sie die Wertdaten auf den Namen der Instanz fest, in der Sie die Administratorprotokollierungsdatenbank für die Sitzungsaufzeichnung installieren möchten.

      Wenn Sie später die Datenbanken installieren, wird die Administratorprotokollierungsdatenbank zur Sitzungsaufzeichnung auf der separaten Instanz installiert, die durch den Registrierungswert SmAudDatabaseLoggingInstance angegeben wird. Sie müssen für beide Datenbanken denselben Authentifizierungsmodus konfigurieren (SQL Server-Authentifizierung, Windows-Authentifizierung oder Microsoft Entra ID-Authentifizierung) und identische Benutzerberechtigungen erteilen.

    • Datenbankname für die Administratorprotokollierung: Zum Installieren der Administratorprotokollierung für die Sitzungsaufzeichnung geben Sie einen benutzerdefinierten Namen für die Datenbank der Administratorprotokollierung im Textfeld ein oder übernehmen Sie den angegebenen Standarddatenbanknamen CitrixSessionRecordingLogging.

        > **Note:**
        >
        > The administrator logging database name must be different from the Session Recording database name that is set in the **Database name** text box on the previous **Database and Server Configuration** page.
      
    • Nach der Eingabe des Namens klicken Sie auf Verbindung testen, um die Verbindung mit der Datenbank zu testen.
    • Administratorprotokollierung aktivieren: Die Administratorprotokollierung ist standardmäßig aktiviert. Sie können sie deaktivieren, indem Sie das Kontrollkästchen deaktivieren.
    • Obligatorische Blockierung aktivieren: Die obligatorische Blockierung ist standardmäßig aktiviert. Die normalen Funktionen werden möglicherweise blockiert, wenn die Protokollierung fehlschlägt. Sie können sie deaktivieren, indem Sie das Kontrollkästchen deaktivieren.

    Klicken Sie auf Weiter, um die Installation fortzusetzen.

  4. Überprüfen Sie die Voraussetzungen und bestätigen Sie die Installation.

    Zusammenfassung der Installation

    Die Seite Zusammenfassung enthält die Installationsoptionen. Sie können mit der Schaltfläche Zurück zu vorherigen Seiten zurückkehren und Ihre Auswahl ändern, oder die Installation durch Klicken auf Installieren starten.

  5. Schließen Sie die Installation ab.

    Fertigstellen der Installation

    Die Seite Fertigstellen der Installation enthält grüne Häkchen für alle Voraussetzungen und Komponenten, die installiert und initialisiert werden konnten.

    Klicken Sie auf Fertig stellen, um die Installation des Sitzungsaufzeichnungsservers, der Datenbank und der Administratorprotokollierung abzuschließen.

Schritt 6.2: Installieren der Richtlinienkonsole für die Sitzungsaufzeichnung

Gehen Sie wie folgt vor, um die Richtlinienkonsole für die Sitzungsaufzeichnung zu installieren:

  1. Wählen Sie auf der Seite Features die Option Richtlinienkonsole für die Sitzungsaufzeichnung und klicken Sie auf Weiter.

    Richtlinienkonsole nicht ausgewählt

  2. Überprüfen Sie die Voraussetzungen und bestätigen Sie die Installation.

    Installationszusammenfassung für die Richtlinienkonsole

    Die Seite Zusammenfassung enthält die Installationsoptionen. Sie können mit der Schaltfläche Zurück zu vorherigen Seiten zurückkehren und Ihre Auswahl ändern, oder die Installation durch Klicken auf Installieren starten.

  3. Schließen Sie die Installation ab.

    Abschließen der Richtlinienkonsoleninstallation

    Die Seite Fertigstellen der Installation enthält grüne Häkchen für alle Voraussetzungen und Komponenten, die installiert und initialisiert werden konnten.

    Klicken Sie auf Fertig stellen, um die Installation der Richtlinienkonsole für die Sitzungsaufzeichnung abzuschließen.

Schritt 7: Installieren von Broker_PowerShellSnapIn_x64.msi

Wichtig!

Um die Richtlinienkonsole für die Sitzungsaufzeichnung zu verwenden, installieren Sie das Broker PowerShell-Snap-In (Broker_PowerShellSnapIn_x64.msi) manuell. Suchen Sie das Snap-In auf der Citrix Virtual Apps and Desktops-ISO (\x64\ Citrix Desktop Delivery Controller) und folgen Sie den Anweisungen zur Installation. Anderenfalls kann es zu Fehlern kommen.

Sitzungsaufzeichnungsagent installieren

Der Sitzungsaufzeichnungsagent ist eine Komponente, die auf jedem VDA für Multisitzungs-OS oder Einzelsitzungs-OS installiert wird, um Aufzeichnungen zu ermöglichen. Mit dieser Komponente werden Sitzungsdaten aufgezeichnet.

Schritt 1: Herunterladen der Produktsoftware und Starten des Assistenten

Melden Sie sich mit einem lokalen Administratorkonto bei der Maschine an, auf der Sie den Sitzungsaufzeichnungsagent installieren. Legen Sie die DVD in das Laufwerk ein oder stellen Sie die ISO-Datei bereit. Wenn das Installationsprogramm nicht automatisch gestartet wird, doppelklicken Sie auf die Anwendung AutoSelect oder das bereitgestellte Laufwerk.

Der Installationsassistent wird gestartet.

Schritt 2: Auswählen des zu installierenden Produkts

Zu installierendes Produkt auswählen

Klicken Sie auf Start neben dem zu installierenden Produkt: Citrix Virtual Apps oder Citrix Virtual Desktops.

Schritt 3: Auswählen der Sitzungsaufzeichnung

Auswählen des zu installierenden Sitzungsaufzeichnungsagent

Wählen Sie den Eintrag Sitzungsaufzeichnung.

Schritt 4: Lesen und Akzeptieren der Lizenzvereinbarung

Installationsvereinbarung

Lesen Sie die Lizenzvereinbarung, akzeptieren Sie sie und klicken Sie auf Weiter.

Schritt 5: Auswählen der Komponente und des Speicherorts für die Installation

Agent zur Installation auswählen

Wählen Sie Sitzungsaufzeichnungsagent und klicken Sie auf Weiter.

Schritt 6: Angeben der Agentkonfiguration

Agentkonfiguration

Nehmen Sie auf der Seite Agentkonfiguration die folgenden Einstellungen vor:

  • Geben Sie den Namen der Maschine ein, auf der Sie den Sitzungsaufzeichnungsserver installiert haben, sowie das Protokoll und die Portinformationen zum Verbindungsaufbau mit dem Sitzungsaufzeichnungsserver. Wenn Sie die Sitzungsaufzeichnung noch nicht installiert haben, können Sie diese Informationen später unter Sitzungsaufzeichnungsagent - Eigenschaften ändern.
  • Wenn Sie den Sitzungsaufzeichnungsagenten auf einer mit Azure AD verbundenen Maschine installieren, wählen Sie Azure AD-Support aktivieren aus. Um die Azure AD-Identitätsunterstützung für die Konfiguration von Wiedergabeberechtigungen und verschiedenen Sitzungsaufzeichnungsrichtlinien aus der Cloud vollständig zu aktivieren, führen Sie die folgenden Schritte aus und starten Sie den VDA neu:

    Hinweis:

    Die Azure AD-Unterstützung ist ein Preview-Feature. Es ist mit Sitzungsaufzeichnung Version 2402 und höher verfügbar.

    Als Preview verfügbare Features sind möglicherweise nicht vollständig lokalisiert und werden für die Verwendung in Nicht-Produktionsumgebungen empfohlen. Der technische Support von Citrix bietet keine Unterstützung bei Problemen mit als Preview verfügbaren Features.

    • Verwenden Sie das MSI-Paket, um den Sitzungsaufzeichnungsserver auch auf einer mit Azure AD verbundenen Maschine zu installieren. Wählen Sie während der MSI-Installation die Option Azure AD-Unterstützung aktivieren aus.

      Azure AD-Unterstützung während der Server-MSI-Installation aktivieren

    • Verbinden Sie Citrix Cloud mit Azure AD.

    • Gehen Sie zur Homepage der Benutzeroberfläche für die vollständige Konfiguration und aktivieren Sie im Abschnitt Preview-Features die Schalter SessionRecordingSupportAAD und Send User Identity Info In Prepare Session. Gehen Sie wie folgt vor, um auf die Homepage der Benutzeroberfläche für die vollständige Konfiguration zuzugreifen:

      1. Melden Sie sich bei Citrix Cloud an.
      2. Wählen Sie im Menü oben links Meine Dienste > DaaS aus. Standardmäßig wird die Homepage der Benutzeroberfläche für die vollständige Konfiguration angezeigt.

Hinweis:

Es gibt eine Einschränkung bei der Funktion des Installationsprogramms zum Verbindungstest. Das Szenario “HTTPS erfordert TLS 1.2” wird nicht unterstützt. Bei Verwendung des Installationsprogramms in diesem Szenario schlägt der Verbindungstest fehl, Sie können den Fehler jedoch ignorieren und auf Weiter klicken, um mit der Installation fortzufahren. Die normale Funktionsweise wird nicht beeinflusst.

Schritt 7: Überprüfen der Voraussetzungen und Bestätigen der Installation

Zusammenfassung der Agentinstallation

Die Seite Zusammenfassung enthält die Installationsoptionen. Sie können mit der Schaltfläche Zurück zu vorherigen Seiten zurückkehren und Ihre Auswahl ändern, oder die Installation durch Klicken auf Installieren starten.

Schritt 8: Vollständige Installation

Agentinstallation abgeschlossen

Die Seite Fertigstellen der Installation enthält grüne Häkchen für alle Voraussetzungen und Komponenten, die installiert und initialisiert werden konnten.

Klicken Sie auf Fertig stellen, um die Installation des Sitzungsaufzeichnungsagents abzuschließen.

Hinweis:

Wenn von Maschinenerstellungsdienste (MCS) oder Citrix Provisioning mehrere VDAs mit einem Masterimage und installiertem Microsoft Message Queuing (MSMQ) erstellt werden, haben die VDAs möglicherweise die gleiche QMID. Dieselbe QMid kann verschiedene Probleme verursachen, zum Beispiel:

  • Sitzungen werden nicht aufgezeichnet, selbst wenn eine Aufzeichnungsvereinbarung akzeptiert wurde.
  • Der Sitzungaufzeichnungsserver empfängt möglicherweise keine Sitzungsabmeldungssignale, sodass Sitzungen permanent den Status “Live” beibehalten.

Erstellen Sie als Workaround eine eindeutige QMID für jeden VDA (abhängig von der Bereitstellungsmethode).

Keine zusätzliche Aktion ist erforderlich, wenn VDAs für Einzelsitzungs-OS, auf denen ein Sitzungsaufzeichnungsagent installiert ist, mit PVS 7.7 oder höher oder MCS 7.9 oder höher im statischen Desktopmodus erstellt werden und beispielsweise festgelegt wurde, dass alle Änderungen mit einer separaten persönlichen vDisk oder einem lokalen Datenträger des VDAs persistent gemacht werden.

Bei VDAs für Multisitzungs-OS, die mit MCS oder PVS erstellt wurden, und bei VDAs für Einzelsitzungs-OS, auf denen Änderungen bei Abmeldung des Benutzers verworfen werden, verwenden Sie das Skript GenRandomQMID.ps1, um die QMID beim Systemstart zu ändern. Ändern Sie die Energieverwaltungsstrategie, um sicherzustellen, dass vor Anmeldeversuchen der Benutzer genug VDAs ausgeführt werden.

Um das Skript GenRandomQMID.ps1 zu verwenden:

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

    Set-ExecutionPolicy RemoteSigned

  2. Erstellen Sie einen geplanten Task und legen Sie als Auslöser “Bei Systemstart fest” und für die Ausführung auf dem Computer mit dem PVS- oder MCS-Masterimage das Konto SYSTEM.

  3. Fügen Sie den Befehl als Starttask 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. Anhalten zugehöriger Dienste, einschließlich CitrixSmAudAgent und MSMQ
  4. Zum Generieren einer zufälligen QMID starten Sie die zuvor angehaltenen 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 } } }

Sitzungsaufzeichnungsplayer installieren

Der Sitzungsaufzeichnungsplayer ist eine Benutzeroberfläche, auf die Sie von der Arbeitsstation aus zugreifen und mit der Sitzungsaufzeichnungsdateien wiedergegeben werden. Installieren Sie den Sitzungsaufzeichnungsplayer auf dem Sitzungsaufzeichnungsserver oder auf Arbeitsstationen in der Domäne.

Tipp

  • Mit der Installation des Sitzungsaufzeichnungsservers können Sie den Webplayer für die Sitzungsaufzeichnung automatisch installieren lassen.
  • Installieren Sie vor oder nach der Installation des Sitzungsaufzeichnungsplayers das Microsoft Visual C++ Redistributable-Paket namens VC_Redist.x86.exe. Sie finden das Paket auf der Citrix Virtual Apps and Desktops-ISO unter \Support\vCredist.

Schritt 1: Herunterladen der Produktsoftware und Starten des Assistenten

Melden Sie sich mit einem lokalen Administratorkonto bei der Maschine an, auf der Sie den Sitzungsaufzeichnungsplayer installieren. Legen Sie die DVD in das Laufwerk ein oder stellen Sie die ISO-Datei bereit. Wenn das Installationsprogramm nicht automatisch gestartet wird, doppelklicken Sie auf die Anwendung AutoSelect oder das bereitgestellte Laufwerk.

Der Installationsassistent wird gestartet.

Schritt 2: Auswählen des zu installierenden Produkts

Zu installierendes Produkt auswählen

Klicken Sie auf Start neben dem zu installierenden Produkt: Citrix Virtual Apps oder Citrix Virtual Desktops.

Schritt 3: Auswählen der Sitzungsaufzeichnung

Sitzungsaufzeichnung auswählen

Wählen Sie den Eintrag Sitzungsaufzeichnung.

Schritt 4: Lesen und Akzeptieren der Lizenzvereinbarung

Installationsvereinbarung

Lesen Sie die Lizenzvereinbarung, akzeptieren Sie sie und klicken Sie auf Weiter.

Schritt 5: Auswählen der Komponente und des Speicherorts für die Installation

Player für Installation wählen

Wählen Sie Sitzungsaufzeichnungsverwaltung und klicken Sie auf Weiter.

Schritt 6: Überprüfen der Voraussetzungen und Bestätigen der Installation

Zusammenfassung der Playerinstallation

Die Seite Zusammenfassung enthält die Installationsoptionen. Sie können mit der Schaltfläche Zurück zu vorherigen Seiten zurückkehren und Ihre Auswahl ändern, oder die Installation durch Klicken auf Installieren starten.

Schritt 7: Abschließen der Installation

Abschließen der Playerinstallation

Die Seite Fertigstellen der Installation enthält grüne Häkchen für alle Voraussetzungen und Komponenten, die installiert und initialisiert werden konnten.

Klicken Sie auf Fertig stellen, um die Installation des Sitzungsaufzeichnungsplayers abzuschließen.

Zugriffssteuerungsliste (ACL) für Message Queuing (MSMQ) festlegen

Nach der Installation der Sitzungsaufzeichnung wird empfohlen, die ACL für MSMQ zu konfigurieren. Weitere Informationen finden Sie unter Sicherheitsempfehlungen.

Installation automatisieren

Die Sitzungsaufzeichnung unterstützt die automatische Installation mit Optionen.

Automatische Installation der Komponenten der Sitzungsaufzeichnungsverwaltung

Installieren aller Verwaltungskomponenten für die Sitzungsaufzeichnung mit einem einzigen Befehl

Mit einem der folgenden Befehle installieren Sie alle Komponenten der Sitzungsaufzeichnungsverwaltung und erstellen eine Protokolldatei, in der die Installationsinstallationen erfasst werden.

msiexec /i "c:\SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="WNBIO-SRD-1" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" DATABASEUSER="localhost" /q /l*vx "yourinstallationlog"
msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" DATABASEUSER="localhost" CLOUDDBSUPPORT="0" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1" SERVICEKEYAUTHENABLE="1" /qn+ /l*vx "yourinstallationlog"

Hinweis:

Sie finden die Datei SessionRecordingAdministrationx64.msi auf der Citrix Virtual Apps and Desktops-ISO unter \x64\Session Recording.

Unabhängig von der hier durch DATABASEINSTANCE angegebenen Instanz können Sie ab der Version 2411 die Administratorprotokollierungsdatenbank für die Sitzungsaufzeichnung auch auf einer anderen Instanz als die Sitzungsaufzeichnungsdatenbank installieren. Führen Sie hierzu die folgenden Schritte aus, bevor Sie einen der Befehle zur Installation ausführen:

  1. Gehen Sie zu der Maschine, auf der Sie den Sitzungsaufzeichnungsserver installieren möchten.
  2. Öffnen Sie den Registrierungs-Editor.
  3. Ändern Sie die Registrierung:

    • Navigieren Sie zu HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.
    • Fügen Sie den DWORD-Wert (32-Bit) SmAudDatabaseLoggingState hinzu und legen Sie die Wertdaten auf 1fest.
    • Fügen Sie den Wert SmAudDatabaseLoggingInstance hinzu und legen Sie die Wertdaten auf den Namen der Instanz fest, in der Sie die Administratorprotokollierungsdatenbank für die Sitzungsaufzeichnung installieren möchten.

      Wenn Sie später die Datenbanken installieren, wird die Administratorprotokollierungsdatenbank zur Sitzungsaufzeichnung auf der separaten Instanz installiert, die durch den Registrierungswert SmAudDatabaseLoggingInstance angegeben wird. Sie müssen für beide Datenbanken denselben Authentifizierungsmodus konfigurieren (SQL Server-Authentifizierung, Windows-Authentifizierung oder Microsoft Entra ID-Authentifizierung) und identische Benutzerberechtigungen erteilen.

Ort:

  • ADDLOCAL stellt die Funktionen zur Auswahl bereit. Sie können mehrere Optionen auswählen. SsRecServer ist der Sitzungsaufzeichnungsserver. PolicyConsole ist die Richtlinienkonsole für die Sitzungsaufzeichnung. SsRecLogging ist das Feature zur Administratorprotokollierung. StorageDatabase ist die Datenbank für die Sitzungsaufzeichnung. Die Administratorprotokollierung ist ein optionales Teilfeature des Sitzungsaufzeichnungsservers. Sie müssen den Sitzungsaufzeichnungsserver auswählen, bevor Sie die Administratorprotokollierung auswählen können.
  • DATABASEINSTANCE ist der Instanzname der Datenbank für die Sitzungsaufzeichnung. Beispiel: .\SQLEXPRESS,computer-name\SQLEXPRESS,computer-name oder tcp:srt-sql-support.public.ca7b16b60789.database.windows.net,3342, wenn Sie eine verwaltete Azure SQL-Instanz verwenden. Wie bereits beschrieben, können Sie die Sitzungsaufzeichnungsdatenbank und die Sitzungsaufzeichnungs-Administratorprotokollierungsdatenbank auf derselben oder auf getrennten Instanzen installieren.
  • DATABASENAME ist der Name der Datenbank für die Sitzungsaufzeichnung.
  • LOGGINGDATABASENAME ist der Name der Datenbank für die Administratorprotokollierung.
  • AZURESQLSERVICESUPPORT bestimmt, ob die SQL Server-Authentifizierung unterstützt wird. Um die SQL Server-Authentifizierung zu verwenden, setzen Sie sie auf 1.
  • DATABASEUSER ist das Computerkonto des Sitzungsaufzeichnungsservers.
  • CLOUDDBSUPPORT bestimmt, ob Azure SQL-Datenbanken unterstützt werden.
  • AZUREUSERNAME ist der Administratorname der SQL Server- oder Microsoft Entra-ID. Ab 2411 unterstützt die Sitzungsaufzeichnung die Entra-ID-Authentifizierung für Cloud-basierte SQL-Datenbanken, einschließlich Azure SQL Database und Azure SQL Managed Instance. Führen Sie die folgenden Schritte aus, um die Microsoft Entra ID-Authentifizierung zu verwenden:

    1. Stellen Sie sicher, dass Visual C++ Redistributable auf dem Sitzungsaufzeichnungsserver installiert wurde. Andernfalls laden Sie es von https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170herunter und installieren Sie es.
    2. Stellen Sie sicher, dass der Microsoft ODBC-Treiber für SQL Server auf dem Sitzungsaufzeichnungsserver installiert wurde. Andernfalls laden Sie es von https://learn.microsoft.com/en-us/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16herunter und installieren Sie es.
    3. Fügen Sie den Parameter AADPASSWORD ein und setzen Sie ihn auf 1, wenn Sie den Datenbankinstallationsbefehl ausführen.
    4. Erstellen Sie einen Entra-ID-Administrator und erteilen Sie ihm SQL Server-Administratorberechtigungen. Weitere Informationen finden Sie in der Microsoft-Dokumentation: https://learn.microsoft.com/en-us/azure/azure-sql/database/authentication-aad-configure?view=azuresql&tabs=azure-powershell.
  • AZUREPASSWORD ist das Administratorkennwort für SQL Server oder Microsoft Entra ID.
  • AADPASSWORD bestimmt, ob die Microsoft Entra ID-Authentifizierung unterstützt wird. Um die Microsoft Entra ID-Authentifizierung zu verwenden, setzen Sie den Wert auf 1.
  • SERVICEKEYAUTHENABLE aktiviert die Dienstschlüsselauthentifizierung zwischen dem Sitzungsaufzeichnungsagenten und dem Sitzungsaufzeichnungsserver. Dieser Parameter ist nur erforderlich, wenn Sie die Azure AD-Unterstützung aktivieren möchten, und Sie müssen ihn auf 1 setzen. Andernfalls fügen Sie diesen Parameter nicht hinzu.
  • /q gibt den stillen Modus an.
  • /l*v gibt eine ausführliche Protokollierung an.
  • yourinstallationlog ist der Speicherort der Installationsprotokolldatei.

Erstellen eines Masterimages für die Bereitstellung des Sitzungsaufzeichnungsservers

Möglicherweise haben Sie bereits eine Datenbank für die Sitzungsaufzeichnung und eine Datenbank für die Administratorprotokollierung aus einer vorhandenen Bereitstellung. In solchen Szenarios können Sie nun auf Datenbankprüfungen verzichten, wenn Sie die Komponenten der Sitzungsaufzeichnungsverwaltung mit SessionRecordingAdministrationx64.msi installieren. Sie können ein Masterimage für die einfache Bereitstellung des Sitzungsaufzeichnungsservers auf vielen anderen Maschinen erstellen. Nachdem Sie den Sitzungsaufzeichnungsserver mit dem Masterimage auf Zielmaschinen bereitgestellt haben, führen Sie auf jeder Maschine einen Befehl aus, um eine Verbindung mit der vorhandenen Datenbank für die Sitzungsaufzeichnung und der Datenbank für die Administratorprotokollierung herzustellen. Diese Unterstützung für Masterimages erleichtert die Bereitstellung und minimiert die potenziellen Auswirkungen menschlicher Fehler. Sie gilt nur für Neuinstallationen und besteht aus den folgenden Schritten:

  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"

    Mit diesem Befehl werden die Verwaltungskomponenten der Sitzungsaufzeichnung installiert, ohne die Verbindung zur Datenbank für die Sitzungsaufzeichnung und zur Datenbank für die Administratorprotokollierung zu konfigurieren und zu testen.

    Setzen Sie den Parameter IGNOREDBCHECK auf True und verwenden Sie Zufallswerte für DATABASEINSTANCE, DATABASENAME und LOGGINGDATABASENAME.

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

  3. Stellen Sie das Masterimage für die Bereitstellung des Sitzungsaufzeichnungsservers auf anderen Maschinen bereit.

  4. Führen Sie auf jeder der Maschinen Befehle aus, die den Folgenden ähneln:

    .\SsRecUtils.exe -modifydbconnectionpara DATABASEINSTANCE DATABASENAME LOGGINGDATABASENAME iisreset /noforce

    Mit den Befehlen wird der zuvor installierte Sitzungsaufzeichnungsserver mit einer vorhandenen Datenbank für die Sitzungsaufzeichnung und einer Datenbank für die Administratorprotokollierung verbunden.

    Sie finden die Datei SsRecUtils.exe unter \Citrix\SessionRecording\Server\bin\. Legen Sie die Parameter DATABASEINSTANCE, DATABASENAMEund LOGGINGDATABASENAME nach Bedarf fest.

Sie können die Datenbanken auch bei der Deinstallation der Verwaltungskomponenten für die Sitzungsaufzeichnung beibehalten

Wenn KEEPDB auf True festgelegt ist, wird mit dem folgenden Befehl die Datenbank der Sitzungsaufzeichnung und die Datenbank der Administratorprotokollierung beibehalten, wenn die Komponenten der Sitzungsaufzeichnungsverwaltung deinstalliert werden:

msiexec /x "SessionRecordingAdministrationx64.msi" KEEPDB="True"

Automatische Installation von Sitzungsaufzeichnungsplayer und Webplayer

Mit den folgenden Befehlen installieren Sie den Sitzungsaufzeichnungsplayer bzw. den Webplayer.

msiexec /i "c:\SessionRecordingPlayer.msi" /q /l*\vx "yourinstallationlog"
msiexec /i "c:\SessionRecordingWebPlayer.msi" /q /l*vx "yourinstallationlog"

Hinweis:

Sie finden SessionRecordingPlayer.msi auf der Citrix Virtual Apps and Desktops-ISO unter \x86\Session Recording.

Sie finden SessionRecordingWebPlayer.msi auf der Citrix Virtual Apps and Desktops-ISO unter \x64\ Session Recording.

Ort:

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

Automatische Installation des Sitzungsaufzeichnungsagent

Mit dem folgenden Befehl installieren Sie den Sitzungsaufzeichnungsagent und erstellen eine Protokolldatei, in der die Installationsinformationen erfasst werden.

msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport SESSIONRECORDINGAUTHENTICATION="Citrix Cloud" SESSIONRECORDINGRPC="Websocket" SESSIONRECORDINGIDP="IDP"

Hinweis:

Sie finden SessionRecordingAgentx64.msi auf der Citrix Virtual Apps and Desktops-ISO unter \x64\Session Recording.

Ort:

  • yourservername ist der NetBIOS-Name oder FQDN der Maschine, die den Sitzungsaufzeichnungsserver hostet. Wenn Sie keinen Namen eingeben, wird der Standardwert localhost verwendet.
  • yourbrokerprotocol entspricht HTTP oder HTTPS und gibt an, wie der Sitzungsaufzeichnungsagent mit dem Sitzungsaufzeichnungsbroker kommuniziert. Erfolgt keine Angabe, wird standardmäßig HTTPS verwendet.
  • yourbrokerport entspricht der Nummer des Ports, über den der Sitzungsaufzeichnungsagent mit dem Sitzungsaufzeichnungsbroker kommuniziert. Wenn Sie keine Eingabe machen, wird als Standardwert Null verwendet, d. h. der Sitzungsaufzeichnungsagent verwendet den Standardport für das ausgewählte Protokoll: 80 für HTTP oder 443 für HTTPS.
  • SESSIONRECORDINGAUTHENTICATION ist der Authentifizierungstyp zwischen dem Sitzungsaufzeichnungsagenten und dem Sitzungsaufzeichnungsserver. Dieser Parameter ist nur erforderlich, wenn Sie die Azure AD-Unterstützung aktivieren möchten. Um die Azure AD-Unterstützung zu aktivieren, fügen Sie diesen Parameter hinzu und legen Sie ihn auf Citrix Cloud fest.
  • SESSIONRECORDINGRPC ist die Kommunikationsmethode zwischen dem Sitzungsaufzeichnungsagenten und dem Sitzungsaufzeichnungsserver. Dieser Parameter ist nur erforderlich, wenn Sie die Azure AD-Unterstützung aktivieren möchten. Um die Azure AD-Unterstützung zu aktivieren, fügen Sie diesen Parameter hinzu und legen Sie ihn auf Websocket fest.
  • SESSIONRECORDINGIDP gibt den Identitätstyp an. Dieser Parameter ist nur erforderlich, wenn Sie die Azure AD-Unterstützung aktivieren möchten. Um die Azure AD-Unterstützung zu aktivieren, fügen Sie diesen Parameter hinzu und legen Sie ihn auf IDP fest.
  • /q gibt den stillen Modus an.
  • /l*v gibt eine ausführliche Protokollierung an.
  • yourinstallationlog ist der Speicherort der Installationsprotokolldatei.

Upgrade der Sitzungsaufzeichnung

Sie können bestimmte Bereitstellungen aktualisieren, ohne zunächst neue Maschinen oder Sites erstellen zu müssen. Sie können ein Upgrade von der im neuesten CU von XenApp und XenDesktop 7.6 LTSR enthaltenen Version der Sitzungsaufzeichnung und von jeder späteren Version auf die aktuelle Sitzungsaufzeichnungsversion durchführen.

Hinweis:

Wenn Sie bei einem Upgrade der Sitzungsaufzeichnungsverwaltung von Version 7.6 auf 7.13 oder höher unter “Sitzungsaufzeichnungsverwaltung” zum Hinzufügen der Administratorprotokollierung Ändern wählen, wird der SQL Server-Instanzname auf der Seite Administratorprotokollierung - Konfiguration nicht angezeigt. Die folgende Fehlermeldung wird angezeigt, wenn Sie auf Weiter klicken: Fehler beim Datenbankverbindungstest. Geben Sie den richtigen Datenbankinstanznamen ein. Fügen Sie als Workaround dem folgenden Ordner der SmartAuditor Server-Registrierung die Leseberechtigung für localhost-Benutzer hinzu: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.

Sie können kein Upgrade von einer Technical Preview-Version ausführen.

Anforderungen, Vorbereitung und Einschränkungen

  • Sie müssen über die grafische Oberfläche oder die Befehlszeile des Installationsprogramms für die Sitzungsaufzeichnung ein Upgrade von deren Komponenten auf der Maschine ausführen, auf der die Komponenten installiert sind.
  • Vor Beginn des Upgrades sichern Sie die Datenbank “CitrixSessionRecording” auf der SQL Server-Instanz. Sollten Sie nach dem Datenbankupgrade Probleme entdecken, können Sie die Datenbank wiederherstellen.
  • Auf den Maschinen, auf denen Sie die Komponenten der Sitzungsaufzeichnung aktualisieren, müssen Sie sowohl Domänenbenutzer als auch lokaler Administrator sein.
  • Sind Server und Datenbank der Sitzungsaufzeichnung nicht auf dem gleichen Server installiert, benötigen Sie die Datenbankrollenberechtigung für das Upgrade der Datenbank für die Sitzungsaufzeichnung. Anderenfalls:
    • Bitten Sie den Datenbankadministrator die Rollenberechtigungen securityadmin und dbcreator für das Upgrade zuzuweisen. Nach Abschluss des Upgrades werden die Serverrollenberechtigungen securityadmin und dbcreator nicht mehr benötigt und können entfernt werden.
    • Verwenden Sie das Paket SessionRecordingAdministrationx64.msi für das Upgrade. Während des Upgrades mit dem MSI-Paket wird ein Dialogfeld angezeigt, in dem die Anmeldeinformationen eines Datenbankadministrators mit den Serverrollenberechtigungen securityadmin und dbcreator eingegeben werden müssen. Geben Sie die richtigen Anmeldeinformationen ein und klicken Sie auf OK, um mit dem Upgrade fortzufahren.
  • Sie können festlegen, dass nicht alle Sitzungsaufzeichnungsagents gleichzeitig aktualisiert werden. Der Sitzungsaufzeichnungsagent ab Version 7.6.0 ist mit dem jeweils neuesten (aktuellen) Release des Sitzungsaufzeichnungsservers kompatibel. Allerdings stehen dann einige neue Features und Fehlerbehebungen ggf. nicht zur Verfügung.
  • Sitzungen, die während des Upgrades des Sitzungsaufzeichnungsservers gestartet werden, werden nicht aufgezeichnet.
  • Die Option Grafikanpassung unter “Sitzungsaufzeichnungsagent - Eigenschaften” ist nach einer Neuinstallation oder einem Upgrade standardmäßig aktiviert, um Kompatibilität mit der Desktopgestaltungsumleitung zu gewährleisten. Sie können diese Option nach einer Neuinstallation oder einem Upgrade manuell deaktivieren.
  • Die Administratorprotokollierung wird nicht installiert, wenn Sie die Sitzungsaufzeichnung aktualisieren und das Feature in der Vorgängerversion nicht verfügbar war. Ändern Sie die Installation nach dem Upgrade, um das Feature hinzuzufügen.
  • Laufen zu Beginn des Upgrades Sitzungen, kann deren Aufzeichnung sehr wahrscheinlich nicht ausgeführt werden.
  • Lesen Sie den folgenden Abschnitt zur Upgradereihenfolge, damit Sie mögliche Ausfälle einplanen und das Risiko senken können.

Aktualisierungsreihenfolge

Um die Sitzungsaufzeichnung zu aktualisieren, führen Sie das Citrix Virtual Apps and Desktops-ISO-Image auf jeder Maschine aus, auf der Sie die Sitzungsaufzeichnungskomponenten installiert haben.

Tipp

Gehen Sie zur Citrix Virtual Apps and Desktops-Downloadseite, um die gewünschte Version von Citrix Virtual Apps and Desktops herunterzuladen.

Das Upgrade erfolgt in der Regel in der folgenden Reihenfolge:

  1. Führen Sie das Upgrade des Sitzungsaufzeichnungsservers durch.

    Wenn es mehrere Sitzungsaufzeichnungsserver gibt, aktualisieren Sie zunächst denjenigen, auf dem die Datenbank für die Sitzungsaufzeichnung installiert ist. Aktualisieren Sie anschließend die übrigen Sitzungsaufzeichnungsserver.

    Führen Sie hierzu die folgenden Schritte aus:

    1. Beenden Sie den Dienst “Speichermanager der Sitzungsaufzeichnung” manuell auf dem Sitzungsaufzeichnungsserver.
    2. Stellen Sie mithilfe des Internetinformationsdienste-Managers (IIS-Manager) sicher, dass der Sitzungsaufzeichnungsbroker ausgeführt wird.
    3. Führen Sie das Citrix Virtual Apps and Desktops-ISO-Image aus und wählen Sie den gewünschten Sitzungsaufzeichnungseintrag für das Upgrade aus.
  2. Der Sitzungsaufzeichnungsdienst geht automatisch wieder online, sobald das Upgrade des Sitzungsaufzeichnungsservers abgeschlossen ist.
  3. Führen Sie das Upgrade des Sitzungsaufzeichnungsagents (auf dem Masterimage) durch.
  4. Führen Sie das Upgrade der Richtlinienkonsole für die Sitzungsaufzeichnung zusammen mit oder nach dem des Sitzungsaufzeichnungsservers durch.
  5. Führen Sie das Upgrade des Sitzungsaufzeichnungsplayers durch.

Datenbank für die Sitzungsaufzeichnung in Cloud-SQL-Datenbankdiensten installieren

In diesem Abschnitt wird beschrieben, wie Sie die Datenbank für die Sitzungsaufzeichnung in den folgenden Cloud-SQL-Datenbankdiensten installieren:

  • Azure SQL-Datenbank
  • Azure SQL Managed Instance
  • SQL Server auf Azure-VMs
  • AWS RDS
  • Google Cloud SQL Server

Datenbank für die Sitzungsaufzeichnung in Azure SQL-Datenbank installieren

  1. Erstellen Sie eine Azure SQL-Datenbank.

    1. Melden Sie sich mit Ihrem Azure-Konto beim Azure-Portal an.
    2. Wählen Sie im Portalmenü die Option Ressource erstellen.
    3. Geben Sie in das Portalsuchfeld SQL-Datenbank ein.
    4. Wählen Sie in der Liste der Suchergebnisse die Option SQL-Datenbanken.
    5. Klicken Sie auf Erstellen, um eine Azure SQL-Datenbank zu erstellen.
    6. Geben Sie im Bereich SQL-Datenbank erstellen die folgenden Informationen ein:

      • Abonnement: Wählen Sie das gewünschte Azure-Abonnement aus.
      • Ressourcengruppe: Wählen Sie Neue erstellen oder eine vorhandene Ressourcengruppe.
      • Datenbankname: Ein eindeutiger Name ist erforderlich.
      • Server: Wählen Sie “Neu erstellen” und füllen Sie das Formular Neuer Server mit den folgenden Werten aus:
        • Servername: Geben Sie einen eindeutigen Namen ein. Servernamen müssen für alle Server in Azure global eindeutig sein.
        • Standort: Wählen Sie einen Standort aus der Dropdownliste aus.
        • Authentifizierungsmethode: Wählen Sie „SQL-Authentifizierung verwenden“, „Entra ID-Authentifizierung“ oder beides.
        • Serveradministrator-Anmeldung: Geben Sie einen SQL Server- oder Microsoft Entra ID-Administratornamen ein. Ab 2411 unterstützt die Sitzungsaufzeichnung die Entra-ID-Authentifizierung für Cloud-basierte SQL-Datenbanken, einschließlich Azure SQL Database und Azure SQL Managed Instance. Weitere Informationen zur Microsoft Entra ID-Authentifizierung finden Sie in den Befehlsparameterbeschreibungen in diesem Artikel.
        • Kennwort: Geben Sie ein SQL Server- oder Microsoft Entra ID-Administratorkennwort ein, das den Anforderungen entspricht, und geben Sie es im Feld Kennwort bestätigen erneut ein.
        • Wählen Sie OK.

      Nachdem Sie die vorherigen Informationen eingegeben haben, klicken Sie auf Überprüfen + Erstellen. Klicken Sie auf die Schaltfläche Erstellen, um die Azure SQL-Datenbank zu erstellen.

  2. Wiederholen Sie Schritt 1, um eine andere Azure SQL-Datenbank auf demselben Server zu erstellen.
  3. Rufen Sie die Serververbindungszeichenfolge für die erstellten Azure SQL-Datenbanken ab.
    1. Suchen Sie im Azure-Portal einer der von Ihnen erstellten Azure SQL-Datenbanken und klicken Sie darauf.
    2. Klicken Sie in der linken Navigationsleiste auf Verbindungszeichenfolgen.
    3. Notieren Sie sich die Serverzeichenfolge, die später als Instanzname der Datenbank für die Sitzungsaufzeichnung und der Protokollierungsdatenbank für die Sitzungsaufzeichnung verwendet werden soll.
  4. Führen Sie einen Befehl ähnlich dem untigen aus, um die Datenbank für die Sitzungsaufzeichnung in der Azure SQL-Datenbank zu installieren, die Sie zuvor erstellt haben.

    Hinweis:

    In der Azure SQL-Datenbank kann die Installation der Sitzungsaufzeichnungsdatenbank nur durch Ausführen eines Befehls ähnlich dem folgenden durchgeführt werden.

    msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" DATABASEUSER="localhost" CLOUDDBSUPPORT="0" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1" /qn+ /l*vx "yourinstallationlog"

    Ort:

    • ADDLOCAL stellt die Funktionen zur Auswahl bereit. Sie können mehrere Optionen auswählen. SsRecServer ist der Sitzungsaufzeichnungsserver. PolicyConsole ist die Richtlinienkonsole für die Sitzungsaufzeichnung. SsRecLogging ist das Feature zur Administratorprotokollierung. StorageDatabase ist die Datenbank für die Sitzungsaufzeichnung. Die Administratorprotokollierung ist ein optionales Teilfeature des Sitzungsaufzeichnungsservers. Sie müssen den Sitzungsaufzeichnungsserver auswählen, bevor Sie die Administratorprotokollierung auswählen können.
    • DATABASEINSTANCE ist der Instanzname der Datenbank für die Sitzungsaufzeichnung, der durch die Azure SQL-Datenbank-Verbindungszeichenfolge angegeben wird.
    • DATABASENAME ist der Name der Datenbank für die Sitzungsaufzeichnung.
    • LOGGINGDATABASENAME ist der Name der Datenbank für die Administratorprotokollierung.
    • AZURESQLSERVICESUPPORT bestimmt, ob die SQL Server-Authentifizierung unterstützt wird. Um die SQL Server-Authentifizierung zu verwenden, setzen Sie sie auf 1.
    • CLOUDDBSUPPORT bestimmt, ob Azure SQL-Datenbanken unterstützt werden.
    • DATABASEUSER ist das Computerkonto des Sitzungsaufzeichnungsservers.
    • AZUREUSERNAME ist der Administratorname der SQL Server- oder Microsoft Entra-ID. Ab 2411 unterstützt die Sitzungsaufzeichnung die Entra-ID-Authentifizierung für Cloud-basierte SQL-Datenbanken, einschließlich Azure SQL Database und Azure SQL Managed Instance. Führen Sie die folgenden Schritte aus, um die Microsoft Entra ID-Authentifizierung zu verwenden:

      1. Stellen Sie sicher, dass Visual C++ Redistributable auf dem Sitzungsaufzeichnungsserver installiert wurde. Andernfalls laden Sie es von https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170herunter und installieren Sie es.
      2. Stellen Sie sicher, dass der Microsoft ODBC-Treiber für SQL Server auf dem Sitzungsaufzeichnungsserver installiert wurde. Andernfalls laden Sie es von https://learn.microsoft.com/en-us/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16herunter und installieren Sie es.
      3. Fügen Sie den Parameter AADPASSWORD ein und setzen Sie ihn auf 1, wenn Sie den Datenbankinstallationsbefehl ausführen.
      4. Erstellen Sie einen Entra-ID-Administrator und erteilen Sie ihm SQL Server-Administratorberechtigungen. Weitere Informationen finden Sie in der Microsoft-Dokumentation: https://learn.microsoft.com/en-us/azure/azure-sql/database/authentication-aad-configure?view=azuresql&tabs=azure-powershell.
    • AZUREPASSWORD ist das Administratorkennwort für SQL Server oder Microsoft Entra ID.
    • AADPASSWORD bestimmt, ob die Microsoft Entra ID-Authentifizierung unterstützt wird. Um die Microsoft Entra ID-Authentifizierung zu verwenden, setzen Sie den Wert auf 1.
    • /q gibt den stillen Modus an.
    • /l*v gibt eine ausführliche Protokollierung an.
    • yourinstallationlog ist der Speicherort der Installationsprotokolldatei.

Datenbank für die Sitzungsaufzeichnung in einer verwalteten Azure SQL-Instanz oder in AWS RDS installieren

Tipp

Auf einer Azure SQL Managed Instance und auf AWS RDS können Sie die Datenbank für die Sitzungsaufzeichnung wie folgt installieren:

  • Doppelklicken Sie auf das Paket SessionRecordingAdministrationx64.msi und führen Sie es aus.

  • Führen Sie einen Befehl aus, der dem folgenden ähnelt:

    msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString "DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" CLOUDDBSUPPORT="1" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1"/qn+ /l*vx "yourinstallationlog"

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

  2. (Nur für Azure SQL) Notieren Sie die Server-Zeichenfolgen, die im Bereich “Eigenschaften” angezeigt werden. Diese Zeichenfolgen sind der Instanzname der Datenbank für die Sitzungsaufzeichnung. Ein Beispiel sehen Sie im folgenden Screenshot.

    Beispiel von Serverzeichenfolgen

  3. (Nur für AWS RDS) Notieren Sie sich den Endpunkt und Port. Wird als Instanzname Ihrer Datenbank im Format <Endpoint, Port> verwendet.

    Zusammensetzung einer AWS RDS-Instanz

  4. Führen Sie SessionRecordingAdministrationx64.msi aus, um die Datenbank für die Sitzungsaufzeichnung zu installieren.

    Markieren Sie das Kontrollkästchen SQL Server-Authentifizierung aktivieren und geben Sie den Namen und das Kennwort des SQL Server-Administrators ein. Nehmen Sie andere erforderliche Konfigurationen vor.

    Anmeldeinformationen des SQL Server-Administrators eingeben

    Hinweis:

    • Wenn Sie das SQL Server-Administratorkennwort ändern, müssen Sie das Kennwort in Eigenschaften des Sitzungsaufzeichnungsservers aktualisieren. Wenn Sie Sitzungsaufzeichnungsserver - Eigenschaften öffnen, wird eine Fehlermeldung angezeigt. Klicken Sie auf OK, um fortzufahren, wählen Sie die Registerkarte Cloud DB und geben Sie das neue SQL Server-Administratorkennwort ein. Starten Sie den Analysedienst der Citrix Sitzungsaufzeichnung, den Speichermanagerdienst der Citrix Sitzungsaufzeichnung und den IIS-Dienst neu. SQL Server-Administratorkennwort aktualisieren

    • Zusätzlich zur SQL Server-Authentifizierung unterstützt die Sitzungsaufzeichnung die Entra ID-Authentifizierung (früher Azure Active Directory) für Cloud-basierte SQL-Datenbanken, einschließlich Azure SQL Database und Azure SQL Managed Instance. Um die Microsoft Entra ID-Authentifizierung zu verwenden, installieren Sie die Datenbank über die Befehlszeile und befolgen Sie die weiter oben in diesem Artikel beschriebenen Anweisungen.

    • Die Azure AD-Authentifizierung wird nicht unterstützt.

Migration einer On-Premises-Datenbank in eine verwaltete Cloud-SQL-Instanz

  1. Migrieren Sie Ihre lokale Datenbank gemäß https://docs.microsoft.com/en-us/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. Führen Sie auf dem Sitzungsaufzeichnungsserver die Datei SsRecUtils.exe aus, um sicherzustellen, dass die Sitzungsaufzeichnung nach der Migration ordnungsgemäß funktioniert.

    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 Analysedienst der Citrix Sitzungsaufzeichnung, den Speichermanagerdienst der Citrix Sitzungsaufzeichnung und den IIS-Dienst neu.

Migration einer Produktionsdatenbank von einer verwalteten Azure SQL-Instanz zu einer On-Premises-Datenbank

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

  2. Führen Sie auf dem Sitzungsaufzeichnungsserver die Datei SsRecUtils.exe aus, um sicherzustellen, dass die Sitzungsaufzeichnung nach der Migration ordnungsgemäß funktioniert.

    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 Analysedienst der Citrix Sitzungsaufzeichnung, den Speichermanagerdienst der Citrix Sitzungsaufzeichnung und den IIS-Dienst neu.

Datenbank für die Sitzungsaufzeichnung in SQL Server auf Azure-VMs installieren

Bei SQL Server auf Azure-VMs können Sie die Datenbank für die Sitzungsaufzeichnung installieren, indem Sie auf das Paket SessionRecordingAdministrationx64.msi doppelklicken und es ausführen oder das Citrix Virtual Apps and Desktops-Installationsprogramm verwenden.

  1. Checken Sie eine Azure SQL-VM aus.
  2. Konfigurieren Sie die VM und fügen Sie sie der Domäne hinzu, in der Sie die Komponenten der Sitzungsaufzeichnung installieren.
  3. Verwenden Sie den FQDN der VM als Instanznamen, wenn Sie die Datenbank für die Sitzungsaufzeichnung installieren. Hinweis: Wenn Sie SessionRecordingAdministrationx64.msi für die Installation verwenden, deaktivieren Sie das Kontrollkästchen SQL Server-Authentifizierung aktivieren.
  4. Folgen Sie den Anweisungen im Installationsprogramm, um die Installation der Datenbank für die Sitzungsaufzeichnung abzuschließen.

Datenbank für die Sitzungsaufzeichnung in Google Cloud SQL Server installieren

Tipp

In Google Cloud SQL Server kann die Installation der Datenbank für die Sitzungsaufzeichnung erfolgen, indem Sie einen ähnlichen Befehl wie unten ausführen oder indem Sie auf das Paket SessionRecordingAdministrationx64.msi doppelklicken und es ausführen. Eine Beschreibung der Befehlsparameter finden Sie unter Automatische Installation weiter oben.

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"

In diesem Abschnitt wird die Installationsmethode mithilfe von SessionRecordingAdministrationx64.msi unter \x64\Session Recording im ISO-Image von Citrix Virtual Apps and Desktops beschrieben.

  1. Erstellen Sie eine SQL Server-Instanz in Google Cloud.

    1. Gehen Sie zur Google Cloud-Konsole und öffnen Sie die Seite mit den SQL-Instanzen.
    2. Klicken Sie auf CREATE INSTANCE. Beispiel:

      Erstellen einer Instanz in der Google Cloud

    3. Wählen Sie SQL Server als Datenbank-Engine.

      Auswählen von SQL Server als Datenbank-Engine

    4. Füllen Sie das Feld Instance ID aus und geben Sie ein Kennwort für den Benutzer ein. Notieren Sie sich das Kennwort. Wählen Sie eine SQL Server-Version für Ihre Instanz aus. Führen Sie nach Bedarf weitere Konfigurationen aus. Beispiel:

      Instanz-ID und Anderes konfigurieren

    5. Weisen Sie der Instanz eine öffentliche IP-Adresse zu und legen Sie ein autorisiertes Netzwerk fest, das sich mit der Instanz verbinden kann. Geben Sie im Feld Network die IP-Adresse der Maschine ein, auf der der Sitzungsaufzeichnungsserver installiert ist. Beispiel:

      Öffentliche IP-Adresse und Netzwerk zuweisen

    6. Klicken Sie auf CREATE INSTANCE und warten Sie einige Minuten.

      Zusammenfassung zur Instanz

    7. Suchen Sie auf der Seite der neu erstellten Instanz die öffentliche IP-Adresse und notieren Sie sie.

      Öffentliche IP-Adresse notieren

    8. Führen Sie SessionRecordingAdministrationx64.msi aus, um die Datenbank für die Sitzungsaufzeichnung zu installieren.

      Nehmen Sie während der Installation auf der folgenden Seite die folgenden Konfigurationen vor:

      • Markieren Sie das Kontrollkästchen SQL Server-Authentifizierung aktivieren.
      • Geben Sie im Feld Instanzname die öffentliche IP-Adresse der SQL Server-Instanz ein, die Sie zuvor erstellt haben.
      • Geben Sie den Namen und das Kennwort des SQL Server-Administrators ein.

      Anmeldeinformationen des SQL Server-Administrators eingeben

Sitzungsaufzeichnung deinstallieren

Verwenden Sie zum Entfernen von Komponenten der Sitzungsaufzeichnung von einem Server oder einer Arbeitsstation die Option zum Deinstallieren von Programmen in der Windows-Systemsteuerung. Zum Entfernen der Datenbank für die Sitzungsaufzeichnung benötigen Sie die gleichen SQL Server-Rollenberechtigungen wie bei der Installation (securityadmin und dbcreator).

Aus Sicherheitsgründen wird die Datenbank der Administratorprotokollierung nach der Deinstallation der Komponenten nicht entfernt.

Integration mit Citrix Analytics für Sicherheit

Sie können Sitzungsaufzeichnungsserver so konfigurieren, dass Benutzerereignisse an Citrix Analytics für Sicherheit gesendet werden, das die Benutzerereignisse verarbeitet, um umsetzbare Einblicke in das Benutzerverhalten zu erhalten.

Voraussetzungen

Stellen Sie zunächst Folgendes sicher:

  • Der Sitzungsaufzeichnungsserver muss eine Verbindung zu den folgenden Adressen herstellen können:

  • Für die Sitzungsaufzeichnungsbereitstellung muss Port 443 für ausgehende Internetverbindungen geöffnet sein. Alle Proxyserver im Netzwerk müssen diese Kommunikation mit Citrix Analytics für Sicherheit zulassen.

  • Wenn Sie Citrix Virtual Apps and Desktops 7 1912 LTSR verwenden, ist die unterstützte Version der Sitzungsaufzeichnung 2103 oder höher.

Verbinden des Sitzungsaufzeichnungsservers mit Citrix Analytics für Sicherheit

  1. Melden Sie sich bei Citrix Cloud an.

  2. Suchen Sie Citrix Analytics für Sicherheit und klicken Sie auf Manage.

  3. Klicken Sie in der oberen Leiste auf Einstellungen > Datenquellen.

  4. Klicken Sie auf der Sitekarte Virtual Apps and Desktops - Session Recording auf Connect Session Recording server.

    Verbindung mit Sitzungsaufzeichnung

  5. Überprüfen Sie auf der Seite Connect Session Recording Server die Checkliste und wählen Sie alle erforderlichen Anforderungen aus. Wenn Sie keine erforderliche Anforderung auswählen, ist die Option Download File deaktiviert.

    Checkliste für Sitzungsaufzeichnung

  6. Wenn Sie Proxyserver in Ihrem Netzwerk haben, geben Sie die Proxyadresse in der Datei SsRecStorageManager.exe.config auf Ihrem Sitzungsaufzeichnungsserver ein.

    Sie finden die Konfigurationsdatei unter &lt;Session Recording server installation path&gt;\bin\SSRecStorageManager.exe.config.

    Beispiel: C:\Program Files\Citrix\SessionRecording\Server\Bin\SsRecStorageManager.exe.config.

    Pfad der Konfigurationsdatei

  7. Klicken Sie auf Download File, um die Datei SessionRecordingConfigurationFile.json herunterzuladen.

    Hinweis:

    Die Datei enthält vertrauliche Informationen. Bewahren Sie die Datei an einem sicheren Speicherort auf.

  8. Kopieren Sie die Datei auf den Sitzungsaufzeichnungsserver, den Sie mit Citrix Analytics für Sicherheit verbinden möchten.

  9. Wenn Ihre Bereitstellung mehrere Sitzungsaufzeichnungsserver umfasst, müssen Sie die Datei auf jeden Server kopieren, den Sie verbinden möchten, und die Schritte zur Konfiguration jedes Servers ausführen.

  10. Führen Sie auf dem Sitzungsaufzeichnungsserver den folgenden Befehl aus, um die Einstellungen zu importieren:

    <Session Recording server installation path>\bin\SsRecUtils.exe -Import_SRCasConfigurations <configuration file path>

    Beispiel:

    C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -Import_SRCasConfigurations C:\Users\administrator\Downloads\SessionRecordingConfigurationFile.json
  11. Starten Sie die folgenden Dienste neu:

    • Analysedienst der Citrix Sitzungsaufzeichnung

    • Citrix Speichermanager der Sitzungsaufzeichnung

  12. Rufen Sie nach erfolgreicher Konfiguration Citrix Analytics für Sicherheit auf, um den verbundenen Sitzungsaufzeichnungsserver anzuzeigen. Klicken Sie auf Turn On Data Processing, damit Citrix Analytics für Sicherheit die Daten verarbeiten kann.

    Hinweis:

    Wenn Sie den Sitzungsaufzeichnungsserver der Version 2103 oder 2104 verwenden, müssen Sie zuerst eine Sitzung für Virtual Apps and Desktops starten, um den verbundenen Sitzungsaufzeichnungsserver in Citrix Analytics für Sicherheit anzuzeigen. Andernfalls wird der verbundene Sitzungsaufzeichnungsserver nicht angezeigt. Diese Anforderung gilt nicht für den Sitzungsaufzeichnungsserver Version 2106 und höher.

Anzeigen der verbundenen Bereitstellungen

Die Serverbereitstellungen werden nur dann auf der Sitekarte der Sitzungsaufzeichnung angezeigt, wenn die Konfiguration erfolgreich war. Auf der Sitekarte wird die Anzahl der konfigurierten Server angezeigt, die Verbindungen zu Citrix Analytics für Sicherheit hergestellt haben.

Wenn Ihre Sitzungsaufzeichnungsserver auch nach erfolgreicher Konfiguration nicht angezeigt werden, lesen Sie den Abschnitt zur Problembehandlung unter Der konfigurierte Sitzungsaufzeichnungsserver kann keine Verbindung herstellen.

Sitzungsaufzeichnungsbereitstellung

Klicken Sie auf der Sitekarte auf die Anzahl der Bereitstellungen, um die mit Citrix Analytics für Sicherheit verbundenen Servergruppen anzuzeigen. Beispiel: Klicken Sie auf 1 Sitzungsaufzeichnungsbereitstellung, um den verbundenen Server oder die Servergruppen anzuzeigen. Jeder Sitzungsaufzeichnungsserver wird durch eine Basis-URL und eine ServerGroupID dargestellt.

Details der Sitzungsaufzeichnungsbereitstellung

Anzeigen empfangener Ereignisse

Auf der Sitekarte werden die verbundenen Sitzungsaufzeichnungsbereitstellungen und die Ereignisse angezeigt, die in der letzten Stunde von diesen Bereitstellungen empfangen wurden. Dies ist die Standardzeitauswahl. Sie können auch 1 Woche (1 W) auswählen und die Daten anzeigen. Klicken Sie auf die Anzahl der empfangenen Ereignisse, um die Ereignisse auf der Self-Service-Suchseite anzuzeigen.

Nachdem Sie die Datenverarbeitung aktiviert haben, wird auf der Sitekarte möglicherweise der Status No data received angezeigt. Dieser Status wird aus zwei Gründen angezeigt:

  1. Wenn Sie die Datenverarbeitung zum ersten Mal aktiviert haben, dauert es eine gewisse Zeit, bis die Ereignisse den Ereignis-Hub in Citrix Analytics erreichen. Wenn Citrix Analytics die Ereignisse empfängt, ändert sich der Status in Data processing on. Wenn sich der Status nach einiger Zeit nicht ändert, aktualisieren Sie die Seite “Data Sources”.

  2. Citrix Analytics hat in der letzten Stunde keine Ereignisse von der Datenquelle empfangen.

Hinzufügen von Sitzungsaufzeichnungsservern

Um einen Sitzungsaufzeichnungsserver hinzuzufügen, führen Sie einen der folgenden Schritte aus:

  • Klicken Sie auf der Seite Connected Session Recording Deployments auf Connect to Session recording server.

    Bereitstellung verbinden

  • Klicken Sie auf der Sitekarte Virtual Apps and Desktops - Session Recording auf das vertikale Dreipunktsymbol (⋮) und wählen Sie Connect Session Recording server.

    Verbindung mit Sitzungsaufzeichnung

Führen Sie die Schritte zum Herunterladen der Konfigurationsdatei und zum Konfigurieren eines Sitzungsaufzeichnungsservers aus.

Entfernen von Sitzungsaufzeichnungsservern

So entfernen Sie einen Sitzungsaufzeichnungsserver:

  1. Navigieren Sie in Citrix Analytics für Sicherheit zur Seite Connected Session Recording Deployments und wählen Sie die Serverbereitstellung aus, die Sie entfernen möchten.

  2. Klicken Sie auf die vertikalen Auslassungspunkte (⋮) und wählen Sie Remove Session Recording server from Analytics aus.

    Sitzungsaufzeichnungsserver entfernen

  3. Führen Sie auf dem Sitzungsaufzeichnungsserver, den Sie aus Citrix Analytics entfernt haben, den folgenden Befehl aus:

    <Session Recording server installation path>\bin\SsRecUtils.exe -Remove_SRCasConfigurations

    Beispiel:

    C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -Remove_SRCasConfigurations

Aktivieren oder Deaktivieren der Datenverarbeitung für die Datenquelle

Sie können die Datenverarbeitung für eine bestimmte Datenquelle – Director und Workspace-App – jederzeit beenden. Klicken Sie auf der Datenquellen-Sitekarte auf die vertikalen Auslassungspunkte () und wählen Sie dann Datenverarbeitung ausschalten aus. Citrix Analytics stoppt die Verarbeitung von Daten für diese Datenquelle. Sie können die Datenverarbeitung auch über die Sitekarte für Virtual Apps and Desktops beenden. Diese Option gilt für beide Datenquellen: Director und Workspace-App. Um die Datenverarbeitung wieder zu aktivieren, klicken Sie auf Turn On Data Processing.

Der konfigurierte Sitzungsaufzeichnungsserver kann keine Verbindung herstellen

Ihr Sitzungsaufzeichnungsserver kann nach der Konfiguration keine Verbindung zu Citrix Analytics herstellen. Daher wird der konfigurierte Server nicht auf der Sitekarte der Sitzungsaufzeichnung angezeigt.

Gehen Sie wie folgt vor, um dieses Problem zu beheben:

  1. Führen Sie auf dem konfigurierten Sitzungsaufzeichnungsserver den folgenden PowerShell-Befehl aus, um die Clientcomputer-ID (CMID) zu überprüfen:

    Get-WmiObject -class SoftwareLicensingService | select Clientmachineid
  2. Wenn CMID leer ist, fügen Sie die folgenden Registrierungsdateien in den angegebenen Pfaden hinzu:

    Registrierungsname Registrierungspfad Schlüsseltyp Wert
    AuditorUniqueID Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server\ Zeichenfolge Geben Sie Ihre UUID ein.
    EnableCASUseAuditorUniqueID Computer/HKEY_LOCAL_MACHINE/SOFTWARE/Citrix/SmartAuditor/Server/ REG_DWORD 1
  3. Starten Sie die folgenden Dienste neu:

    • Analysedienst der Citrix Sitzungsaufzeichnung

    • Citrix Speichermanager der Sitzungsaufzeichnung

Installieren, Aktualisieren und Deinstallieren

In diesem Artikel