2.1 Preparing to Upgrade to 4.10

2.1.1 Prerequisites for Upgrading to 4.10

Before starting the upgrade processes, Micro Focus recommends that you make sure you have the requirements for a Retain 4.10 system, as outlined in System Requirements in Retain 4.10: Planning.

2.1.2 Using Sections That Show Two Starting Versions

Sections with two possible starting points, such as Upgrading from 4.5 (or 4.4) to 4.7.0.1, indicate that you can upgrade directly from either of the listed versions. For example, if you are running Retain 4.4, you can move directly to 4.7.0.1. You need not upgrade to 4.5 first.

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 isn’t 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 3.5.1.1

    jdk-6u38-linux-x64.bin

    1. On the Retain server that you are upgrading, create the following path:

      /opt/beginfinite/retain/java6

    2. Move the downloaded file to the java6 directory.

    3. Make the file executable.

    4. Open a terminal prompt, navigate to the java6 directory, and run the file by entering:

      ./jdk-6u38-linux-x64.bin

    5. Press Enter when prompted.

    6. Continue with 2.6.2 to 3.5.1.1 on SLES

    Linux 4.5

    server-jre-8u162-linux-x64.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 4.7.0.1

    OpenJDK10_x64_Linux_jdk-10.0.2.13.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 4.10

    OpenJDK11U-jdk_x64_linux_hotspot_11.0.8_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.

IMPORTANT:For Retain 3.5.1.1 and 4.7.0.1, you must manually extract Java and create or update three Retain System Variables, as outlined in the steps and tables that follow.

For Retain 4.5 and 4.10, you can either

  • Manually extract Java and set the system variables, like the other two Retain versions.

    Or

  • Copy the required Java file to the server before you run the installer (see the first two columns of the table in Step 1).

    In that case, extracting the file and setting environment variables is not required.

  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

    3.5.1.1

    jdk-6u38-windows-x64.zip

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

    4.5

    jdk-8u162-windows-x64.zip

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

    4.7.0.1

    OpenJDK10_x64_Windows_jdk-10.0.2.13.zip

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

    4.10

    OpenJDK11U-jdk_x64_windows_hotspot_11.0.8_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 3.5.1.1
    • RETAIN_JAVA_HOME
    • C:\Program Files\Beginfinite\Retain\Java6\jdk1.6.0_38
    • RETAIN_JAVA_VERSION
    • 1.6
    • RETAIN_JRE_HOME
    • C:\Program Files\Beginfinite\Retain\Java6\jdk1.6.0_38\jre
    • Retain 4.5
    • RETAIN_JAVA_HOME
    • C:\Program Files\Beginfinite\Retain\Java8\jdk1.8.0_162
    • RETAIN_JAVA_VERSION
    • 1.8
    • RETAIN_JRE_HOME
    • C:\Program Files\Beginfinite\Retain\Java8\jdk1.8.0_162/jre
    • Retain 4.7.0.1
    • RETAIN_JAVA_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-10.0.2+13
    • RETAIN_JAVA_VERSION
    • 1.10
    • RETAIN_JRE_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-10.0.2+13
    • Retain 4.10
    • RETAIN_JAVA_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-11.0.8+10
    • RETAIN_JAVA_VERSION
    • jdk-11.0.8+10
    • RETAIN_JRE_HOME
    • C:\Program Files\Beginfinite\Retain\Java\jdk-11.0.8+10
  3. When you run the Retain installer, it recognizes that Java is already installed.