Retain Linux Install

Multiple Disks

Create multiple disks to follow Retain best practices. This is optional but recommended.

1. Create the disks in the VM software
2. Format the disks in the VM itself using YaST/Partitioner, these values should be large enough for a few million small messages
   • • ARCHIVE (60-80GB)
     • INDEX (15-30GB)
     • LOGS (6-15GB)
     • DATABASE (20-40GB)

Prerequisites

Database

For Retain 3.x you need to manually download and install a database. Retain 4.x will automatically download and install MySQL 5.6.

Install MySQL

1. Create a directory and download it
2. md /software/mysql directory and change to it
3. download MySQL Community Server 5.5.42 [1] direct? [2] to that mysql directory
   • wget "http://dev.mysql.com/get/archives/mysql-5.5/MySQL-5.5.42-1.sles11.x86_64.rpm-bundle.tar"
   1. Extract the MySQL client and MySQL server or just untar the whole thing
   • tar -xf MySQL-5.5.42-1.sles11.x86_64.rpm-bundle.tar

Webserver

All versions of Retain need a webserver installed, which tomcat will be installed onto.

Install HTTP Server

1. Install http server (apache2) from YaST
2. If connecting to Exchange:
   1. Set DNS to Exchange server, in YaST/Network Settings

The Retain installer will download Java and MySQL if you wish.

Install

Download Retain

1. Create Retain download directory
   1. • md /software/retain[version] directory and change to it
   2. download the current version of Retain [3] or the beta.
      • wget "http://download.gwava.com/download.php?product=Retain&version=current"
      • wget "http://download.gwava.com/download.php?product=Retain&version=beta"
2. Unzip Retain
   1. • chmod +x *.sh

Install Retain

1. ./RetainInstall.sh Retain 4 requires extensive resources the lab doesn't have, see your mentor about provisioning.
2. install modules:
   • Retain Server
   • Reporting & Monitoring
   • Worker
   • Skip Stubbing as very few customers use that functionality
   • Skip the Router as that should be installed on its own server in the network DMZ
3. setup database, using MySQL
   • give it the path from above
   • give mysql root user a password (remember this)
   • create a database, username and password
4. take the defaults
5. If using multiple disks:
   1. Stop tomcat rcretain-tomat7 stop
   2. Change ownership on INDEX and LOGS to chown -R tomcat:tomcat /[volume]
   3. Change permissions on INDEX and LOGS to chmod -R 774 /[volume]
   4. Change ownership on DATABASE to chown -R mysql:mysql /DATABASE
   5. Change permissions on DATABASE to chmod -R 774 /DATABASE
   6. Change ownership on ARCHIVE to chown -R tomcat:tomcat /ARCHIVE
   7. Change permissions on ARCHIVE to chmod -R 777 /ARCHIVE
      1. Start tomcat rcretain-tomat7 start
6. Otherwise, configure the server.

Return to Retain Training