REV OBSERVER for UNIX/LINUX

PURPOSE

This document is a step by step guide for installing REV OBSERVER software from the Internet on to a UNIX/LINUX Operating System.

CONTENTS

1. WHAT YOU NEED 2. DOWNLOAD THE SOFTWARE 3. QUICK START 4. INSTALLATION 5. STARTING THE ENGINE 6. INSTALL CHECKLIST 7. UNINSTALL 8. CONTACT US

WHAT YOU NEED

MySQL 5.1 or later – installed and running.

DOWNLOAD THE SOFTWARE

 Go to http://www.revsoft.com/ on the Internet.  Select Downloads on the top navigation bar.  Select REV OBSERVER in the list.  Select the Server Software for your UNIX/LINUX platform.  Enter your Username and Password. If you do not have one, select Register to request one from us.  Save the download file to your machine.

QUICK START

 login as super user / root  check MySQL 5.1 is installed and running  create a user 'revsoft' in /etc/passwd (with home directory as '/revsoft')  adduser revsoft -d /revsoft -s /bin/bash

1  unpack the install file:  gunzip RevSoft-Observer-Engine-ENTXXX-XXX.tar.gz  tar xvf RevSoft-Observer-Engine-ENTXXX-XXX.tar  run the checklist:  ./roinstall checklist  install the product:  ./roinstall now  login as user 'revsoft'  start REV OBSERVER  cd /revsoft/Observer/Engine  ./roengine start

INSTALLATION

 Login as super user / root  Add a new user revsoft to the local password file using:  adduser revsoft -d /revsoft -s /bin/bash  Create a new folder using this command:  mkdir /revsoft  Create a temporary folder using this command:  mkdir /revsoft/temp  Copy or move the downloaded file to the temporary folder:  cp RevSoft-Observer-Engine-ENTXXX-XXX.tar.gz /revsoft/temp  Change directory to the temporary folder:  cd /revsoft/temp  To unpack the download file use the following commands:  gunzip RevSoft-Observer-Engine-ENTXXX-XXX.tar.gz  tar xvf RevSoft-Observer-Engine-ENTXXX-XXX.tar  This will create the following 4 new files:  README.txt  roinstall  rouninstall  RevSoft-Observer-Engine-ENTXXX-XXX-files.tar  Now run the following command:  ./roinstall checklist  The output is:  Performing REV OBSERVER check list:  * checking for hostname...ok  * checking for tar file package...ok  * checking install user is root...ok  * checking for user 'revsoft' in the passwd file...ok  * checking for MySQL...ok

2  * checking if we can connect to MySQL...ok

 Check list status is: passed  If the check list status is 'passed' use the following command to install:  ./roinstall now  If the check list status is 'failed', refer to the INSTALL CHECKLIST below...

WHAT DOES THE INSTALL DO?

 The install will:  * create a new folder /revsoft/Observer  * create a new folder /revsoft/Observer/Engine  * create a new folder /revsoft/Observer/Engine/Logs  * install REV OBSERVER programs in /revsoft/Observer/Engine  * add a MySQL database with the name REVOBS  * add a MySQL user ‘revsoft’ with access rights to the REVOBS database  * add a new system file /usr/lib/librevgcc.a (for AIX systems only)

WHAT DOES THE UNINSTALL DO?

 The uninstall will:  * delete all files and folders under /revsoft/Observer  * drop the MySQL database REVOBS  The uninstall does NOT:  * delete the MySQL user ‘revsoft’  * remove the system file /usr/lib/librevgcc.a (on AIX systems only) – This is because other RevSoft products may be installed on your system.

STARTING THE ENGINE

 To start REV OBSERVER use the following command:  roengine start  To check the engine status use:  roengine status  To stop the engine use:  roengine stop  To restart the engine use:  roengine restart  To allow the engine to be stopped or restarted from a remote machine perform these commands only as user 'revsoft'.

3 INSTALL CHECKLIST

 Here is further information on each checklist item:  * checking for hostname...ok

If this fails, set the environment variable HOSTNAME to the name of your machine...

e.g.:

o If you are using bourne (sh or bash) shell use the command:

export HOSTNAME=myhostname

o If you are using the C-Shell (csh) use the command:

setenv HOSTNAME myhostname

 * checking for tar file package...ok

Check that the unpacked tar file RevSoft-Observer-Engine-ENTXXX-XXX-files.tar exists in the correct directory

 * checking install user is root...ok

You need to be logged in as user 'root'

 * checking for user 'revsoft' in the passwd file...ok

You need to add a new user, 'revsoft' to the local passwd file, make the home directory=/revsoft.

 * checking for MySQL...ok

MySQL 5.1 is required to run RevSoft products. To start MySQL, you use this command:

mysqld_safe --user=mysql &

To check the version, use this command:

mysql -V

This command should output something like this:

mysql Ver 14.7 Distrib 5.1.21, for pc-linux-gnu (i686) using readline 4.3

The “Distrib 5.1.XX” is the important part. If you do not see 5.1 you need to download and install MySQL 5.1 for your system. Refer to www.mysql.com for further information.

4  * checking if we can connect to MySQL...ok

MySQL should be started so we attempt to connect to MySQL

To start MySQL you use this command:

mysqld_safe --user=mysql &

UNINSTALL

 To uninstall run the following command:  cd /revsoft/Observer/Engine  ./rouninstall checklist  If the check list status is 'passed' use the following command to uninstall:  ./rouninstall now  If the check list status is 'failed', refer to the INSTALL CHECKLIST...

For further information or support please email us at [email protected] or give us a call (Australia use 07 5594 3300, International use +61 7 5594 3300)