Home / How Tos

How Tos


How Tos

  1. How to move OpManager from trial to production server?

  2. How to enable/disable SSL in OpManager?

  3. How to enable SSL for NetFlow Plug-in?

  4. How to configure SNMP V3 credentials for discovery?

  5. How to avert false alerts?

  6. How to embed widgets into other webpages?

  7. How to configure Uptime alerts?

  8. How to import from CSV file for discovery?

  9. How to ignore VLAN interfaces?

  10. How to disable Switch Ports?

  11. How to configure thresholds for multiple interfaces?

  12. How to draw Layer 2 maps?

  13. How to export Layer 2 maps to Visio?

  14. How to increase the field length of an alarm message?

  15. How to change timezone in OpManager?

  16. How to forward traps from OpManager?

  17. How to monitor the services running in the secondary IP address of the server?

  18. How to add custom WMI monitors in OpManager

  19. How to change an interface as a WAN Interface in OpManager

  20. How to configure receiving of traps from the source router when monitoring WAN links?


How to move OpManager from trial to production server?

If you plan to take the trail installation as it is to production, all you need to do is register the license. Click the Register link on the top right corner in the Web console, browse and select the license file that you received from us and get going.

If you are planning to move the trial onto a new server to host it in production, here are the steps you need to follow:
  1. Stop the trial edition.
  2. Backup the data.
  3. Install OpManager on the production server.
  4. Register it using the license procured.
  5. Stop OpManager
  6. Restore the backed-up data
  7. Start OpManager.



How to enable/disable SSL in OpManager?

Steps to enable or disable SSL in OpManager:

For OpManager build 8050 and above.
  1. Open a CMD prompt and go under /OpManager/bin
  2. Execute ssl_gen.bat -f Enable
This will enable the self signed SSL certificate for OpManager. OpManager webclient can be accessed in the same port number with https://

To Disable the SSL :
  1. Open a CMD prompt and go under /OpManager/bin
  2. Execute ssl_gen.bat Disable     [It is not required to use -f while disabling the SSL]              
This will disable the self signed SSL certificate for OpManager. Hence the web-client can be accessed in the same port number with http://

For Builds older than 8050. (We have removed apache in build 8050)

1. Stop OpManager Service.

2. Ensure service window(services.msc) is closed.

3. Invoke the opmanagerservice.bat from the prompt
OpManager[home] > bin > OpManagerService.bat -r

4. Rename apache folder under opmanager home.

5. Download the apache.zip file attached below and extract it under opmanager home.

6. From command prompt go to OpManager[home] > bin folder and execute the script ssl_gen.bat

7. Go to opmanager home > bin > run the command below:

OpManagerService.bat -i

8.Start OpManager server.

Now you can try connecting to the web client with https i.e https://IPAddress:Port Number
Eg: https://192.168.223.23:80

Note: The above steps will work with OpManager build 7010 and above.

How to enable SSL for NetFlow Plug-in?

If you have installed NetFlow plug-in, then follow steps given below. These steps should be followed only if OpManger is SSL enabled.
  1. Ensure that SSL has already been enabled in OpManager.
  2. Stop the OpManager Service
  3. Download and unzip the NetFlow_ssl.zip under \OpManager folder.
  4. Run the ssl_gen.bat present under \OpManager\NetFlow\bin.
  5. This will create NetFlow.truststore and server.keystore under \opmanager\NetFlow\server\default\conf\ssl folder.
  6. Start the OpManager service.
The NetFlow plug-in will also be SSL-enabled now.

How to configure SNMP V3 credentials for discovery?

SNMPv3 is a user based security model. It provides secure access to the devices by a combination authenticating and encrypting packets over the network. The security features provided in SNMPv3 are Message integrity, Authentication and Encryption. If you select SNMPv3 as the credential type, then configure the following parameters. 

  1. Name: Enter the name of the credential.
  2. Description: Enter a brief description about the credential.
  3. User Name: Enter the name of the user (principal) on behalf of whom the message is being exchanged.
  4. Context Name: An SNMP context name or "context" in short, is a collection of management information accessible by an SNMP entity. An item of management information may exist in more than one context. An SNMP entity potentially has access to many contexts. In other words, if a management information has been defined under certain context by an SNMPv3 entity, then any management application can access that information by giving that context name. The "context name" is an octet string, which has at least one management information.
  5. SNMP Port: Enter the SNMP port number.
  6. Authentication: Select any of the authentication protocols either MD5 or SHA and enter the password. MD5 and SHA are processes which are used for generating authentication/privacy keys in SNMPv3 applications.
  7. Encryption: Select any of the encryption protocols either DES or EAS-128 and enter the password.
  8. Note: Only after configuring Authentication it is possible to configure Encryption.


