Retain Router Configuration

The Retain Router allows Retain to connect to mobile devices, BBM (BlackBerry Mobile), and REST.

The Retain Router is installed on a separate server usually in the network DMZ so it has access to the internet.

Retain Server Prerequisites

On the Retain Server, go to Server Configuration. Under the Communications tab and in the Retain Server Connection section:

• Fill out "Retain Server Host". This is the Retain Server IP address or hostname
• Set the Server Protocol and Port. This needs to match Router Configuration below

For testing, you may set it to http with the port set to 48080.

Configure the Router

• Click on Router Configuration
• Host is the IP address or hostname of the Router server
• Port 443 if security is set to SSL, or 48080 if set to Plaintext. This should match the Server Configuration above
• Under the Storage tab, set the Storage Path

Install Retain Router

Prerequisites

• For Retain 4.x the Router requires a server with 8G of RAM
• Install a web server as you did for the Retain Server

Download and Run Installer

• Download the RetainInstall package or copy the one you used to install the Retain Server to the Router server
• Extract the zip file
  • (In Linux) change permissions: chmod +x *.sh
• Run RetainInstall
• Select only the Retain Router

The installer will install java and tomcat.

Access the Retain Server Console

• Open a tab and browse to your Retain Server Console
• Click on Router Configuration
• Click the Test Connection button

Access the Retain Router Console

• Open a tab and browse to the Retain Router Console (http://localhost/RetainRouter
• Log in with admin credentials

If you cannot log in make sure that the Retain Server/Server Configuration/Communications/Retain Server Host is filled out.

---

Return to Retain Training