Prerequisites



There is a known bug in opTrend v1.6.2-2 that results in a Server Unrecoverable Error being displayed in the GUI following Install. Executing the following command as root, then clearing your browser's cache and logging-in should address this problem:


touch /usr/local/omk/public/omk/css/opTrend_c_custom_packed.css




Installation Steps

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 opTrend 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.

Post Installation Steps

  1. The opTrend installer will create cron entries to keep the opTrend database up-to-date but an initial "update" is required to prime the database for the current week. Run the following command to do this: 

    /usr/local/omk/bin/optrend.pl act=update


  2. The wiredTiger storageEngine is suggested for opTrend to improve performance.

  3. The opTrend installer will attempt to "cap" the "seds" collection to limit the database size somewhat (asking first).  This only happens if the wiredTiger storageEngine setting is set because not all versions of Mongo support collection updates that opTrend requires.  The "seds_ev" and "ev_billboard" collections are not capped.  Capping can be done post-install by running optrend.pl act=setup-db

  4. History can be created if your NMIS installation has the data, to do this run the updates for the weeks you have.  I suggest doing this oldest to newest so that the Billboard information can be calculated correctly: 

    /usr/local/omk/bin/optrend.pl act=update date="4 weeks ago" force_end_of_week=1 force=1
    /usr/local/omk/bin/optrend.pl act=update date="3 weeks ago" force_end_of_week=1 force=1
    /usr/local/omk/bin/optrend.pl act=update date="2 weeks ago" force_end_of_week=1 force=1
    /usr/local/omk/bin/optrend.pl act=update date="1 week ago" force_end_of_week=1 force=1


Post Installation Upgrade Steps

  1. New datasets have been introduced that the GUI will not show unless the config is updated, update opCommon.nmis with this setting:

    'optrend_topn_sections' => [ {"Node Health" => [{ 'cpuLoad' =>'cpu' }, { 'MemoryUtil' =>'memory' },{ 'tcpCurrEstab' => 'tcp'},{'hrSystemProcesses' => 'processes'} ]}, {'Interface Trend' => [{ 'ifInUtil' =>'interface' }, { 'ifOutUtil' =>'interface' },{ 'ifInErrors' =>'packets' },{ 'ifOutErrors' =>'packets' },{ 'ifInDiscards' =>'packets' },{ 'ifOutDiscards' =>'packets' }]}],


  2. You may also want to set the control settings to: 'optrend_exceptions_to_make_condition' => 3,