How to avert false alerts?
Here are a few things that you can do to avert false postives:

1. Suppress Alarms for device: Its possible that you have pulled down some devices for maintenance or a device has crashed and may not be up any time soon. Tell OpManager to stop sending alerts for such devices. Go to the device snapshot page > Actions menu > Suppress Alarms   and select the period for which you like the alarms suppressed.

2. Set up thresholds: When configuring thresholds, specify the consecutive failure counts. For instance, if the poll interval is 5 mins, a device might not respond to a poll due to a transient spike leading to a 'down' alert. The subsequent polls will succeed and you will find 'clear' alerts. This erratic up-down alerts can be avoided by letting OpManager alert you after 3 consecutive polls.

3. Configure device dependencies: If a router or a firewall is down, the devices behind these do not respond to polls resulting in unnecessary 'down' alerts. Configure device dependencies so that OpManager does not monitor a set of devices if the dependent device is down.

4. Optimize Syslog Rules: The consecutive failure counts can be specified even when parsing syslogs. The advanced syslog configuration screen contains a field where you can indicate the number of occurrences.

How to embed widgets into other webpages?

OpManager lets you create powerful dashboards with over 90 widgets to choose from. The widgets display different fault and performance data with provision to drill-down. To know your network health at a glance, all you will need is a quick look at your favorite network management console , OpManager :)

We have had a few users asking us in our forums or writing to us at support to know if OpManager widgets can be embedded into their web pages.  Yes, OpManager  provides the flexibility of embedding widgets or dashboards into a web page, making it easier for a user or a group to access a specific set of information without having to log in and log out every time.

You can embed a widget or a dashboard using an <iframe>. For the benefit of those who have not seen the procedure posted in our forums, here are the steps:

Embedding a Widget

The code snippet to embed a widget is given below:

<iframe src="http://OpManagerServerName:Port/generateWidget.do?widgetID=194&widgetWidth=520" width=520 height=400 frameborder="1" scrolling="no">

In the above snippet, replace the src name with the actual host name and the port number on which OpManager is hosted and the ID of the widget that you want to embed. Mouse-over the edit icon on the top right corner of the widget to see the ID.

Embedding a Dashboard

You can embed the default dashboards or create a new dashboard and embed.

Here is the snippet to embed a dashboard:

<iframe src="http://OpManagerServerName:Port/customDashboard.do?methodCall=showCustomDashboard&dashboardID=303" width= height=in_pixelsin_pixels frameborder="1">

The snippet to access the dashboard without having to log-in every time is:

<iframe src="http://OpManagerServerName:Port/customDashboard.do?methodCall=showCustomDashboard&dashboardID=303&reqUserName=guest_user&reqPassword=guest_password" width=in_pixels height=in_pixels frameborder="1">

where the user name and password are passed as additional arguments.

Replace the user name, password and the dashboard ID. Access the required dashboard from the WebClient to see the ID passed in the url.



Here are the steps to discover large number of nodes/networks by importing them from a CSV file. 

  1. Create a csv file with the details of name/ipaddress of the device, displayname and device type.
  2. Browse and load the CSV file.
  3. Once it get loaded, you can see field details,  'Configure fields from CSV file'.
  4. The file is parsed and the headers are shown on the right hand side.
  5. Once you see the headers for each row, you can map the requried fields to the csv file. 
  6. After you click 'Ok' and click 'Discover', it will work.
    1.  
Note: DeviceName/IP header is a must for CSV file and other header fields are optional.

How to ignore VLAN interfaces?

To ignore VLAN interfaces,

  1. Click on the router name to see the device snapshot page.
  2. In the Action menu (just above device availability chart) in the device snapshot page, access Configure Interfaces menu (for switches, the menu name is Configure Ports).
  3. Remove monitoring/status poll option for the VLAN interfaces.
Note: To disable Virtual LAN globally, try interface template.


