Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • The individual performing this installation has some Linux experience.
  • NMIS8 is installed on the same server where opReports opSLA will be installed
  • NMIS8 is installed in /usr/local/nmis8
  • OpReports opSLA will be installed into /usr/local/opmanteknmis8
  • Root access is available (not always needed but much easier)

Installation Steps

  • NMIS8 should be patched or updated to the correct level.
  • Copy the opReports opSLA tarball to the server (a tarball is a GZIP'd tar file, e.g. opReports opsla-2012-05-09-1315.tar.gz)
    1. 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.
  • If the installation directory does not already exist
  • Change into the directory where the tarball was copied
  • Untar the file
unalias cp
cd /usr/local~
tar xvf ~/opReportsopsla-<version>.tar.gz
cd opmantekopsla/
cp install/opReports.nmis opmantek/conf
bin/opfixperms.pl
cp opmantek/install/01opmantek.conf /etc/httpd/conf.d/
service httpd restart
  • Update the crontab to run the default reports every day for the last 1 day and every week for the last week.  Below is the crontab entries required.
  • To edit the crontab, use the command "crontab -e"
######################################################
# Opmantek Config
######################################################
# Run opReports Batch 
0 0 * * -r * /usr/local/opmantek/bin/opReports-daily.sh
0 0 * * Sun nmis8/
/usr/local/opmanteknmis8/bin/opReports-weeklyfixperms.sh

Alternate Installation Directory

opReports can be installed into another directory if required, e.g. /opt/opmantek, the same process applies, but a few files will need to be changed.

Edit opReports.nmis and change the <omk_base> to be the new, e.g.

'<omk_base>' => '/opt/opmantek',

Edit the Apache include file, which if already copied to /etc/httpd/conf.d will be /etc/httpd/conf.d/01opmantek.conf and change the following lines to the new installation location

Alias /opmantek/ "/usr/local/opmantek/htdocs/"
ScriptAlias /cgi-omk/ "/usr/local/opmantek/cgi-bin/"
<Directory "/usr/local/opmantek/cgi-bin"> 

Edit the crontab and use the locations of the two shell scripts, e.g.

0 0 * * * /opt/opmantek/bin/opReports-daily.sh
0 0 * * Sun /opt/opmantek/bin/opReports-weekly.sh

Edit each of the opReports shell scripts and update the following line

OMK=/opt/opmantek

...

pl
Basic opSLA Configuration

There are many configuration options in opReports, but the only one which must be updated to make everything work is the configuration for "report_server_prefix", this allows the emailed reports to point to the correct web server to load their configurations, this entry is in the opReports.nmis file and should be updated to be the public web prefix of the server, which the people receiving the emails would use to access the server (this might be the portal address).

...