Skip to end of metadata
Go to start of metadata

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