Table of Contents | ||
---|---|---|
|
Prerequisites:
- a working copy of NMIS (starting from an NMIS VM is a good idea, if you prefer to install it yourself see the NMIS 8 Installation Guide)
Installation Steps
- Copy the opConfig tarball to the server (a tarball is a GZIP'd tar file, e.g. opConfig-Linux-x86_64-1.0.tar.gz)
- You may need to use SCP or FTP to get the file onto the server.
- The file will now likely be in the users home directory.
- If the installation directory does not already exist
- Change into the directory where the tarball was copied
- Untar the file
...
theme | Emacs |
---|
...
Table of Contents |
---|
Before You Begin
Prerequisites
- NMIS hast to be installed on the same server that opConfig is being installed on (NMIS version >=8.5.10G).
- The individual performing this installation has a small bit of Linux experience.
Root access is available.
- Internet access is required for installing any missing but required software packages.
- opConfig requires a working MongoDB installation (ideally but not necessarily on the same server).
- You will need a license for opConfig (evaluation licenses are available here).
- All licenses are added/updated at https://<hostname>/omk/opLicense .
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 opConfig from the Opmantek website.
- If you have opConfig 1.X installed please check the upgrade guide first.
Installation Steps
As of February 2016, opConfig is distributed in a self-extracting download format that simplifies the installation process quite a bit. More information on running the installer can be found HERE: The Opmantek Installer
Transfer the opConfig installer file 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.
Start the interactive installer and follow its instructions:
Code Block sudo sh ./opConfig-Linux-x86_64-
...
3.0.
...
7.
...
run
...
Debian/Ubuntu
Code Block |
---|
cp install/01opmantek.conf /etc/apache2/conf.d/
service apache2 restart |
Configure MongoDB
The standard Opmantek configuration MongoDB will suite here
Create database indexes
Before getting started it's a good idea to create the database indexes, be sure that you have authentication configured (or disabled)
Code Block |
---|
bin/opConfig-cli.pl act=create_indexes |
Enter the Licence Key
If all your settings are correct you should now be able to load up http://yourhost/cgi-omk/opConfig.pl
If you do not see this screen check your apache log, it's likely that there is a file permissions error. Make sure that the apache user is in the nmis group, that iptables and SELinux are setup to allow you to access this file and that all settings have been applied (daemons restarted).
Setup CRON
Code Block |
---|
#As root
crontab -e
##
####################################################
# opConfig Daily
0 1 * * * /usr/local/opmantek/bin/opConfig-cli.pl act=run_command_sets > /dev/null 2>&1 |
This will collect all command sets every morning at 1am. The output of the script is sent to /dev/null, it can be run from the command line to see what the script is doing.
Setup opConfig Daemon
- Copy opconfigd.init.d /etc/init.d/opconfigd
- service opconfigd start
- chkconfig opconfigd on
Upgrade opConfig
If you have an existing installation of opConfig, then you can patch/upgrade/update it with the following steps.
- Copy the opConfig tarball to the server (a tarball is a GZIP'd tar file, e.g. opConfig-Linux-x86_64-VERSION.tar.gz)
- You may need to use SCP or FTP to get the file onto the server.
- The file will now likely be in the users home directory.
- If the installation directory does not already exist
- Change into the directory where the tarball was copied
- Untar the file
Code Block |
---|
cd ~
tar xvf opConfig-Linux-x86_64-LIB-1.1.9.tar.gz
cd opmantek
unalias cp
cp -r * /usr/local/opmantek
cd /usr/local/opmantek
bin/opupdateconfig.pl install/opCommon.nmis conf/opCommon.nmis
cp install/opconfigd.init.d /etc/init.d/opconfigd
service opconfigd restart |
...
... ++++++++++++++++++++++++++++++++++++++++++++++++++++++ opConfig (3.0.7) Installation script ++++++++++++++++++++++++++++++++++++++++++++++++++++++ ... This installer will install opConfig into /usr/local/omk. 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 opConfig. Please make sure to read the on-screen prompts carefully.
- When the installer finishes, opConfig is installed into
/usr/local/omk
, and the default configuration files are in/usr/local/omk/conf
, ready for your initial config adjustments. - 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.
Database Setup
If necessary the installer will offer to install MongoDB locally for you; if that is undesirable, or if you have a remote MongoDB installation that you want to use you'll need to adjust the MongoDB-related settings:
open conf/opCommon.nmis
in an editor, go to the database section and change the server, username and password 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 |
---|
'database' => {
'db_server' => 'localhost',
'db_port' => '27017',
'db_name' => 'nmis',
'db_username' => 'opUserRW',
'db_password' => 'op42flow42',
},
|
License
Access the opConfig GUI and acquire, restore or enter your license.
The opConfig GUI is accessible at http://<yourservername or ip address>/omk/opConfig/
, and until you have entered a valid license neither the opConfig GUI nor the CLI tools will operate.
Configuration and Use
At this point opConfig should be ready for operation, but won't have any knowledge of which nodes to manage.
Your next step should be to consult the opConfig User Manual, which will tell you how to tell opConfig what commands to perform with which nodes, how to customize opConfig's behaviour to suit your needs and so on.
Please feel free to leave comments and suggestions below!