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