Upgrading Relativity to .NET 4.7.2 or 4.8.
Beginning in Server 2022 you must upgrade your Relativity environment to .NET 4.7.2 or 4.8. The updates must be applied to Relativity servers and client machines.
Relativity Server 2022 does not support .NET 4.8.1 or any subsequent versions.
Note: Existing custom applications are compatible with Server 2022 and do not need to be recompiled, but you must upgrade your development environment to use the latest versions of Relativity SDKs.
All servers
Perform these steps on all servers in your Relativity environment:
- Download the .NET 4.7.2 or 4.8 installer from:
- https://dotnet.microsoft.com/download/dotnet-framework/net472 for 4.7.2. The downloaded file name is ndp472-kb4054531-web.exe
- https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48 for 4.8. The downloaded file name is ndp48-web.exe.
- Run the ndp472-kb4054531-web.exe or ndp48-web.exe executable and follow the instructions in the installation wizard.
- Turn off applications when prompted by the installation wizard.
- Restart the server on completion.
Client machines
Perform these steps on all systems running Relativity and Invariant client applications (Relativity Desktop Client and Relativity Processing Console):
- If you don't have the Microsoft Visual C++ 2015 Redistributable already installed, download it from https://www.microsoft.com/en-us/download/details.aspx?id=53840.The download provides both 32- and 64-bit options. Select an executable depending on your system word size.
- Run the Microsoft Visual C++ 2015 Redistributable executable and follow the instructions in the installation wizard.
- Download the .NET 4.8 installer from https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48.The downloaded file name is ndp48-web.exe.
- Run the ndp48-web.exe executable and follow the instructions in the installation wizard.
- Turn off applications when prompted by the installation wizard.
- Restart the machine on completion.
- Download and install the latest versions of ActiveX viewer, RDC, and RPC.
Relativity applications
Backward-compatible applications
Going forward, regardless of current Relativity version, if you install new .NET 4.7.2 or 4.8-based versions of backward-compatible Relativity applications, you must upgrade your environment to .NET 4.7.2 or 4.8 as described above.
Backward-compatible applications include Data Grid, ARM, Relativity User Import, etc.
Custom applications built with the Relativity SDK
Custom applications that Relativity does not own or maintain can continue to target their current .NET version and will work in the new .NET 4.7.2 or 4.8-based Relativity. You can continue developing with older versions of the Relativity SDKs if you don't need the new features in latest version.
To develop using the latest Relativity SDK, you must update the applications' projects to target .NET 4.7.2 or 4.8. The developers must also update their environment to the .NET 4.7.2 or 4.8 Developer Pack as described below.
Development environment
If you develop custom Relativity application, you must update your development environment to use the latest version of the SDK:
- Download the Microsoft .NET Framework 4.7.2 or 4.8 Developer Pack from:
- https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net472-developer-pack-offline-installer for 4.7.2. The file name is ndp472-devpack-enu.exe.
- https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net48-developer-pack-offline-installer for 4.8. The file name is ndp48-devpack-enu.exe.
- Run the ndp472-devpack-enu.exe or ndp48-devpack-enu.exe executable and follow the instructions in the installation wizard.
- Turn off applications when prompted by the installation wizard.
- Restart the machine on completion.