opCharts Installation Guide

Prerequisites

• NMIS installed on the same server that opCharts is being installed (NMIS version >=8.5.6G).
• The individual performing this installation has a small bit of Linux experience.

• Root access is available.

• Internet access is required for installing any missing but required software packages.
• opCharts License (evaluation available here).

Preparation

• If you do not yet have a working installation of NMIS in your server, please follow the procedure in the NMIS 8 Installation Guide.
• Download opCharts from the Opmantek website.

Installation

As of February 2016, opCharts is distributed in a self-extracting download format that simplifies the installation process quite a bit. More information on running the installer can be found HERE: The Opmantek Installer

Initial Configuration

• You will need to adjust the NMIS-related settings:
  open conf/opCommon.nmis in an editor, go to the nmis section and change the nmis_dir to reflect your NMIS installation. 
  The result should look similar to the following (but there might be extra settings related to other products):

  'nmis' => {
      'nmis_dir' => '/usr/local/nmis8',
      'nmisConf' => 'Config',
      '<nmis_logs>' => '/usr/local/nmis8/logs',
      'nmis_host_base' => 'http://localhost',
      'nmis_cgi_url_base' => '/cgi-nmis8',
      'prefer_local_nmis' => 'false'    
    },

• After completing your configuration changes you'll need to restart the opCharts daemon.
  Simply run the following commands as root: 

  # don't forget to become root, using sudo sh or su
  service omkd restart
  # to verify the status of the daemons:
  service omkd status

• Authentication
  The installer will backup /usr/local/omk/conf/users.dat and then create a symlink to users.dat in your NMIS directory if it was found during installation.  If the NMIS users.dat file could not be found the existing users.dat file in omk/conf/ will be used, if that is not found the default users.dat file will be copied to omk/conf/. Default credentials can be found here.

Where to go from here

First you should test opCharts: open up a web browser, and point it to "http://<yourserverip>/omk/opCharts"; you will have to enter your license first, then you will see opCharts' main dashboard. See the authentication bullet point above for user/password info.