How to disable switch ports?
If you want to administratively disable an interface, it is possible with OpManager in just a few clicks. Here are the steps:
  1.     Go to the required snapshot page of the interface that you want to disable.
  2.     Under Interface tab, click the Disable button.
The interface gets disabled and the interface's status is changed to Down. To enable the interface again, go to its snapshot page and click the Enable button under the Interface tab.

How to configure thresholds for multiple interfaces?

You can configure thresholds for multiple interfaces of the same type by editing the relevant interface templates.
  1. Go to Admin-->Interface Templates page
  2. Click Edit icon corresponding the interface type.
  3. Modify the threshold.
  4. You can now apply the modified threshold to all interfaces of this type (say Ethernet), or apply to few chosen interfaces. You must select the appropriate option here to apply the threshold changes.
  5. Save and proceed to effect the new threshold configuration.

How to draw Layer 2 maps?

OpManager purely relies on SNMP to represent the connectivity of nodes and links in the network.

1. Configure a seed device : A seed device is the core switch in your network. The switch must have SNMP-enabled so that OpManager is able to query the device and draw the links automatically, showing the connectivity of all the devices on your network. As changes happen to the networks frequently, OpManager allows you to configure an interval (in days) to re-draw the map. For instance, if a change happens once in a week, you can configure OpManager to re-draw the map every seven days.

From the OpManager dashboard, select Maps --> Network Maps link (mouse-over the Maps tab to see the links to all the maps).
In the Networks Map, select Actions --> Settings menu to your right.
You will find a combo-box to select the seed device. Select the core switch from the list.
Select the topology layout from the layout combo-box.
Specify the interval (in days) at which the map must be re-drawn in the Sampling Interval field and click Submit.

The map is generated. You can change the layout by selecting the type as Radial Tree, Balloon Tree, Node Link or Custom option for the Layout combo-box on top of the network map. You can also export the map to Visio, or even save it as a business view in OpManager.

How to export Layer 2 maps to Visio?

Exporting to Visio

Prerequisites

Make sure you have Microsoft Visio 2007. Visio can be installed on any of your Windows devices and it need not be on the same server as OpManager. Ensure that you are able to access OpManager Weblcient from the machine where Visio is installed.

Installation

    Download OpManager Add-in for Microsoft Visio from here.
    Unzip the add-in download and extract the file ManageEngineOpManagerMicrosoftVisioAddin.msi.
    Double-click the msi file to install the Add-in.
    After successful installation, launch Visio and look for OpManager menu in the menubar. The add-in has installed properly if you find the menu!

Exporting Views from OpManager

    Access OpManager webclient from the machine where MS Visio 2007 is installed.
    You can export the map to Visio from the Network Maps link using Actions --> Export to Visio menu.
    You can also export it from the business views using the Export to Visio button on top of the corresponding business view.
    On exporting, you will be prompted to save the corresponding XML file with the name TopoMap.xml. Save the map in the desired location on that machine.

Loading the exported maps in Visio

    From the Visio GUI, access OpManager --> Load Map menu from the menubar.
    Browse and select the TopoMap.xml (you can rename the xml after you save it on the machine). The exported map will be loaded in Visio.
    Make the desired changes and save. You can save the diagram as a vsd file or in standard Visio formats.

How to increase the field length of an alarm message?

To increase the size to say, 300 characters,
  • Shut down OpManager Server.

  • In the DatabaseSchema.conf, in addition to increasing the field length, change the data type from VARCHAR to TEXT.

  • Connect to database using this command   

          C:\\..\\OpManager\\mysql\\bin>mysql.exe -u root -P 13306 OpManagerDB

  • Modify the column in the database too by executing the following query from the SQL prompt:     

          ALTER table Alert modify MMESSAGE TEXT;
          
  • Change the MAXIMUM_DBCOLUMN_LENGTH value in serverparameters.conf in /conf directory as: MAXIMUM_DBCOLUMN_LENGTH 300
           
  • Restart OpManager Server

How to change timezone in OpManager?

