Requirements
Root level access to the Linux server.
Basic Linux knowledge.
Description
As at version 1.3.1 of Open-AudIT (for RedHat / Centos installs only at this stage), an installation script is now shipped in the tarball. This script can perform installs, upgrades, backups, restores, uninstalls and check for install dependencies. How to perform all of the above is detailed below. The script will log it's commands to the file /tmp/install.log. If your install fails, this log will provide valuable information as to why.
All steps below require the tarball to be copied to (preferrably) /tmp extracted and then the install script (install.pl) run from that directory.
cd /tmp tar xf OAE-Linux-x68_64-release_1.3.1.tar.gz
Installation on a new server
To install Open-AudIT on a new server (which does not have an existing Open-AudIT installation) perform the following steps (after copying and extracting the tarball as above):
Run the script by entering the command
./install.pl
The script will check for dependencies. If the dependencies are not met, some information about how to install them is displayed and the script will exit. To force the install, regardless of the dependency status, run the command
./install.pl check_dependencies=n
The script will install the files and prompt for your MySQL root user password.
The database will be setup, the daemon configured and started and the install will be completed.
To access the application, go to http://<YOUR_SERVER>/omk/oae and you will see a logon screen.
Upgrade on an existing server
To upgrade an existing installation of Open-AudIT perform the following steps (after copying and extracting the tarball as above):
Run the script by entering the command
./install.pl
The script will check for dependencies. If the dependencies are not met, some information about how to install them is displayed and the script will exit. To force the install, regardless of the dependency status, run the command
./install.pl check_dependencies=n
Upon completing dependency checking (or not), the script will ask if you would like a backup of your files and database taken. If you answer 'y', a tarball will be created in /tmp named open-audit_backup-YYYY-MM-DD-HHMM.tar.gz Where YYYY is the year, MM is the month, DD is the day, HH is the hour and MM is the minute. Included in this backup will be the install script itself so a restore is as simple as an install or upgrade. See below for further details.
Your original install folders /usr/local/omk and /usr/local/open-audit will be moved to their original name + the timestamp. The new files will be copied into new folders and any existing attachments will be copied from the old too the new folders.
The new web files will be copied to your web server directory.
Your database will NOT be upgraded. You will need to log on to Open-AudIT - when you do you will be prompted to upgrade it. Go to http://<YOUR_SERVER>/open-audit/index.php/main/list_groups/0
Backup an existing installation
To backup an existing installation without installing or upgrading, perform the following steps (after copying and extracting the tarball as above):
Run the script by entering the command
./install.pl backup_only=y
The script will confirm you wish to take a backup of your existing files and data. If you answer 'y', a tarball will be created in /tmp named open-audit_backup-YYYY-MM-DD-HHMM.tar.gz Where YYYY is the year, MM is the month, DD is the day, HH is the hour and MM is the minute. Included in this backup will be the install script itself so a restore is as simple as an install or upgrade. See below for further details.
Restore a backup
To restore a backup taken previously by the script, perform the following steps (after copying and extracting the backup file as above):
Run the script by entering the command
./install.pl restore=y
You will be prompted for your MySQL root user credentials. Any existing files and database will be removed from the server. The backed-up files will be restored to the server, the daemon reinstalled and configured, the database restored and the daemon started.
Checking Dependencies
To check the dependencies are installed without actually installing perform the following steps (after copying and extracting the tarball as above):
Run the script by entering the command
./install.pl check_dependencies_only=y
The script will run, check the dependencies are installed and inform you if they are or provide information on which packages are not and offer the commands for you to install them.
Uninstalling
To uninstall Open-AudIT and delete all data perform the following steps (after copying and extracting the tarball as above):
Run the script by entering the command
./install.pl uninstall=y
The script will offer to provide a backup of the existing files and data (as per above) and then confirm that you do wish to uninstall Open-AudIT. If you answer 'y', the files will be deleted, the daemon removed and the database and database user dropped.