E SNMP Components

Simple Network Management Protocol (SNMP) is an application-layer protocol that allows the exchange of information on the management of a resource across a network. SNMP lets you to monitor a resource and, if required, take some action based on the data obtained from the resource.

For detailed information on SNMP, see the Oracle Fusion Middleware SNMP Management Guide for Oracle WebLogic Server.

E.1 Creating and Using SNMP Agents

This section provides guidelines on creating and targeting SNMP agents in an existing Oracle WebLogic Domain to trap SNMP messages generated by Oracle Service Bus.

For instructions on creating and targeting SNMP agents, see the following topics in the Oracle Fusion Middleware Oracle WebLogic Server Administration Console Online Help:

  • Create SNMP agents

  • Target SNMP agents

  • Create trap destinations

E.1.1 Guidelines for Creating and Targeting SNMP Agents for Oracle Service Bus

You can create SNMP agents that are either domain-scoped or server-scoped. Domain-scoped agents, which are targeted to the domain rather than to an individual server, are for backward compatibility and are being deprecated. Oracle recommends that you create server-scoped agents.

When creating and targeting an SNMP server-scoped agent for Oracle Service Bus, use the following guidelines:

Targeting the Agent

When targeting an SNMP agent to Oracle Service Bus, target only the Oracle Service Bus Admin Server. Only agents targeted to the Admin Server receive alerts from Oracle Service Bus. Agents targeted to Managed Servers do not receive SNMP messages.

Creating a Trap Destination

Enter the following settings:

  • Name: alsbDestination-0

  • Community: weblogic

  • Host and Port: Set the values to point to the host and port where the SNMP manager is listening for these alerts, such as localhost and 163.

To Start Listening for Traps

  1. In a command window, change directories to WL_ORACLE_HOME/server/bin, and run the following command:

    setWLSEnv.cmd(.sh)
    
  2. Run the following Java command to start the Oracle WebLogic Server SNMP command line utility, which listens for traps and prints them on the server console (using 163 as the listen port for traps):

    java weblogic.diagnostics.snmp.cmdline.Manager SnmpTrapMonitor -p 163
    

    From then on, the traps generated within Oracle Service Bus should reach the running command line utility listening for traps.

    Note:

    On Solaris, port numbers 0 to 1023 are reserved for root login. If you want to use ports 161 and 163 (as used in this procedure), you may have to start the server and command line utility using root login. To avoid this problem, and to avoid using the root login, specify port numbers above 1023 for both the SNMP agent and the SNMP manager command.