To change the timezone in OpManager,
  1. Download the attached jar file and save it under /OpManager folder. [ rename the time.jar.txt file as time.jar ]
  2. Execute the following command:
    • cmd> cd [OpManagerHome]
    • cmd> jre\bin\java -cp time.jar Time
  3. The timezone as provided by this script output should be the same as your default time zone.
  4. If not, change the timezone to any other value using Date and Time Properties from the Control Panel.
  5. Reboot the server.
  6. Execute the commands as mentioned in step 2 above. The timezone by the script output should be the same as the value set.
  7. Reset the timezone to the original value.
  8. Reboot the server.
  9. Execute the commands as mentioned in step 2 above. The timezone by the script output should be the same as the value set.
Attached Files : time.jar.txt 606 B

How to increase the ping timeout?

For the all the devices by default OpManager sends one packet with time out as 1 sec. So if the WAN link stays busy, it is expected that OpManager will show that the devices on the other side as down. You can resolve this problem by increasing the ping time out, if needed even the packets sent to check the availability. However this facility will be common for all the device i.e. it is a global configuration.

Solution:
1. Edit the file \\OpManager\\conf\\Ping.properties

2. Remove the "#" against "timeout=1" and Change the timeout value to 4. This setting will make OpManager to wait for 4 seconds, if the device did not respond.

3. If you wish to change the number of packets sent to check the availability of the device, remove the "#" against "count=" specify the desired number of packets to be sent to check the availability.

4. Save and exit the file after the changes and Restart OpManager service for the changes to take effect.

How to move OpManager from trial to production server?

How to forward traps from OpManager?

Yet another frequently asked/discussed requirement is the ability to forward alarms in OpManager as traps to another trap destination. Requests are also raised to know if the incoming trap can be redirected to another application. YES, both are possible. Here is how you go about the forwarding:

Forwarding Traps

 

Here, OpManager simply forwards the SNMP Trap to another manager/device. Forwarding traps from OpManager involves a couple of configuration changes in two files. Refer the table below:

1. Effect the following configuration changes:

File name & path Existing entry Modified entry

/opmanager/conf/trap.forwarder



(replace with the correct
IP address and port)
/opmanager/conf/trap.filters





2. Save the file and restart OpManager.

OpManager starts forwarding the incoming traps to the destination IP address and the Port mentioned in the trap.forwarder file.

Forwarding OpManager Alarms as Traps

 

You might want to forward the alarms in OpManager as traps to another destination/trap receiver. Here is how you do it:

1)Ensure Net-SNMP is installed on the OpManager server or download from the links given at the end of this post:

2)Create a batch file sendtrap.bat to invoke the snmptrap command. Place this file in  /opmanager folder. The syntax for this command is as follows:

snmptrap options hostname community trap parameters...

For Version 1, the required trap parameters are:

enterprise-oid agent trap-type specific-type uptime objectID type value...

The code snippet for this batch file is given below:

snmptrap -v 1 -c public %1 .1.3.6.7.2.1.3.1 %2 1 6 10000 .1.3.6.7.2.1.3.1.1.2 s "%3,%4,%5,%6"

where

-v 1 The SNMP version
-c The community string and the default SNMP community string is public
%1 The manager name, viz., the hostname or the IP address of the manager that must receive traps.
.1.3.6.7.2.1.3.1 Specify the appropriate enterprise OID
%2 The agent-name, that is the hostname or the IP address of the device for which an alarm is generated.
.1.3.6.7.2.1.3.1.1.2 Replace with the appropriate specific OID
1 The generic type number
6 The specific type number
10000 The sysUptime in milli-seconds
s Refers to the data type of the OID (string type)

"%3,%4,%5,%6"

(replace the % symbol with $ if you are doing it on a Linux box)

The message from OpManager that can contain one or more of the following variables:

  • $displayName - the Displayname of the device
  • $strModTime - the time when the alarm was generated
  • $category - the category to which this device belongs to
  • $severity - the severity of the alarm
  • $message - the message of the alarm ( like Web Service Down or Threshold Violated ).

3)Configure a 'Run Program' notification profile specifying the following:

Command Name: sendtrap.bat

Program Arguments :[manager-name] $source $displayName $strModTime $category $severity $message

3. You can associate this notification profile to devices using the Quick Configuration Wizard. Whenever an alarm is generated on the managed devices, a trap is sent to the other monitoring server.

NET-SNMP download (zip)

NET-SNMP download (exe)


How to monitor the services running in the secondary IP address of the server?
You can modify the IP Address to look at from the database, so that OpManager uses the secondary interface to monitor the service running on this interface alone.

