You will need to edit the configuration file /usr/local/opmantek/conf/Maps.nmis and make some simple changes.
To do this you will need to:
opMaps needs to know where Open-AudIT is so it can collect data from it.
Configuring opMaps for NMIS
After installing opMaps, you will need to set up the GroupLocations.nmis so opMaps can display a geographic map of your NMIS status.
To do this you will need to :
This script creates the Map Files based on the NMIS Node files.
Usage: ./configmaps.pl <NODES> <GroupLocations>
cd /usr/local/opmantek/bin/ ./configmaps.pl /usr/local/nmis8/conf/Nodes.nmis /usr/local/opmantek/conf/GroupLocations.nmis |
After creating GroupLocations.nmis, you may edit the file in the directory /usr/local/opmantek/conf/
vi /usr/local/opmantek/conf/GroupLocations.nmis |
The following text is an example of what a GroupLocations.nmis file might look like
%hash = (
'NMIS8' => {
'Customer' => 'Opmantek',
'Location' => 'Bundall, Queensland',
'Group' => 'NMIS8'
}
); |
In this example 'NMIS8' represents a map entry.
'Customer' => or 'Business' => The name of the business/customer which is the name of the map.
'Location' => The location of each of the business/customer (Geodata).
'Group' => The NMIS group which relates to that business/customer.
By editing these you could change the groups that display on different maps.
Lets take an example, like a network with four groups, which represents a company with operations in Australia and the America's. The groups we have in NMIS are MexicoCity, NewYorkCity, Brisbane, GoldCoast. We want to end up with three maps, the "Default" map for all the locations and a regional map for each region.
%hash = (
'GoldCoast-Global' => {
'Customer' => 'Opmantek-Global',
'Location' => 'Bundall, Queensland',
'Group' => 'GoldCoast'
},
'Brisbane-Global' => {
'Customer' => 'Opmantek-Global',
'Location' => 'Brisbane, Queensland',
'Group' => 'Brisbane'
},
'MexicoCity-Global' => {
'Customer' => 'Opmantek-Global',
'Location' => 'Mexico City, Mexico',
'Group' => 'MexicoCity'
},
'NewYorkCity-Global' => {
'Customer' => 'Opmantek-Global',
'Location' => 'New York City, New York',
'Group' => 'NewYorkCity'
},
'GoldCoast-AU' => {
'Customer' => 'Opmantek-AU',
'Location' => 'Bundall, Queensland',
'Group' => 'GoldCoast'
},
'Brisbane-AU' => {
'Customer' => 'Opmantek-AU',
'Location' => 'Brisbane, Queensland',
'Group' => 'Brisbane'
},
'MexicoCity-NA' => {
'Customer' => 'Opmantek-NA',
'Location' => 'Mexico City, Mexico',
'Group' => 'MexicoCity'
},
'NewYorkCity-NA' => {
'Customer' => 'Opmantek-NA',
'Location' => 'New York City, New York',
'Group' => 'NewYorkCity'
},
); |
Then you need to tell opMaps which map is the default map to load when it starts, by default the default map name is "Default", but you can change this by editing Maps.nmis
vi /usr/local/opmantek/conf/Maps.nmis |
Find the following line under 'mapview' =>
'defaultMap' => 'Default'
Replace the defaultMap with the map you want loaded, in our case "Opmantek-Global:.
eg: 'defaultMap' => 'Opmantek-Global'
NMIS supports Links, it automatically looks at your network and determines the links it can see. It then generates the file /usr/local/nmis8/conf/Links.nmis, you can add sections to this manually and NMIS will keep them and add more (if it finds any).
You can configure opMaps to use the NMIS links to display links on your maps. Have a look at the Links.nmis file.
cat ../nmis8/conf/Links.nmis
%hash = (
'192.168.88.0' => {
'link' => 'LAN',
'depend' => 'N/A',
'interface1' => 'FastEthernet0/0',
'node2' => 'localhost',
'ifSpeed' => 100000000,
'node1' => 'asgard',
'net' => 'wan',
'interface2' => 'eth0',
'ifIndex2' => 2,
'subnet' => '192.168.88.0',
'role' => 'core',
'ifIndex1' => 1,
'mask' => '255.255.255.0',
'ifType' => 'ethernetCsmacd'
}
); |
We will use this link named "192.168.88.0" as a link in our maps. We need to modify the MapLinks.nmis file to add links to the maps, the default MapLinks.nmis looks like the example below.
cat conf/MapLinks.nmis
%hash = (
'Link1' => {
'Group1' => 'WAN1',
'Group2' => 'Sales1',
'Link' => 'BobLan'
},
'Link2' => {
'Group1' => 'xAN1',
'Group2' => 'DataCenter1',
'Link' => 'IPTV'
},
'Link3' => {
'Group1' => 'Cloud',
'Group2' => 'HQ',
'Link' => 'WANEDGE'
}
); |
The Group name is actually Map Entry name, from the example before it would be GoldCoast-AU for the GoldCoast group in the Map Opmantek-AU.
%hash = (
'Link1' => {
'Group1' => 'GoldCoast-AU',
'Group2' => 'Brisbane-AU',
'Link' => '192.168.88.0'
},
'Link2' => {
'Group1' => 'NewYorkCity-NA',
'Group2' => 'MexicoCity-NA',
'Link' => '192.168.88.0'
},
'Link3' => {
'Group1' => 'GoldCoast-Global',
'Group2' => 'Brisbane-Global',
'Link' => '192.168.88.0'
},
'Link4' => {
'Group1' => 'NewYorkCity-Global',
'Group2' => 'MexicoCity-Global',
'Link' => '192.168.88.0'
},
'Link5' => {
'Group1' => 'NewYorkCity-Global',
'Group2' => 'Brisbane-Global',
'Link' => '192.168.88.0'
},
); |
This will create the links and use the status and interface utilisation of the link to color code the map, if the interface goes down, the link will change color.
By default opMaps will display a "TERRAIN" style map, to use an alternate map style, open the Maps.nmis file in /usr/local/opmantek/conf/
vi /usr/local/opmantek/conf/Maps.nmis |
Find the following line under 'mapview' =>
'mapTypeId' => 'mapType'
Replace the mapType with the map type you want.
eg: 'mapTypeId' => 'google.maps.MapTypeId.TERRAIN'
The Follow map types can be used
ROADMAP displays the default road map viewSATELLITE displays Google Earth satellite imagesHYBRID displays a mixture of normal and satellite viewsTERRAIN displays a physical map based on terrain information.opMaps will automatically determine the correct map centre and zoom level for your maps, but sometimes, it will calculate the wrong centre for a human, to use an alternate map centre and zoom level you can follow the following instructions.
To configure the default centres and zoom levels, open the Maps.nmis file in /usr/local/opmantek/conf/
vi /usr/local/opmantek/conf/Maps.nmis |
Find the following lines under 'mapview' =>
'mapCentre' => 'X, Y',
'mapZoom' => 'zoomLevel'
Replace the X,Y and zoomLevel with the value you want.
eg :
'mapCentre' => '10, -180',
'mapZoom' => '3',
To configure the default centres and zoom levels, open the Maps.nmis file in /usr/local/opmantek/conf/
vi /usr/local/opmantek/conf/Maps.nmis |
Find the following lines under 'group' =>,
'mapCentre-groupName' => 'X, Y',
'mapZoom-groupName' => 'zoomLevel',
Replace the groupName with a group name replace the X,Y and zoomLevel with the value you want.
eg:
'mapZoom-Opmantek-US' => '5',
'mapCentre-Opmantek-EU' => '50, 20',