Versions Compared

Key

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

...

  • NMIS8 should be patched or updated to the correct level.
  • Install mySQL
  • Install the Perl CPAN package DBD::mysql (which may require you to install DBI first)
  • Copy the opSLA tarball to the server (a tarball is a GZIP'd tar file, e.g. 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 and copy the contents to NMIS8
unalias cp
cd ~
tar xvf ~/opsla-<version>.tar.gz
cd opsla/
cp -r * /usr/local/nmis8/
/usr/local/nmis8/binadmin/fixperms.pl

Basic

...

opSLA

...

Configuration

There are many configuration options in opReportsopSLA, but the only one which must be updated following are essential 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).

'report_server_prefix' => 'http://nmis.domain.com',

Patching opReports

Often patches will be released for opReports, the following are commands to install a patch, unless other instructions are specifically provided.

...

it work correctly.

daemon_ipsla_filename

This is the name of the IPSLA daemon which NMIS8 will use, change this to ipslad+.pl

'daemon_ipsla_filename' => 'ipslad+.pl',

daemon_ipsla_active

This configuration option enables the ipSLA daemon in NMIS8, change it to true if it is not already set.

'daemon_ipsla_active' => 'true',

NMIS8 Database Setup

The following settings are the defaults and will suffice for running mySQL on the same server as NMIS8 is installed, and using the default password of nmis.  If you do not want to use these settings you will need to change them accordingly.

'nmisdb' => 'nmisdb',
'db_server' => 'localhost',
'db_port' => '3306',
'db_user' => 'nmis',
'db_password' => 'nmis' 

Create NMIS Database

Access mysql from the command line and login as the root user

mysql -u root -p

Enter the following SQL commands to create the database.

create database nmisdb character set utf8;
CREATE USER 'nmis'@'localhost' IDENTIFIED BY 'nmis';
GRANT ALL PRIVILEGES ON nmisdb.* TO 'nmis'@'localhost' WITH GRANT OPTION;

When opSLA first runs it will create the necessary database tables.