REV VIEW for UNIX/LINUX PURPOSE This document is a step by step guide for installing REV VIEW 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 VIEW 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 check SSH is installed and running create a user 'revsoft' (with password) in /etc/passwd (with home directory as '/revsoft') adduser revsoft -d /revsoft -s /bin/bash 1 unpack the install file: gunzip RevSoft-View-Engine-ENTXXX-XXX.tar.gz tar xvf RevSoft-View-Engine-ENTXXX-XXX.tar run the checklist: ./rvinstall checklist install the product: ./rvinstall now login as user 'revsoft' start REV VIEW cd /revsoft/View/Engine ./rvengine 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-View-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-View-Engine-ENTXXX-XXX.tar.gz tar xvf RevSoft-View-Engine-ENTXXX-XXX.tar This will create the following 4 new files: README.txt rvinstall rvuninstall RevSoft-View-Engine-ENTXXX-XXX-files.tar Now run the following command: ./rvinstall checklist The output is: Performing REV VIEW 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 2 * checking for MySQL...ok * 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: ./rvinstall 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/View * create a new folder /revsoft/View/Engine * create a new folder /revsoft/View/Engine/Logs * install REV VIEW programs in /revsoft/View/Engine * add a MySQL database with the name REVVEW * add a MySQL user ‘revsoft’ with access rights to the REVVEW 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/View * drop the MySQL database REVVEW 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 VIEW use the following command: rvengine start To check the engine status use: rvengine status To stop the engine use: rvengine stop To restart the engine use: rvengine 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-View-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/View/Engine ./rvuninstall checklist If the check list status is 'passed' use the following command to uninstall: ./rvuninstall 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 .