2.2 Upgrading Retain

Use the instructions in the following sections to upgrade Retain.

2.2.1 Upgrading Retain on SLES

If you are upgrading Retain on a Windows server, go to Upgrading Retain on Windows.

Table 2-3 Upgrading Retain on SLES

Installation Section

Details

Stop Retain before Upgrading

  1. On the Retain server, open a terminal prompt.

  2. Stop Retain by stopping the Apache Tomcat service.

    For example, on SLES 12 or SLES 15 enter the following command:

    systemctl stop retain-tomcat.service

Run the Retain Installation

At the terminal prompt, navigate to the folder that you prepared in Get software, then enter the following command:

./RetainInstall.sh

License Agreement

Scroll through the license agreement, then type 1 and press Enter.

Software and RAM Requirements

The Linux install lists the software and RAM requirements.

Press Enter to continue.

Retain Components Selection Page

The install displays the Retain components that are already installed on the server.

  1. If you want to upgrade only the listed components, enter 1.

  2. If you want to also install additional components, enter 2, then enter y for the components you wish to add to the server.

Pre-requirements Status

The install checks for OpenJDK 17 and an updated version of Tomcat 10. If they are not installed, it installs and configures them for Retain.

NOTE:The Java and Tomcat verification/installation process can take a while, so be patient while the installation works in the background.

The installation process extracts and installs Retain.

Next, it starts the system processes that Retain requires.

Finally, a message reminds you to consult the documentation.

When the system prompt displays, wait a few moments to make sure all the components are running.

2.2.2 Upgrading Retain on Windows

If you are upgrading Retain on a SLES server, go to Upgrading Retain on SLES.

Table 2-4 Upgrading Retain on Windows

Dialog/Section

Details

Stop Retain before Upgrading

  1. On the Retain server, click Start > Administrative Tools > Services (or the equivalent on your version of Windows Server).

  2. Stop Retain by stopping the Retain Tomcat service.

Run the Retain Installation

In the folder that you prepared in Get software, right click RetainInstall.exe and select Run as Administrator.

Welcome to the Retain Setup Wizard

Click Next.

Software Requirements

The install lists the software and hardware requirements along with the software that it will install.

Click Next.

License Agreement

Accept the agreement and click Next.

Select Destination Location

  1. If you want to install the upgraded Retain components in a non-default location, use the Browse button to change the path.

  2. Click Next.

Retain Components Selection Page

The install displays the components that are already installed on the server.

  1. If desired, you can select additional components for installation.

  2. Click Next.

Pre-requirements Status

  1. The install checks for OpenJDK 17 and an updated Tomcat 10. If they are not installed, it indicates that they will be.

  2. Click Next.

    If needed, the install runs the OpenJDK 17 installation and updates Tomcat.

    Click through any security alerts or other dialogs to allow the process to run to completion.

Information

The install reminds you to consult the documentation.

  1. Wait a few moments to make sure all components have finished installing.

  2. Click Next.

General Information

A message shows the Retain access URL.

Click Next.

Completing the Retain Setup Wizard

Click Finish.