Difference between revisions of "Retain Linux Install"

Revision as of 18:48, 26 April 2016

Retain 3.5

Prerequisites for Retain 3.5:

Additional Disks

1. Create additional disks for Retain best practices
   • Create the disks in the VM software
   • Format the disks in the VM itself using YaST/Partitioner
   1. • ARCHIVE
      • INDEX
      • LOGS
      • DATABASE (if local)

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

Install MySQL

1. 1. • Create a directory and download it
      • md /software/mysql directory and change to it
   2. 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"
   3. 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

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

1. ./RetainInstall.sh
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.

Server Configuration

1. Browse to [retain server]/RetainServer
2. If using a single disk, take the defaults
3. Otherwise, use advanced options to specify multiple disks.
4. Set DB User to retain
5. Set DB ROOT User to root
6. Set Search engine to Lucene

Retain Configuration

Reporting and Monitoring Configuration

1. Click on Reporting and Monitoring Configuration
   1. Core Settings:
      1. Enable: Disable the disk usage statistics
      2. Enable: Disable the number of messages statistics
   2. Connection:
      1. Set server host names to IP or domain name, not localhost
   3. Save bootstrap
   4. Click on Reporting and install bootstrap

Module Configuration

1. Module Configuration and set up a module
   1. GroupWise
      1. Go to GWAdmin
      2. Go to System/Trusted Applications
         1. Create new: Retain
         2. Copy Trusted Application Key (save someplace safe)
      3. Go to Retain/Module Configuration/GroupWise
         1. SOAP:
            1. Copy Trusted Application Key to field
            2. Set POA Host name to IP|domain name of post office
            3. Test Connection
            4. Save Changes

Job Configuration

1. Create Initial Dredge Schedule
   1. Single for Initial Dredge
   2. Save Changes
2. Create Initial Dredge Profile
   1. Scope tab:
      1. All Messages
      2. Try to publish all messages (SLOW)
      3. Enable Retention and Item Store Flag
      4. Save Changes
3. Create Worker
   1. Local Worker is good, if the worker is remote name it after the server it is on.
   2. Polling:
      1. Poll for configuration every 60 minutes is usually enough
   3. Logging:
      1. Diagnostic (so we don't have to try to reproduce the issue, which may take hours)
   4. Module specific
      1. POA Host Name should be blank
   5. Save Changes
      1. Save Bootstrap
      2. Open Worker web page (http://[Workerhost]/RetainWorker
      3. Upload
4. Create Initial Dredge Job
   1. Core Settings:
      1. Set Schedule, Profile and Worker as created above
   2. Mailboxes:
      1. Select Mail Server(s) to dredge
   3. Notification:
      1. Enable Mail when errors occur and Mail summary when job is complete
   4. Save Changes
5. Run Job
   1. Go to Schedules and set the minutes back 1 min.
   2. Go to Worker Web Console and click on "Refresh job cache now"
   3. Go to Status and determine if job is running properly.

Retain 4.0