Product Documentation

Installer/Mettre à niveau l'enregistrement de session

May 28, 2016

Pre-Installation Checklist

Before you start the installation, ensure that you completed this list:

Step
  Install the prerequisites before starting the installation. See System Requirements.
  Select the machines where you want to install each Session Recording component and ensure that each computer meets the hardware and software requirements for the component(s) you want to install.
  Download the Session Recording zip file or the LTSR image from the Citrix download page.
  If you use the SSL protocol for communication between the Session Recording components, install the requisite certificates in your environment. See Install certificates.

 

Configure Director to create and activate Session Recording policies. For more information, see Configure Director to use the Session Recording Server.

Notes:

  • Citrix recommends dividing published applications into separate delivery groups based on the recording policies because session sharing for published applications can conflict with active policies if they are in the same delivery group. Session Recording matches the active policy with the first published application that a user opens.
  • If you are planning to use Machine Creation Services (MCS) or Provisioning Services with XenApp, prepare the server for a unique QMId. . Failure to do so might result in recording data loss. For more information, see Known Issue #528678.
  • SQL server requires TCP/IP to be enabled, the SQL Server Browser service to be running, and Windows Authentication.
  • If you want to use HTTPS, configure server certificates for SSL/HTTPS.

Session Recording installation files

You need the following installation files from the Citrix download page:

  • Session Recording Administration files
    • SessionRecordingAdministrationx64.msi
  • Session Recording Agent files
    • SessionRecordingAgentx64.msi
  • Session Recording Player files
    • SessionRecordingPlayer.msi

Install Session Recording Administration components

Session Recording Administration consists of the following components. You can install the components on a single server or on separate servers.

·         Session Recording Database

·         Session Recording Server

·         Session Recording Policy Console. 

Before installing the Session Recording Administration components, ensure you have all the prerequisites installed. See Session Recording Administration components.

To improve security, you can remove these permissions after installing the database.

  1. Run the Broker_PowerShellSnapIn_x64.msi file and follow the instructions to complete the installation. This installer is located in the Citrix Desktop Delivery Controller folder of the installation image.
  2. Start the Windows command prompt as an administrator and then type:

    msiexec /i SessionRecordingAdministrationx64.msi

    or double click the .msi file.
  3. On the installation UI, select Next and accept the license agreement.
  4. On the Session Recording Administration Setup screen, select the Session Recording Administration components you want to install.

Install the Session Recording Database

Before installing the Session Recording Database, ensure you have all prerequisites installed. See Session Recording Administration components.

1.     On the Database Configuration page:

  • If you are installing all Administration components on the same server, type localhost in the Session Recording Server Name field.
  • If you are installing the Session Recording Server and the Session Recording Database components on separate servers, type the name of the computer hosting the Session Recording Server in the following format: domain\machine-name. The Session Recording Server name is the user account for accessing the database.
localized image

If the database instance is not a named instance as you configured when you set up the instance, you can use only the machine name of the SQL Server. If you have named the instance, use machine-name\instance-name as the database instance name. To determine the server instance name you are using, run select @@servername on the SQL Server; the return value is the exact database instance name.

     2.   Click Test to test the connection to the SQL server. Make sure the current user account has the public SQL              Server role permission; otherwise the test lack of permissions. Then click Next to continue the installation.

     3.   Follow the instructions to complete the installation. During the installation, if the current user account is                not a database administrator, a dialog box appears, requiring the credentials of a database administrator                with sysadmin server role permission. Enter the correct credentials and click OK to continue the                                installation. The installation creates the new Session Recording Database and adds the machine account of            the Session Recording Server as db-owner.

Note: To improve security, you can remove these permissions after installing the database.

Install the Session Recording Server

