4.4 Upgrading Retain 4.6 or Earlier to Retain 4.7

Upgrading a server directly to Retain 4.9 that is running Retain 4 at version 4.6 or earlier is not supported.

You must do the following:

  1. Upgrade the 4. x server to Retain 4.7 using the instructions in this section.

  2. Complete the instructions in Upgrading Retain 4.7.0 to 4.9, which includes downloading and applying the Retain 4.7.0.1 patch.

4.4.1 Upgrading to 4.7

Upgrading to Retain 4.7 from 4.0 and later should take between 15 and 30 minutes, depending on the size of the system. However, very large systems may take longer.

  1. Log in to the Micro Focus Customer center and download Retain 4.7.

  2. Extract the archive into a new folder.

    On Linux, on the desktop right click the downloaded file and select Extract Here, or at a terminal prompt, type unzip downloaded-file-name.zip

    On Windows, right click the downloaded file and select Extract All...

  3. If on Linux, open a terminal window in the Retain install folder and make the bash script file executable by running the command: chmod +x *.sh.

  4. Run the installer:

    On Linux: ./RetainInstall.sh.

    On Windows: RetainInstall.exe.

  5. The installer checks for the correct Tomcat version and upgrades to Tomcat 8.0 if needed.

    Click Next.

  6. The installer detects the server’s Retain components and reports what it found. Then it asks whether you wish to upgrade the current installation, upgrade and add new components, or exit the installer.

  7. If you chose to add components, you are prompted to do that next.

  8. The installer then asks whether you want to keep or discard the existing configuration during the upgrade. Neither option erases any archived data.

    Discarding the configuration can be useful in certain troubleshooting circumstances. Otherwise, we recommend keeping the existing configuration (Option 1).

  9. Retain installation begins. Wait until it finishes, then continue with the next section.

4.4.2 Post-Install Tasks

  1. Browse to Retain Web Console.

  2. If you are upgrading from a version prior to Retain 4.2, a Retain Database Migration popup displays. Click the Enter Credentials button and enter the administrator account username and password. Click the <???> button to start the migration.

    1. Do not interrupt the database migration process.

    2. Then the migration finishes, the system prompts you to restart tomcat.

    3. Once the update has completed, restart tomcat to initiate the new database.

    4. Because the database must be initialized, restarting tomcat takes a little longer than usual.

    5. After Tomcat restarts, open the Retain Management interface.

  3. If you have the GroupWise module configured, be aware that GroupWise timestamp usage has changed.

    1. A warning page describes what happens next.

    2. Enter the admin credentials.

    3. Choose which timestamp flag Retain uses in the Module.

    4. In versions earlier than Retain 4.2, the update takes some time and the Retain interface is not be available until the process completes.

      In Retain 4.2, the update process happens in the background and the interface is available immediately.

      In both cases, jobs are disabled until the process completes.

    5. In versions earlier than Retain 4.2, you must restart Tomcat when the process completes.

      In Retain 4.2 and later, restarting Tomcat is not needed.

      The jobs schedule resumes when the process is complete.

  4. Log in to the Retain Management interface.

  5. The upgrade is complete.