2.1 Preparing to Upgrade to 23.4 and Later

2.1.1 Prerequisites for Upgrading to 23.4 and Later

Before starting the upgrade processes, OpenText recommends that you make sure you have the requirements for a Retain 23.4 or later system, as outlined in System Requirements in OpenText Retain CE 24.1: Planning.

2.1.2 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 4.11

    OpenJDK11U-jdk_x64_linux_hotspot_11.0.16+8.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.2

    OpenJDK11U-jdk_x64_linux_hotspot_11.0.17+8.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, 23.4, and later

    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.

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 4.11

    OpenJDK11U-jdk_x64_windows_hotspot_11.0.16_8.zip

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

    Retain 23.2

    OpenJDK11_x64_windows_jdk-11.0.17_8.zip

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

    Retain 23.3, 23.4, and later

    OpenJDK17_x64_windows_jdk-17.0.6_10.zip

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

  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_JRE_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-10.0.2+13
    • Retain 4.11
    • RETAIN_JAVA_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-11.0.16+8
    • RETAIN_JAVA_VERSION
    • jdk-11.0.16+8
    • RETAIN_JRE_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-11.0.16+8
    • Retain 23.2
    • RETAIN_JAVA_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-11.0.17+8
    • RETAIN_JAVA_VERSION
    • jdk-11.0.17+8
    • RETAIN_JRE_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-11.0.17+8
    • Retain 23.3, 23.4, and later
    • 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

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