Prerequisites
- The individual performing this installation has a small bit of Linux experience.
Root access is available.
...
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
...
- Internet access is required for installing any missing but required software packages.
- NMIS must be installed on the same server that opCharts is being installed on.
- You will need a license for opCharts (evaluation available here).
Preparation
- If you do not yet have a working installation of NMIS in your server, please follow the procedure in the NMIS 8 Installation Guide.
- Download opCharts from the Opmantek website.
Installation Steps
Transfer the opCharts tarball 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.
Make a record of where you put the tarball (
...
root
's home directory or /tmp are good locations).
Become root and unpack the
...
tarball:
Code Block
...
#
...
become root
...
sudo sh # if the tarball was saved in a different location, adjust the
...
following command cd tar xzf
...
opCharts
...
-x86_64-2.0.1.tar.gz
...
Start the interactive installer and follow its instructions:
Code Block sudo sh cd opCharts-2.0.1 ./installer ++++++++++++++++++++++++++++++++++++++++++++++++++++++ opCharts (2.0.1) Installation script ++++++++++++++++++++++++++++++++++++++++++++++++++++++ This installer will install opCharts into /usr/local/omk.
...
Create the required nmis user
As root run
Code Block |
---|
useradd nmis |
...
To select a different installation location please rerun the installer with the -t option. ...
- The installer will interactively guide you through the steps of installing opCharts. Please make sure to read the on-screen prompts carefully.
- When the installer finishes, opCharts is installed 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 or recent CentOS), simply copyconf/omk-rotate.conf
to/etc/logrotate.d/
.Code Block theme Emacs # on Debian/Ubuntu, as root: cp /usr/local/omk/install/omk-rotate.conf /etc/logrotate.d/
On systems without a readily available
/etc/logrotate.d/
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/install/04omk-proxy.conf /etc/httpd/conf.d/ apachectl restart # debian/ubuntu: cp /usr/local/omk/install/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
|
- A detailed log of the installation process is saved as
/usr/local/omk/install.log
, and subsequent upgrades or installations of other Opmantek products will add to that logfile. - For detailed information about the interactive installer please check the Opmantek Installer page.
Initial Configuration
You will need to adjust the NMIS-related settings:
openconf/opCommon.nmis
in an editor, go to the nmis section and change the nmis_dir to reflect your MongoDB installation.
The result should look similar to the following (but there might be extra settings related to other products):Code Block 'nmis' => { 'nmis_dir' => '/usr/local/nmis8', 'nmisConf' => 'Config', '<nmis_logs>' => '/usr/local/nmis8/logs', 'nmis_host_base' => 'http://localhost', 'nmis_cgi_url_base' => '/cgi-nmis8', 'prefer_local_nmis' => 'false' },
After completing your configuration changes you'll need to restart the opCharts daemon.
Simply run the following commands as root:Code Block # don't forget to become root, using sudo sh or su service omkd restart # to verify the status of the daemons: service omkd status
Where to go from here
First you should 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.
...
...