Before installing the Session Recording Server, ensure that you have all prerequisites installed. See Session Recording Administration components.

  1. Enter the name of your SQL server in the Database Instance Name text box. If you are using a named instance, enter machine-name\instance-name; otherwise enter a machine-name only.
  2. Click Test to test the connection to the SQL server. Make sure that the current user account has the public SQL Server role permission. Otherwise, the test fails for lack of permissions. Then click Next to continue and follow the instructions to complete the installation.

At the end of the installation wizard, you can choose to participate in the Citrix Customer Experience Improvement Program. When you join this program, anonymous statistics and usage information is sent to Citrix. For more information, see About the Citrix Customer Experience Improvement Program (CEIP).

Configure Director to use the Session Recording Server

You can use the Director console to create and activate Session Recording policies.

  1. For an HTTPS connection, install the certificate to trust the Session Recording Server in the Trusted Root Certificates of the Director server.
  2. To configure the Director server to use the Session Recording Server, run the C:\inetpub\wwwroot\Director\tools\DirectorConfig.exe /configsessionrecording command.
  3. Enter the IP address or FQDN of the Session Recording Server and the port number and connection type (HTTP/HTTPS) that the Session Recording Agent uses to connect to the Session Recording Broker on the Director server.

Install the Session Recording Policy Console

1. On the Session Recording Administration Setup screen, select the Session Recording Policy Console to install.

localized image

2. Click Next to begin the installation. You can click Browse to change the installation path.

3. Click Finish when the installation completes.

Install the Session Recording Agent

The Session Recording Agent must be installed on the VDA for Server OS on which you want to record sessions.

  1. Use the Server Manager to install .NET Framework 3.5 and Microsoft Message Queuing (MSMQ) with HTTP support on the VDA for Server OS.
  2. Start the Windows command prompt as an administrator, and then type:

    msiexec /i SessionRecordingAgentx64.msi

    or double click the .msi file.
  3. On the installation UI, select Next and accept the license agreement.
  4. In the Session Recording Agent Configuration page, enter the name of the computer where you installed the Session Recording Server and the protocol and port information for the connection to the Session Recording Server.
localized image

     5.  The Session Recording default installation uses HTTPS/SSL to secure communications. If SSL is not           configured, use HTTP. To do so, deselect SSL in the IIS Management Console by navigating to the Session           Recording Broker site. Open the SSL settings and clear the Require SSL box.

     6. Follow the instructions to complete the installation.

Install Session Recording Player

Install the Session Recording Player on the Session Recording Server or on one or more workstations in the domain for users who view session recordings.

  • Run the SessionRecordingPlayer.msi and follow the instructions to complete the installation.

Configure Citrix Director to use the Session Recording Server

Use Citrix Director to create and activate Session Recording policies.

  1. For an https connection, install the certificate to trust the Session Recording Server in the Trusted Root Certificates of the Director server.
  2. To configure the Director server to use the Session Recording Server, run the following command:

    C:\inetpub\wwwroot\Director\tools\DirectorConfig.exe /configsessionrecording

  3. Enter the IP/FQDN of the Session Recording Server, the port number and the connection type (http/https) between Session Recording Agent and Session Recording Broker on the Director server.

Upgrade Session Recording

You can upgrade both the Agent and Player components from Version 7.6.100 to 7.6.1000.

Requirements, preparation, and limits

  • Use the Session Recording installer’s graphical or command-line interface to upgrade the existing version of both components.
  • In addition to being a domain user, you must be a local administrator on the machines where you are upgrading the Session Recording components.
  • If there are live recording sessions underway while you upgrade the Session Recording Agent, the recordings will be interrupted.
  • Review the upgrade sequence below so you can plan and mitigate potential outages.

Upgrade sequence

  1. Upgrade the Session Recording Agent (on master image).
  2. Upgrade the Session Recording Player.

Uninstall Session Recording

To remove Session Recording components from a server or workstation, use the uninstall or remove programs capability available through the Windows Control Panel. To remove the Session Recording Database, you must have the same sysadmin SQL server role permissions as when you installed it.