Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updated with the remaining primary steps

Prerequisites

  • The individual performing this installation has a bit of Linux experience.
  • Root access is available.

  • An (evaluation) license for opCharts
  • FIXME? does opcharts need mongo?
    A working MongoDB installation (not necessarily on the same server)
  • 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: 

Code Block
languagebash
apt-get install apache2 rrdtool apache2-utils unixodbc odbcinst tdsodbc

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

...

Code Block
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:

    Code Block
     
  • Create the required nmis user
    As root run

    Code Block
    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/.

    Code Block
    themeEmacs
    # 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:

    Code Block
    # 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:

    Code Block
    # 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:

    Code Block
    # 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:

    Code Block
    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.