Skip to end of banner
Go to start of banner

opCharts Installation Guide

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

Installer Versions

If you are installing a version of opCharts compiled prior to 2016 please see this page: Pre 2016 Installations

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).
  • All licenses are added/updated at https://<hostname>/omk/opLicense .

Preparation

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

Transfer the opCharts installer file onto the server in question, either by direct download from the Opmantek website, or from your desktop with scp or sftp or a similar file transfer tool.

  • Start the interactive installer and follow its instructions:

    sudo sh ./opCharts-Linux-x86_64-3.0.7.run
...
++++++++++++++++++++++++++++++++++++++++++++++++++++++
opCharts (3.0.7) Installation script
++++++++++++++++++++++++++++++++++++++++++++++++++++++
...
This installer will install opCharts into /usr/local/omk.
To select a different installation location please rerun the
installer with the -t option.
  • The installer will interactively guide you through the steps of installing opCharts. Please make sure to read the on-screen prompts carefully.
  • When the installer finishes, opCharts is installed into /usr/local/omk, and the default configuration files are in /usr/local/omk/conf, ready for your initial config adjustments.
  • A detailed log of the installation process is saved as /usr/local/omk/install.log, and subsequent upgrades or installations of other Opmantek products will add to that logfile.
  • For detailed information about the interactive installer please check the Opmantek Installer page.

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.

  • No labels