This page is no longer used.
Please see:
Linux - Installing (old pre v1.3.1)
Linux - Upgrading (old pre v1.3.1)
Prerequisites
The individual performing this installation has some Linux experience.
Root level server access.
Nmap 6, Apache 2, MySQL 5, PHP 5.2, PHP extensions MB_String and PHP_SNMP.
Installation Steps
Copy the OAE tarball to the server (a tarball is a GZIP'd tar file, e.g. OAE-Linux-x86_64-1.0.tar.gz). You may need to use SCP or FTP to get the file onto the server. The file will now likely be in the users home directory.
Change into the /usr/local directory.
| Code Block | ||
|---|---|---|
| ||
cd /usr/local |
Untar the file.
| Code Block | ||
|---|---|---|
| ||
tar xvf ~/OAE-Linux-x86_64-1.0.4.tar.gz |
Fix the file ownership and permissions.
| Code Block | ||
|---|---|---|
| ||
chown -R root:root omk
chmod -R 775 omk |
Change into the /usr/local/omk directory.
| Code Block | ||
|---|---|---|
| ||
cd /usr/local/omk/ |
Install the daemon.
| Code Block | ||
|---|---|---|
| ||
cp install/omkd.init.d /etc/init.d/omkd
chkconfig --add omkd |
Copy the config files.
| Code Block | ||
|---|---|---|
| ||
cp install/users.dat conf/
cp install/oae_reports.json conf/
cp install/opCommon.nmis conf/ |
Edit the config files.
| Code Block | ||
|---|---|---|
| ||
nano conf/opCommon.nmis |
Edit the "openauditenterprise" section and insert the actual ip address of the server (not 127.0.0.1 or localhost) in to the oae_server variable (along with http:// and don't forget the trailing /). If you have Open-AudIT installed into a sub directory in your web root, be sure to add that to the end of the oae_server variable above. For our virtual appliance it would be http://<SERVER_IP>/open-audit/
Change and note the oae_username and oae_password values.
The email section is described in the Open-AudIT Enterprise - Configuration Guide document.
Start the daemon.
| Code Block | ||
|---|---|---|
| ||
service omkd start |
Edit the file /usr/local/omk/install/04omk-proxy.conf and insert the ip address of the server into the relevant "location" sections (replacing <SERVER>). You should be able to determine the ip address of the server by running the below command. Make sure you don't use 127.0.0.1.
| Code Block | ||
|---|---|---|
| ||
ifconfig | grep "inet addr" |
Copy the apache config file to the correct location and restart apache.
For Ubuntu:
| Code Block | ||
|---|---|---|
| ||
cp /usr/local/omk/install/04omk-proxy.conf /etc/apache2/conf.d/
service apache2 restart |
For RedHat / CentOS:
| Code Block | ||
|---|---|---|
| ||
cp /usr/local/omk/install/04omk-proxy.conf /etc/httpd/conf.d/
service httpd restart |
Create the Open-AudIT User
Log in to Open-AudIT and create a user for Open-AudIT Enterprise.
Admin -> Users -> Add User.
Username should be the same as noted in opCommon.nmis (openauditenterprise -> oae_username).
Password should be the same as noted in opCommon.nmis (openauditenterprise -> oae_password).
Full Name should be "Open-AudIT Enterprise".
SAM Access Level should be "No Access".
User is Admin should not be ticked.
The only group this user needs access to is the "All Devices" group. Access level should be "List View Only".
Set the Open-AudIT config details
In Open-AudIT go to Admin -> Config.
Edit the "maps_url", "nmis_url" and "oae_url" fields to be the actual ip address of the server, not localhost.
These fields usually look something like -
maps_url: http://<server>/omk/oae/map
nmis_url: http://<server>/cgi-nmis8/nmiscgi.pl
oae_url: http://<server>/omk/oae/
Setting these details will activate the icon links in the header of Open-AudIT. These fields can also contain relative URL's, thus /omk/oae/map for a link to Maps for Open-AudIT on the same server. Links containing a port number must contain a full URL at this stage.
Enter Your License
Go to the URL http://<server>/omk/oae/
Enter the default credentials of nmis and nm1888.
Click the "View and enter licenses" button.
Click "Enter a license key".
Paste your license key text into the text box and click "Add License".
You should see a message at the top of the screen saying "Success: You have added a license for Open-AudIT Enterprise."
Close the browser tab.
Click the "License Entered, Continue" button.
Accept the End User License Agreement.
You should now see the Open-AudIT Enterprise dashboard.
Log in to Open-AudIT Enterprise
Go to the URL http://<server>/omk/oae
Log in to Open-AudIT
Go to the URL http://<server>/index.php/login/index/main/list_groups