Upgrading or installing your Analytics server

Note: Make sure you review the Analytics upgrade considerations before upgrading Analytics. For more information, see Upgrade considerations for Relativity Server 2021.

An upgrade of your Analytics server is required for Relativity Server 2021. Follow these steps to upgrade your analytics server(s). Before upgrading the Analytics server(s), make sure you've completed the steps contained in the following sections:

  1. Install or upgrade your Relativity instance by performing the required steps (see Relativity installation).
  2. Perform a Pre-installation check of the Analytics server.

This page contains the following information:

Installing and upgrading Analytics

You need the following items in order to successfully run the Analytics upgrade or installation:

  • The primary database server instance name and corresponding EDDSDBO password. If your SQL Server uses SSL encryption, see Installing Analytics server when SQL Server uses SSL encryption before beginning the Analytics server installation.
  • The Relativity Service Account username and password.
  • All SQL Servers must be active and accessible at the time of the installation.
  • A self-signed or a trusted SSL certificate with the certificate's private key is required by Relativity Analytics. We recommend using the certificate that Relativity Secret Store generates. For more information, see Relativity Secret Store.

Special considerations

  • Before attempting an upgrade, stop all Analytics engine processes (i.e., ensure that all Java and Postgres processes are stopped). In versions previous to, the Windows Service will be called Content Analyst CAAT. In Relativity and above, the service will be called Analytics Engine. After you do this, back up the CAAT install directory and the CAAT data directory. If something goes wrong with the upgrade, this will greatly reduce any downtime spent to fix the problem.
  • The Analytics Index Share houses all of your Analytics data for a particular Analytics server, and it can grow to be very large. We have found that NTFS file systems work for small environments, but if you anticipate running sets of 10 million or more documents through your Analytics Engine, you should use a file system that supports larger files such as exFAT or ReFS. We do not have a recommendation for either file system, so you must determine which is the better fit for you.
  • For Relativity Server 2021, the Analytics upgrade includes an updated version of Postgres, which is installed in the background. For more information, see Upgrading to Relativity Server 2021 from Relativity 9.3.362.9 (CAAT 3.19) and above.

This section contains the following content:

Installing Analytics for the first time to Relativity and above

Upgrading to Relativity Server 2021 from Relativity 9.3.362.9 (CAAT 3.19) and above

For Relativity Server 2021, the Analytics upgrade includes an updated version of Postgres, which is installed in the background. Review the following guidelines for applying this upgrade:

  • Ensure that the Users group has Full Control permissions on the install and data directories.
  • Ensure that you have Microsoft Visual C++ Redistributables 2010/2012/2013/2015 (x64 and x86) installed. For download links, see Microsoft's support site.
  • Ensure that you have adequate disk space for the upgrade. A new pgsql folder is created as part of the upgrade, which temporarily doubles the disk usage while both versions of Postgres are installed on the server. The caat.pg.upgrade-in-place and caat.overrideDiskSpaceCheck properties provide additional configuration options for upgrading. See Setting properties in the response-file.properties file (for upgrading to Relativity Server 2021).
  • The upgrade may take longer than normal as the existing Postgres data needs to be converted.
  • After applying the upgrade, we recommend running the Structured Analytics portion of the Post-installation verification test document. For more information, see Post-installation verification test.

After you apply the upgrade and verify all Analytics components are functioning correctly, delete the old Postgres install directory from the following location to complete the uninstall:


Upgrading from Relativity 9.3.332.21 (CAAT 3.17) or prior

Note: If you are upgrading from Relativity 9.3.332.21 (CAAT 3.17) or lower, contact Relativity Support at support@relativity.com.

Updating the default SSL/TLS certificate

Verifying the Analytics server in Relativity

Disabling old TLS protocols and specifying cipher suites (optional)

When setting up Analytics, you have the option of disabling TLS 1.0 and 1.1 to enforce stricter security protocols. Additionally, you can specify which cipher suites you want to use or block.

To do this, complete the following steps:

  1. Search for C:\CAAT\etc\ssl\tweak-ssl.xml. Create or update it as follows.
    1. If the file already exists, append the following lines:

    2. If the file does not exist yet, create a new XML file with that name and file path. Enter the following full text:

  2. To specify allowed or excluded cipher suites, append the following to C:\CAAT\etc\ssl\tweak-ssl.xml. This step is optional.

    Note: The cipher suites used in this sample text are examples only. We do not currently endorse specific cipher suites, and we recommend discussing preferred suites with your security team.

  3. Open `C:\CAAT\start.ini`. Look for the tweak-ssl.xml file path. If it's not listed yet, append it to the bottom as follows:

    ## Override SSL configuration file 

    Note: If you don't have a file called start.ini, do not create a new one. Instead, contact our Support team at support@relativity.com.

  1. Restart the Content Analyst (CAAT) Windows service.

  2. Update the registry key on all web and agent servers as follows. If you previously disabled TLS 1.0 and 1.1 for other parts of Relativity, you can skip this step.

    1. Create or update the following registry keys on each server as shown below. You should be able to create a *.reg file out of the snippet below.
    2. Windows Registry Editor Version 5.00 
    3. Restart IIS or the agent service on each applicable server.
  1. Verify that the connection works by clicking Save in the Analytics Server layout.

Installing Analytics server when SQL Server uses SSL encryption

Changing the REST password

Uninstalling the Relativity Analytics server

We don't recommend uninstalling the Relativity Analytics Server application for any reason as it causes data loss. If you uninstall the Relativity Analytics Server application from the analytics server, all structured analytics sets created in Relativity 8.2 and above can't be used with another installation. There is no way to merge a previous Relativity Analytics Server installation with a new installation. As a result, structured analytics sets created in Relativity 8.2 and above become unusable.

You shouldn't uninstall the application from the server unless you're certain you won't use the server for Analytics functionality in the future, and you understand that uninstalling Relativity Analytics renders structured analytics sets created in Relativity 8.2 and higher unusable.

If you still need to uninstall the Relativity Analytics components from the server, complete the following steps: