------------------------------------------------------------ ---- Atrove Systems - InfoTrove ---- ---- Installation Guide ---- ------------------------------------------------------------ This README file outlines the steps required to get your InfoTrove server up and running. 1) Setup a new user account on the machine to be used as the InfoTrove server. It is recommended to name the user "atrove". The default home directory could then be something like "/home/atrove". Note: If you simply wish to evaluate InfoTrove you can use your own account and install it in one of your sub-directories. 2) Login as this user. Place the the infotrove_X_XX.tar.gz file into the user account and unzip and untar the file. Then run the setup script. For example run the following commands: a) login as "atrove" user b) gunzip infotrove_X_XX.tar.gz c) tar xvf infotrove_X_XX.tar d) cd InfoTrove_X_XX e) ./setup 3) The setup script should ask you to enter an installation or destination path. It is recommended that you use the default "/home/atrove/infotrove". 4) The setup script should ask you to enter a destination path for the user files. The user files are the documents and data files. It is recommended that you use the default "/home/atrove/infotrove/user". 5) When prompted for the server name, enter the full DNS name for the machine the software is being installed on and will run on. e.g. machinename.domain.com Note: If the machine doesn't have a DNS entry then enter the machines IP address. e.g. 64.123.1.8 6) The setup script will now ask for the URL to reference the server. This is usually the default that the script will display. If for some reason you have a particular configuration i.e. Through a proxy server that changes the address or port then enter the full external URL required to access the server. For example: http://external.address.com:5000 or https://external.address.com 7) The setup script will now ask you confirm your settings. Hit return for the default "yes" answer. The script will then go ahead and install the program and default user files. Note: If you wish to change one of the above parameters or install an update then simply run setup again. It will not over-ride your user or document files, only the program and image files. If you wish to refresh the user files you must delete the installation directory and install again. 8) The setup script will now start InfoTrove and show you the command to use. 9) Once the server is running you can login using your web browser. The server web address is detailed at the bottom of the script output. a) Run your web browser. b) Goto the above web address. c) Login in as the "Initial Admin" user with the following: username: admin password: adminadmin d) Create a new admin account as detailed in the user manual. e) Delete the "Initial Admin" account for security purposes. Note: If you forget your admin password you can restore the "Initial Admin" account by running the following script as the "atrove" user: /install/bin/tr_revert_admin_user 10) If you have any problems with the installation, please run the following script to automatically send us the configuration details so we can help debug the problem. /install/bin/tr_send_cfg Note: If this script will not run, please send the file ~/.infotrove..cfg to the address cfg_help@atrove.com. It contains the configuration infomation we require to debug the problem. ------------------------------------------------------------ Further installation instructions - Advanced Users ------------------------------------------------------------ Server Control -------------- The following commands are used to start and stop the InfoTrove server. These commands must be run as the "atrove" user. To start the InfoTrove server /install/bin/tr_start To stop the InfoTrove server /install/bin/tr_stop Auto restart after machine reboot --------------------------------- If you want the InfoTrove server to be re-started when the machine is rebooted then run the folowing commands as root: (You will need to get your system administrator to do this) If Sun Solaris Operating System copy and link the script to run the boot script for levels 2 and 3 via the commands: 1) cp /install/bin/infotrove.d /etc/init.d 2) ln -s /etc/init.d/infotrove.d /etc/rc2.d/S99infotrove 3) ln -s /etc/init.d/infotrove.d /etc/rc3.d/S99infotrove Or if Linux Operating System copy and link the script to run the boot script for levels 2, 3 and 5 via the commands: 1) cp /install/bin/infotrove.d /etc/init.d 2) ln -s /etc/init.d/infotrove.d /etc/rc.d/rc2.d/S99infotrove 3) ln -s /etc/init.d/infotrove.d /etc/rc.d/rc3.d/S99infotrove 4) ln -s /etc/init.d/infotrove.d /etc/rc.d/rc5.d/S99infotrove License upgrade --------------- If you are upgrading the license code perform the following steps: 1) copy the license code from the license email to the first line in /user/license/key.txt 2) Stop the server run: /install/bin/tr_stop 3) Start the server run: /install/bin/tr_start Binary upgrade -------------- Simply run the .setup file with the same settings. The Infotrove setup file will check to see if any old versions of Infotrove are installed. It will automatically uninstall the old versions before installing the new version. Your user files and documents will not be affected. The setup settings are remembered in a .cfg file stored in the home directory of the "atrove" user. NOTE: You cannot downgrade back to a previous version as the installation process parses the user database files and updates them to suit the version of the binary. ------------------------------------------------------------ ---- Trouble Shooting ---- ------------------------------------------------------------ The error log ------------- The error log file can be found in /generated/logs/httpd_log/error_log This will log any errors that occured during the InfoTrove operation. And may also indicate why the httpd daemon can not start. The daemon check ---------------- If you wish to check the InfoTrove daemon operation run the following command: /install/bin/infotrove daemon check This command will indicate if the InfoTrove daemon is running correctly. It will also show the user locks for files or elements.