Connect Session Recording servers

You can connect Session Recording servers in a 1912 LTSR, 2203, or later deployment to the Session Recording service.

Before proceeding to the following steps on each server you want to connect, watch the video about connecting Session Recording servers:

Video about connecting Session Recording servers

Steps

  1. Allow outbound ports 8088 and 9090–9094.
  2. Install the Session Recording cloud client by using a command similar to the following:

    msiexec /i SRCloudClientService.msi CUSTOMERID="<Citrix Cloud customer ID>" CLIENTID="<secure client ID>" CLIENTSECRET="<secure client secret>" CUSTOMDOMAIN="<a custom domain name of the Session Recording server>" PROXYMODE="<set the value to 1 or 2>" PROXYSERVER="<http://proxy.example.com:proxy_port_number>" PROXYSCRIPT="<script address>" PROXYBYPASS="<entries separated by semicolons (;)>" /l*v "<log path>" /qn+
    <!--NeedCopy-->
    

    Where:

    • SRCloudClientService.msi installs the Session Recording cloud client that enables interaction with Citrix Cloud. Download or copy the .msi file to each Session Recording server you want to connect. To download SRCloudClientService.msi, perform the following steps:

      1. Access the Session Recording service from within the Manage tab of Citrix DaaS (formerly the Citrix Virtual Apps and Desktops service).
      2. Select Configuration > Server Management.
      3. On the Server Management page, click the Server connection guide hyperlink. The Server connection guide page appears.
      4. Download SRCloudClientService.msi.

      Note:

      The status of a Session Recording server might not change to Offline after you stop the cloud client service (CitrixSsRecCloudClientService) on it. For more information, see Configure Session Recording servers.

      Citrix collects traces from the cloud clients installed on on-premises Session Recording servers and uses the traces for troubleshooting.

    • CUSTOMERID is a required parameter. You can find the Citrix Cloud customer ID in the upper right corner of the Citrix Cloud console. You can also find it on the Secure Clients tab (Identity and Access Management > API Access > Secure Clients). For example, see the following screen capture:

      Secure clients

    • CLIENTID is a required parameter. The secure client ID is a Universally Unique Identifier (UUID) automatically generated when you create the secure client. Secure clients are used to interact with Citrix Cloud APIs.

    • CLIENTSECRET is a required parameter. The secure client secret shows only once — at the client creation time. After the secure client is created, click Download to save both the secure client ID and the secure client secret in a file.

      Saving the secure client ID and the secure client secret

    • CUSTOMDOMAIN is an optional parameter. It specifies a custom domain name with an SSL certificate binding that the Session Recording server uses for HTTPS requests. If it is not specified, the FQDN is used by default. To have the custom domain name work properly, use either of the following methods before installing the Session Recording cloud client:

      (Recommended) Method 1:

      1. On the machine where you installed the Session Recording server, open Registry Editor.
      2. Locate the following registry key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0
      3. Right-click MSV1_0 and create a multi-string value.
      4. Set the value name to BackConnectionHostNames and the value data to include your custom domain name.

        Note:

        Type your custom domain name on a separate line. If the BackConnectionHostNames registry value exists as a REG_DWORD type, delete it and recreate a multi-string value.

      5. Exit Registry Editor.
      6. Restart the machine.

      Method 2:

      Note:

      This method reduces security because it disables the authentication loopback check.

      1. On the machine where you installed the Session Recording server, open Registry Editor.
      2. Locate the following registry key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa
      3. Right-click Lsa and create a DWORD value.
      4. Set the value name to DisableLoopbackCheck and the value data to 1.
      5. Exit Registry Editor.
      6. Restart the machine.
    • PROXYMODE is an optional parameter. Set the value to 1 or 2 to enable a manual or automatic proxy setup for the Session Recording service, respectively. If you leave the parameter unspecified, the default value is 0, which means proxy is disabled.

    • PROXYSERVER is an optional parameter. However, if you set PROXYMODE to 1, this parameter is required. It specifies the proxy server name or IP address and the proxy port number. For example, http://proxy.example.com:proxy_port_number.

    • PROXYSCRIPT is an optional parameter. It specifies the proxy script address, for example, https://node-cluster143516-swg.ibosscloud.com/95rc2MBacUpwBGI/v2/proxy.pac. If you leave the parameter unspecified, proxy auto-detection takes effect.

    • PROXYBYPASS is an optional parameter. Use the proxy server except for addresses that start with the entries you specify, separated by semicolons (;).

    • /l*v is an optional parameter. It specifies verbose logging.

    • /qn+ is a required parameter. It specifies a silent install with a user prompt at the end.

    After the Session Recording cloud client completes installation, the target server is connected to the Session Recording service. Click Refresh on the Server Management page to update the list of connected servers. It might take a few minutes for your servers to be detected.

    Refresh server

Server management

You can manage Session Recording servers by load-balancing them across multiple sites. A site can contain multiple Session Recording servers that connect to the same Session Recording database.

After you connect a Session Recording server to the Session Recording service, the server is automatically grouped to the site connected to the same Session Recording database. If no such site is available, the server becomes a site itself and the site name is the name of the server.

You can perform the following actions for server management:

  • Create and edit sites with custom names and descriptions.
  • Expand sites to access Session Recording servers in them.
  • Drag and drop Session Recording servers to different sites. You can also change a server’s site by clicking the Settings icon of the server. The Settings icon is present only for available servers.
  • Configure server settings. For more information, Configure Session Recording servers.
Connect Session Recording servers