Here is the procedure to do this.

1. Connect to mysql database using the following command:

cmd> cd [OpManagerHome]\\mysql\\bin
cmd> mysql.exe -u root -P 13306 OpManagerDB

2. Use the mysql update command to change the IP address to look at:

mysql> update InetService set TARGETADDRESS=1.2.3.4' where TARGETADDRESS='5.6.7.8';

1.2.3.4 is the secondary interface of the device
5.6.7.8 is the primary interface of the device. OpManager should have discovered the device through this interface.

And update the TARGETADDRESS only for the interface on which a particular service runs.

Try using the following command :

mysql> update InetService set TARGETADDRESS='1.2.3.4' where TARGETADDRESS='5.6.7.8' and NAME='machine-name-or-ip-address_ServiceName_Portnumber';

where machine-name-or-ip-address refers to the machine name or ip address of the device to be monitored ( it is mostly the primary interface in case of ip address)

ServiceName is the name of the service to be monitored which can one among Web, FTP, Telnet, MySQL etc.. as specified under Admin -> Service Monitors

Portnumber is the port on which the service runs like 80, 21, 23, 3306 etc... 

How to add custom WMI monitors in OpManager?

To add a custom monitor for a resource of a particular device type, the device template must be modified. The new monitor should be defined in the device template so that the monitor is associated for all devices of that type. Here are the steps.
  1. Go to Admin --> Device Templates.
  2. Select the template in which you want to add a new monitor. Eg: Windows XP (Click the letter W to display templates starting with this letter).
  3. From here, click any template. Example -Windows XP. Scroll down the template and click Add Monitors under Monitors column.
  4. Click the New Monitor --> WMI link in this page.
  5. Select a device name that OpManager can query. OpManager executes a WMI query on the device and checks the response.
  6. Specify the WMI credential to be used for that device. OpManager needs to authenticate itself to the device using the WMI credential specified.
  7. Configure the interval at which the resource should be monitored and click Next.
  8. Select the WMI Class to list the performance counters present in that WMI Class.
  9. Select the Performance counters and the instances (the instances are also listed here) that require monitoring and click on OK. The monitors are added to the template.
  10. Click on Apply to apply this template to the required Windows devices.
Applying the template to the other devices, adds the new custom monitors to all the selected devices, and the selected resources are monitored at the interval configured in the template.

Note: While selecting the WMI class, current value shown on mouse over is the raw data and it is NOT the value calculated using the appropriate counter type of the WMI performance counter.Upon associating to devices, counter values will be calculated based upon the counter types.

How to change an interface as a WAN Interface in OpManager?

BY default these are the list of interface types( type number and name) which are considered as WAN interfaces inside OpManager.

18 DS1
20 Basic ISDN
21 Primary ISDN
22 Serial
23 PPP
32 Frame Relay DTE
33 RS-232
37 ATM
44 Frame Relay DCE
45 V35
49 AAL5
63 ISDN
64 V11
94 ADSL
96 SDSL
166 MPLS

To include  any other  type of Interface  as a WAN interface to get SLA dashboard "WAN links by availability" report, we need to add the specific type  into a  table called "WANINTFTYPES"

For example to add an Ethernet/Fast Ethernet  (which is of type 6) as a WAN interface, connect to the DB and run this query:

To connect to the Database (Mysql):

1) Open the command prompt

2) Go to the Mysql\bin  directory and type the following

     \\OpManager\mysql\bin>mysql -u root -P 13306 opmanagerdb

3) execute the following statement

4) mysql > insert into wanintftypes values(6);

5)exit

Stop and Start Opmanager and generate the  report for Wan links . You can see all the Ethernet interfaces included in the report.

How to configure receiving of traps from the source router when monitoring WAN links?

To receive alerts from the device,  make sure you configure the routers to send traps to OpManager (you will not receive alerts from the device if the trap host is not configured in the source router). Telnet the router and type the following command:

snmp-server host (opmanager server IP) traps (host community string) rtr
For instance, if the OpManager host IP Address is 192.168.18.128, and the community string is private, the command would be:
snmp-server host 192.168.18.128 traps private rtr




    Post a comment

    Your Name or E-mail ID (mandatory)

     

    Note: Your comment will be published after approval of the owner.




     RSS of this page