2.4 Upgrading from 4.5 (or 4.4) to 4.7.0.1

The following points apply to Retain 4.7.0.1:

It prepares the message store database for a schema change that Retain 4.9.2 implements.
It contains an important upgrade to the Retain indexer.
It facilitates an immediate upgrade to 4.9.2 through a new Optimize Index Now button.

2.4.1 Preparing to Upgrade to 4.7.0.1

Table 2-12 Preparing for Retain 4.7.0.1

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 upgrade Java to the correct version. 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 the 4.7.0.1 software	Download the Retain 4.7.0.1 .zip file. 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. (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.

2.4.2 Upgrading to 4.7.0.1 (SLES)

If you are upgrading Retain on a Windows server, go to Upgrading to 4.7.0.1 (Windows)

Table 2-13 Upgrading to 4.7.0.1 on SLES

Installation Section	Details
Stop Retain before Upgrading	On the Retain server, open a terminal prompt. Stop Retain by stopping the Apache Tomcat service. For example, on SLES 11 enter the following command: rcretain-tomcat8 stop
Run the Retain 4.7.0.1 Installation	At the terminal prompt, navigate to the folder that you prepared in Get the 4.7.0.1 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 4.7.0.1 software and RAM requirements. Press Enter to continue.
Retain Component Selection	The install displays the Retain components that are already installed on the server. If you want to upgrade only the listed components, enter 1. If you want to also install additional components, enter 2, then enter y for the components you wish to add to the server.
Java, Tomcat, and Apache	The install checks for Java 10 and Tomcat 8.5. 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 install then verifies that a supported version of Apache is installed. NOTE:If desired, you can review the actions just taken by scrolling through the displayed text before continuing.
Overwrite or Upgrade Retain	The install displays the location of the existing Retain installation and gives three options. You want to upgrade Retain and keep the current configuration Type 1 and press Enter.
Upgrade the Retain Components	The installation process extracts and installs Retain 4.7.0.1. 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, then continue with Upgrading from 4.7.0.1 to 4.9.2.

2.4.3 Upgrading to 4.7.0.1 (Windows)

If you are upgrading Retain on a SLES server, go to Upgrading to 4.7.0.1 (SLES)

Table 2-14 Upgrading to 4.7.0.1 on Windows

Dialog/Section	Details
Stop Retain before Upgrading	On the Retain server, click Start > Administrative Tools > Services (or the equivalent on your version of Windows Server). Stop Retain by stopping the Apache Tomcat 8 service.
Run the Retain 4.7.0.1 Installation	In the folder that you prepared in Get the 4.7.0.1 software, right click RetainInstall.exe and select Run as Administrator.
Welcome to the Retain Setup Wizard	Click Next.
Software Requirements	The install lists the 4.7.0.1 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	If you want to install the upgraded Retain components in a non-default location, use the Browse button to change the path. Click Next.
Retain Components Selection Page	The install displays the components that are already installed on the server. If desired, you can select additional components for installation. Click Next.
Pre-requirements Status	The install checks for Java 10 and Tomcat 8.5. If they are not installed, it indicates that they will be. Click Next. The install runs the Java 10 and Tomcat 8.5 installations and configurations. Click through any security alerts or other dialogs to allow the process to run to completion.
Choose a Web Server	Select the Web server that Retain uses. If you use IIS, click Next and skip to the next row. If you use Apache, Browse to and select where it is installed. Click Next. If needed, adjust the AJP port. Click Next.
Overwrite or Upgrade Retain	Leave the Upgrade option selected. Click Next.
Ready to Install	Click the Install button. The installation process extracts and installs Retain 4.7.0.1. Then it starts the required system processes.
Information	The install reminds you to consult the documentation. Wait a few moments to make sure all components have finished installing. Click Next.
General Information	A message shows the Retain access URL. Click Next.
Completing the Retain Setup Wizard	Click Finish. The upgrade to Retain 4.7.0.1 is complete.