2.1 Preparing to Upgrade Retain

2.1.1 Prerequisites for Upgrading Retain

Before starting the upgrade processes, OpenText recommends that you ensure your system meets the requirements as outlined in System Requirements in Planning.

2.1.2 Preparing to Upgrade

Table 2-2 Preparing to upgrade

Task

Details

Ensure that the Retain server is connected to the Internet

Verify that the Retain server is connected to the Internet, so that the installer can install OpenJDK 17.

If your server isn’t connected to the Internet, see Installing Java on a Server with no Internet Connection.

Ensure that SMTP Is Working in Retain

The installer must be able to email status messages to the configured SMTP account. Otherwise, it will stop and display an error message.

Get software

  1. Using your OpenText Customer Center account, download the latest version of the Retain installation.zip file.

  2. Copy the file and unzip/extract it on the following:

    • The Retain server that you are upgrading.

    • Every server that is running a Retain Worker or other component.

  3. (SLES) Open a terminal, navigate to the extracted folder, run the following command to make the script files executable:

    chmod +x *.sh

Ensure Adequate RAM

Make sure that the Retain server has at least 12 GB RAM.

Back up the Database and the Retain Server

The upgrade should run smoothly. However, best practice always dictates backing up systems before making major changes.

Back up your database and the Retain server immediately before starting the upgrade. After completing the backup, proceed with Upgrading Retain.

2.1.3 Installing Java on a Server with no Internet Connection

By default, the Retain installation program uses an Internet connection to download a specific version of Java for each version of Retain. If the Retain server is not connected to the Internet, you must prepare the server with a workaround beforehand. Otherwise, the installation fails.

The following sections outline the preparation steps for each Retain version in the supported upgrade path as well as for installing the current Retain release.

Linux Servers

Prepare your Linux Retain server by using the information in the row that matches your target version.

  1. On a workstation with an Internet connection, use the links in the following table to download the linked Java version that applies to your upgrade target. Then refer to the Action column for further instructions.

    Retain Platform and Version

    Download and Copy These Files to Each Retain Server

    Action

    Linux 25.2, 24.4, 24.2, 24.1 and 23.4

    OpenJDK17U-jdk_x64_linux_hotspot_17.0.6_10.tar.gz

    1. When prompted about the missing JDK file, select option 3 and enter the path to the folder containing the file that you previously copied to the server.

    2. Continue with the upgrade process.

    Linux 23.3 and earlier

    See Linux Servers in Installation and Upgrade

    See Linux Serversin Installation and Upgrade

Windows Servers

Prepare your Windows Retain server by using the information in the row that matches your target version.

  1. On a workstation with an Internet connection, use the links in the following table to download the linked Java versions that apply to your upgrade path. Then refer to the Action column for further instructions.

    Retain Version

    Download and Copy These Files to Each Server

    Action

    Retain 25.2, 24.4, 24.2, 24.1 and 23.4

    OpenJDK17_x64_windows_jdk-17.0.6_10.zip

    Extract the files to this location: C:\Program Files\Beginfinite\Retain\Java

    Retain 23.3 and earlier

    See Windows Servers in Installation and Upgrade

    See Windows Servers in Installation and Upgrade

  2. After extracting the files, before running the Retain installer, edit the system’s Environment Variables to reflect the values indicated for the version you are upgrading to.

    Retain Target Version

    Variable Name

    Value
    • Retain 25.2, 24.4, 24.2, 24.1 and 23.4
    • RETAIN_JAVA_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-17.0.6_10
    • RETAIN_JAVA_VERSION
    • jdk-17.0.6_10
    • RETAIN_JRE_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-17.0.6_10
    • Retain 23.3 and earlier
    • RETAIN_JAVA_HOME

     
    • RETAIN_JAVA_VERSION

     
    • RETAIN_JRE_HOME

  3. When you run the Retain installer, it recognizes that Java is already installed.