...
You can either use this menu, or navigate directly to NMIS: open your favourite web browser and navigate to:
| Code Block |
|---|
http://vm<vm_ip_addressaddress>/cgi-nmis8/nmiscgi.pl |
User: nmis
Password: nm1888
...
The first step to using a module is knowing how to open it, the next is to get a license for it. This This process is simple and painless, if you would just like to try the software trial licenses are available!
Before you begin we will make sure all the permissions are correct so everything goes smoothly, this is very important:
| Code Block |
|---|
/usr/local/opmantek/bin/opfixperms.pl |
Should produce the following output:
| Code Block |
|---|
opfixperms.pl Version 1.0
Copyright (C) 2012 Opmantek Limited (www.opmantek.com)
This program comes with ABSOLUTELY NO WARRANTY;
See www.opmantek.com or email contact@opmantek.com
This script will fix the permissions for Opmantek based on the configuration /usr/local/opmantek/bin/../conf/opCommon.nmis
The directory to be processed is: /usr/local/opmantek
The user will be set to: nmis
The group will be set to: nmis |
Now let's get started!
: all products on the appliance (except opFlow) now support free licenses (which are not time-limited but limited to 20 nodes). For these applications the initial dialog offers the generation of such a free license; For opFlow please use the Trial License system as described below.
Opening a module
There are two ways to open the modules, by using the drop-down in the NMIS page (make sure you do not have pop-up's blocked for this page):
...
or by manually entering the url into your browser:
| Code Block |
|---|
http://vm<vm_ip_addressaddress>/cgi-omk/opFlow.pl |
The latter url will present you with a clickable list of installed Opmantek application modules and their versions.
Getting a trial license (opFlow only)
opFlow , opMaps and opReports will present you with shows a page that looks like similar to the following when not registeredno license is installed:
You will now need to get a license key and enter it into the licensing system, the easiest way to do this is by clicking "View and Entere Enter Licenses" button. This will open a new tab/page containing the opLicensing module. On this page you will again need to click a button, it's time to choose if you want a trial license or if you would like to buy a license.
...
Paste the license key into the textbox provided and click "Add License". IMPORTANT: before you click "Add License" make sure you have done this step:
...
You should now have a sucessfully installed key!
...
And you're Done! The next step is to make sure the configuration for the module you activated is correct & complete.
opFlow Configuration
Mongo
...
| Code Block |
|---|
chkconfig mongod on
service mongod start |
Note: the first time you start mongo it may take a while to return to the command prompt, don't worry about it, just let mongo run and it will eventually come back, if it doesn't CTRL+C and start it again.
Flowd
flowd should be running, but to be sure we will take the same steps as we did with mongo.
| Code Block |
|---|
chkconfig flowd on
service flowd start |
When you run the start command you will likely see an error like the following which tells you it's already running, of course you could always use ps to find out as well
| Code Block |
|---|
Starting flowd: bind: Address already in use
Listener setup of [0.0.0.0]:12345 failed |
opFlowd
opflowd also needs the same treatment:
| Code Block |
|---|
chkconfig opflowd on
service opflowd start |
Configure your Cisco Router
...
| Code Block |
|---|
ip flow-cache timeout active 1 |
Run setup script
...
opFlow will now be displaying your data! Visit http://
...
<vm_ip_
...
address>/cgi-omk/opFlow.pl and take a look! (also make sure you have a license)
ps. Authentication info for Opmantek modules is the same as it is for NMIS, the default is:
username: nmis
password: nm1888
For more information and help with opFlow see it's its community homepage
opMaps Configuration
Configuration of opMaps is a short process.First we need to get the locations of each group you have configured in NMIS into the file that opMaps will use to function.
...
| Code Block |
|---|
rm /usr/local/opmantek/conf/GroupLocations.nmis |
Now we will convert your groups to a GroupLocations.nmis file
| Code Block |
|---|
cd /usr/local/opmantek/bin/
./configmaps.pl /usr/local/nmis8/conf/Nodes.nmis /usr/local/opmantek/conf/GroupLocations.nmis |
This file can be edited using vi or your favourite editor to adjust the fields to your liking.
The next step is to get a google maps api key. If you don’t already have one, please follow these steps from Google to acquire one. Next we will put this key into the opMaps configuration file:
| Code Block |
|---|
vi /usr/local/opmantek/conf/Maps.nmis |
| Code Block |
|---|
#Find the following line under 'mapview' =>
'googleApiKey' => ''
#Replace the defaultAPI with your own Google API KEY
eg: 'googleApiKey' => 'AIzaSyBfa5791NQUs3N7x--ueD3DwQPmscElk-8' |
There are several other parameters that can be configured in the Maps.conf file to adjust the view to suit your needs. For more information on setting up and configuring opMaps see it's community homepage.
One troubleshooting note:
If you are trying to view the map in NMIS and getting a licensing error even though you have entered the license (something like the following):
It is most likely that you have not accepted the EULA. Open opMaps from the NMIS Modules drop down:
This should pop-up opMaps in a new page (make sure you have pop-ups disabled for this host) and accept the EULA. If you now go back to the NMIS page and refresh the map should appear properly.
Once again, for more information on setting up and configuring opMaps see it's community homepage.
opReports Configuration
To configure opReports all that is needed is to enter a license key using the instructions above. For more information on setting up and configuring opReports see its community page.