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 | ||
---|---|---|
| ||
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, usingscp
orsftp
or similar. Make a record of where you put the tarball (likelyroot
's home directory).
Become root and unpack the tarballs:
Code Block Create the required nmis user
As root runCode 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 copyconf/omk-rotate.conf
to/etc/logrotate.d/
.Code Block theme Emacs # 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
becomeroot
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
becomeroot
, 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
becomeroot
, 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.