3.6 Retain Message Router Linux Installation

The Router should be installed on a server other than the Retain server itself.

The Retain Message Router allows devices outside your network to archive to the Retain Server without exposing the server directly to the Internet. The Router sits in your network's DMZ and routes items to the Retain Server.

This is much simpler than installing the entire Retain server system. It only requires installing the web server and the Router agent software. It uses the same installer as above.

3.6.1 Installing Retain Message Router on Linux

Prerequisites:

  • Install the web server (apache).

  • Make sure that the Router server can connect to the Retain Server.

Install:

  1. Download the latest version of Retain.

  2. Extract the archive.

  3. Open a terminal window in the Retain install folder and make the installer script executable by running the command: "chmod +x *.sh".

  4. If a previous version of Java was installed via YaST, tomcat may fail to start. Uninstall the existing Java with YaST and unset the JRE_HOME path (unset JRE_HOME).

  5. Run the installer. Enter the following command: ./RetainInstall.sh

  6. When selecting the components to install. Select yes to "Install Retain Message Router" only.

  7. Finish the install as normal.

  8. Create a data directory for the Router to use to temporarily use to store messages until they can be transferred to the Retain Server.

  9. Configure the Router in the Retain Server console under Configuration | Router Configuration Retain Message Router Configuration.

  10. The Router can be accessed by browsing to (case-sensitive): http://[IPAddress or HostName]/RetainRouter.