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 3 Next »

Prerequisites

  • The individual performing this installation has a bit of Linux experience.

  • Root access is available.

  • An (evaluation) license for opCharts
  • The software packages apache, rrdtool, httpd-tools (Centos/RHEL) or apache2-utils (Debian), freetds and unixODBC must be installed.

Installation Procedure

Preparing the pre-requisites

On Debian and derivatives, run this as root:

apt-get install apache2 rrdtool apache2-utils unixodbc odbcinst tdsodbc

On CentOS/RHEL, run the following commands as root:

 

yum install http://mirror.optus.net/epel/6/i386/epel-release-6-8.noarch.rpm
yum install httpd-tools freetds unixODBC rrdtool httpd
echo -e "[FreeTDS]\nDriver = /usr/lib64/libtdsodbc.so.0" | odbcinst -i -r -d

Installing opCharts

  • Download opCharts and the custom rrdtool from the Opmantek website.
    Copy the two tarballs to the server in question, using scp or sftp or similar. Make a record of where you put the tarball (likely root's home directory).

  • Become root and unpack the tarballs:

     # as root
cd /usr/local
# if the tarball was saved in a different location, adjust the ~ in the following command 
tar xzf ~/opCharts-THEVERSION.tar.gz
tar xzf ~/rrdtool-binpkg.tgz
cd /usr/local/omk 
cp -r install/*.nmis install/charts install/users.dat install/data_sources.json conf/

  • Create the required nmis user
    As root run

    useradd nmis
  • opCharts is now unpacked into /usr/local/omk, and the default configuration files are in /usr/local/omk/conf, ready for your initial config adjustments.

Initial System Configuration and Integration steps

  • Make sure the opCharts logs are rotated
    If your system runs  logrotate daily and automatically (i.e. Debian/Ubuntu), simply copy conf/omk-rotate.conf to /etc/logrotate.d/.

    # on Debian/Ubuntu, as root:
cp /usr/local/omk/conf/omk-rotate.conf /etc/logrotate.d/

    On other systems you will have to create a suitable cron job:

    # as root: crontab -e# insert the following lines, then save and quit 
# Check to rotate the logs 02:05 every day
2 5 * * * /usr/sbin/logrotate /usr/local/omk/conf/omk-rotate.conf

  • Integrate opCharts with the web server
    become root and run the following commands:

    # as root
# non-debian:
cp /usr/local/omk/conf/04omk-proxy.conf /etc/httpd/conf.d/
apachectl restart
# debian/ubuntu:
cp /usr/local/omk/conf/04omk-proxy.conf /etc/apache2/conf.d/
/etc/init.d/apache2 restart

    Note: If this step is not taken, then the opCharts web GUI will only be available on port 8042 and you'll need to adjust your web browser accordingly.

  • Make the opCharts service daemon start automatically with the system
    become root, then run the  following commands:

    # as root
cd /usr/local/omk/install
cp omkd.init.d /etc/init.d/omkd
# non-debian:
chkconfig omkd on
# debian/ubuntu:
update-rc.d omkd defaults

  • Start the opCharts service daemon
    become root, then run the following commands:

    service omkd start
  • 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.

 

 

  • No labels