Reload for Retain

Retain is an archiving program. Over time, items will be removed from the email system. So the email system and the archive will not match and the archive will have things that no longer exist in the email system. Now there is only a single copy of important items. Retain is a very large system that can be challenging to backup.

Reload for Retain was created to make backing up Retain easy and fast.

Most backup systems have to check each and every item on the Retain server, which can be tens or hundreds of billions of files spread across 16.7 million subdirectories. Reload for Retain is able to just backup the new items without scanning everything.

Design

Reload for Retain is made up of 2 parts:

• Reload Server
• Reload of Retain Agent

The Reload server must be on the SLES Linux OS platform.

The Reload of Retain Agent is also Linux based. It can be run on the Reload server or the Retain server.

Prerequisites

• Install Reload
• Apply the license
• Install Retain to the Reload server. Only install Retain, Reload will copy over the configuration files from the production Retain server.
  • WARNING: ONCE YOU HAVE INSTALLED THE RETAIN SERVER, DO NOT RUN THE WEB-BASED CONFIGURATION WIZARD FOR RETAIN. IT WILL DELETE THE CONTENTS OF YOUR PRODUCTION RETAIN DATABASE.
  • Install the exact version of Retain on the Reload server as is running on the Production Retain Server. Most customers using Retain on Linux have the version of Retain installed on their Production Retain Server sitting somewhere in an installation directory on the Retain Server. Locate the software there.
    • IMPORTANT: Make sure to match the tomcat identity of the Reload for Retain Server to match exactly with the tomcat identity of the Production Retain Server. See the GWAVA Knowledgebase Article: Moving Retain To New Server (Linux to Linux) [1] and read and implement on the Reload for Retain Server the section that states: Change the tomcat userid on the new server to match the tomcat userid on the old server (if necessary). [2]
  • For customers using MySQL as their database for Retain, make sure to install the exact same version of MySQL on the Reload for Retain Server as is installed on the Production Retain Server. Make sure to install the appropriate MySQL Server and MySQL client. To obtain older MySQL versions go the Archives location on the MySQL website. Use the following command to determine the version of MySQL that is installed: mysqlshow -V
    • MySQL Configurations Only: Make sure to create a new MySQL database on the Reload for Retain Server. This will allow the MySQL database backup created by the Reload for Retain Agent to be imported into a database on the Reload for Retain Server.
    • MSSQL and Oracle databases: Fill in the database information to reflect the database connectivity to the database server that hosts your Retain database.
  • From the production server, copy the ASConfig.cfg file from the Production Retain Server to the Retain installation that is hosted on the Reload Server. The destintation location to put the ASConfig.cfg file on the Reload Server is:

/opt/beginfinite/retain/RetainServer/WEB-INF/cfg

• Go into Reload Web Administration on the Reload Server. Fill in the settings under both the Configure Disaster Recovery button, and also under General Settings | Local Retain Settings. The settings you make will then be added to the ASConfig.cfg file that you copied over in the steps above.