Skip to Content

Accessing the web-based interface

To access the web-based interface of the SNMP Configuration Manager, go to http://<hostname>:<port>/snmpadapter or http://<ipaddress>:<port>/snmpadapter.

  • hostname is the computer where you have installed the BMC Event Adapters and the SNMP Configuration Manager.
  • ipaddress is the IP address of the computer where you have installed the BMC Event Adapters and the SNMP Configuration Manager.
  • port is the port you have configured for the SNMP Configuration Manager.
Information
Example

For example, if an Apache Tomcat server is installed at a listening port as a part of the SNMP Configuration Manager installation, you must first launch the Tomcat server by using the following command: installationDirectory\pw\server\SNMPAdapter\run.bat After running this command, launch the SNMP Configuration Manager by using the following URL: http://<tomcathost>:8080/snmpadapter where tomcathost is the name of the host, and the default listening port is 8080.

Warning

Note

The first time that you access the web-based interface of the SNMP Configuration Manager on a Windows 2003 computer, you could get a security dialog box indicating that the content from http://<hostname> has been blocked. To access the web-based interface of the SNMP Configuration Manager, you have to first add http://<hostname> to the list of trusted sites.

The interface displays the following links in the navigation bar:

  • Publish MIBs
  • View / Edit MAP
  • Unpublish MIBs

Publishing MIB files

Publishing MIB files is the process of converting information from the MIB files into cell classes.

To publish MIB files

  1. Click Publish MIBs in the navigation bar.
  2. Click Browse to select a MIB file that is accessible from your local computer. You must specify at least one MIB file. 

    You can use the Add and Remove buttons to create a list of MIB files to be sent for publishing. The add and remove actions do not affect the files saved in the net-snmpdirectory on the BMC Event Adapters.
    • To publish more than one MIB file at a time, click Add. 

      A new row is added below the existing row. 

      You can simultaneously publish a maximum of 10 MIB files.
    • To remove a MIB file from the list, select the check box next to that file, and then click Remove.
  3. To publish the MIB files, click Publish MIBs. 

    You are prompted to restart the BMC Event Adapters.
  4. Click Yes to restart the BMC Event Adapters. 

    The BMC Event Adapters will start receiving events from the devices whose MIB files you have published only after you restart the BMC Event Adapters. Click No if you do not want to restart the BMC Event Adapters at this point. 

    You can view the status of the publish MIBs process in the Publishing Messages area. The message MIB File: mibFileName is not proper might be displayed in the Publishing Messages area. mibFileName is the name of the MIB file that is not proper. To identify the exact reason for this message, you must check the output of the mib2map.pl utility, which is also displayed in the Publishing Messages area. 

    The message MIB File: mibFileName is not properis displayed due to one of the following reasons:
    • The MIB file is not valid.
    • The MIB file is dependent on another MIB file that does not exist in the Net-SNMP directory.

    • The MIB file contains dependencies that do not correspond to the information that is available in the parent MIB file.

      Warning

      Note

      If one or more of the selected MIB files already exist in the Net-SNMP directory, you are prompted to overwrite the MIB files.

      • If you choose to overwrite the MIB files, the existing MIB files in the Net-SNMP directory are replaced with the new MIB files.
      • If you choose not to overwrite the MIB files, only the MIB files that do not already exist in the Net-SNMP directory are published.

For more information about the steps involved in the publish MIBs process, see Using the SNMP Adapter Configuration Manager.

Viewing or editing the MAP file

You can use the View / Edit MAP link in the navigation bar to browse individual event classes in the mcsnmptrapd.map file. The event classes are displayed in a tree structure. You can select an event class, and then add new variables, or edit and remove existing variables from that event class. The modifications that you make in the mcsnmptrapd.map file are not reflected in the corresponding MIB file.

Warning

Note

Each time you edit the MAP file, a backup of the previous version is saved in the installationDirectory\pw\server\tmp\Adapters\snmpAdapter\map directory. The naming convention for the backup files is mcsnmptrapd_mmMonth_ddDay_yyyyYear_hhHrs_mmMins_ssSecs.map.

You can add, edit, or remove the following variables from the mcsnmptrapd.map file:

  • msg
  • mc_tool_class
  • mc_tool
  • mc_host_address
  • mc_location
  • severity
    The values for this variable are UNKNOWN, OK, INFO, WARNING, MINOR, MAJOR, CRITICAL, and DOWN.
  • mc_priority
    The values for this variable are PRIORITY_5, PRIORITY_4, PRIORITY_3, PRIORITY_2, and PRIORITY_1.
  • mc_notes
Error
Warning

When you click View / Edit MAP in the navigation bar, the data for the event classes is copied from the server to your local computer. You can then modify the data for the event classes on your local computer. However, the changes are saved on the server only when you click Update MAP File. When you retrieve the event classes data from the server, the mcsnmptrapd.map file is not locked. While you are modifying the mcsnmptrapd.map file, if the file is modified in another instance and the changes are saved on the server, you will not be able to save the changes you have made to the mcsnmptrapd.map file.

To edit event classes

  1. Click View / Edit MAP in the navigation bar.
  2. Select the event class you want to edit.
  3. Perform the following actions.
    • To add a variable, click Add New. In the Add New Variable dialog box, select the variable, and enter or select the value for that variable.
    • To edit a variable, click the value of that variable. In the Update Value dialog box, modify the value.
    • To remove a variable, select the check box next to that variable, and click Remove.
  4. To save the changes, click Save.
    The changes made to the event class are saved on your local computer. You can edit more than one event class before you save the changes on the server.
  5. To save your changes on the server, click Update Map File.
    You are prompted to restart the BMC Event Adapters.

Click Yes to restart the BMC Event Adapters.
The modifications made to the event classes in the mcsnmptrapd.mapfile are reflected only when you restart the BMC Event Adapters.

Warning

Note

When you modify the variables for an event class, an asterisk (*) is displayed next to that event class in the tree structure view. The asterisk indicates that the mcsnmptrapd.map file has been modified on your local computer.

Unpublishing MIB files

Unpublishing MIB files is the process of removing MIB file entries from the mcsnmptrapd.map file.

To unpublish MIB files

  1. Click Unpublish MIBs in the navigation bar.

  2. Select the MIB file you want to unpublish. The MIB files are listed in an alphabetical order. 

    Press the Shift or Ctrl key to select multiple files. 

    The Unpublishbutton is enabled only when you select at least one MIB file.

    Error
    Warning

    You cannot unpublish a MIB file if other MIB files in the Net-SNMP directory are dependent on it. To unpublish the parent MIB file, you have to first unpublish all the dependent MIB files. However, if you select the parent MIB file and all its dependent MIB files, you can unpublish them simultaneously.

  3. To unpublish the MIB files, click Unpublish. You are prompted to restart the BMC Event Adapters.
  4. Click Yes to restart the BMC Event Adapters. 

    The BMC Event Adapters will stop receiving events from the devices whose MIB files have been unpublished only after you restart the BMC Event Adapters. Click No if you do not want to restart the BMC Event Adapters at this point. 

    You can view the status of the unpublish MIBs process in the Unpublishing Messages area.

For more information about the steps involved in the unpublish MIBs process, see Using the SNMP Adapter Configuration Manager

Related topics

Install-and-upgrade-considerations-for-BMC-Event-Adapters

Installation-consideration-for-the-SNMP-Adapter-Configuration-Manager

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC ProactiveNet 9.6