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... CONTACT US 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) 5 .