The PMM Oracle database monitor uses SNMP to retrieve statistics.

To use this monitor on Windows you must:

  1. Install SNMP support for Windows.
  2. Install SNMP support for Oracle using the Oracle Database installation.
  3. Specify the port where the Oracle master agent is listening.
  4. The required port is specified in the TRANSPORT section of the MASTER.CFG file located in the \ADMIN directory.

    For example, add the following section to the MASTER.CFG file:

    TRANSPORT ordinary SNMP

    OVER UDP SOCKET

    AT PORT 161

    Use port 161 for the Oracle Peer SNMP master agent.

  5. Specify the authentication in the COMMUNITY section of the MASTER.CFG file.
  6. For example:

    COMMUNITY public

    ALLOW ALL OPERATIONS

    USE NO ENCRYPTION

  7. Specify an unused port where the encapsulated agent, such as Microsoft SNMP service, should listen. Microsoft SNMP service typically uses port 1161. The port is specified in the SERVICES file located in the NT_HOME|\SYSTEM32\DRIVERS\ETC directory.
  8. For example, modify the nt_home\system32\drivers\etc\services file from:

    snmp 161/udp

    To:

    snmp 1161/udp

  9. Specify which non-PEER master agents are to be encapsulated by editing the encapsulator configuration file, ENCAPS.CFG, located in the \ADMIN directory. You must add the AGENT entry, including MIB-subtrees manageable by NMS, for the encapsulated master agent.
  10. For example, modify the encaps.cfg file as follows:

    AGENT AT PORT 1161 WITH COMMUNITY public

    SUBTREES 1.3.6.1.2.1.1,

    1.3.6.1.2.1.2,

    1.3.6.1.2.1.3,

    1.3.6.1.2.1.4,

    1.3.6.1.2.1.5,

    1.3.6.1.2.1.6,

    1.3.6.1.2.1.7,

    1.3.6.1.2.1.8,

    1.3.6.1.4.1.77

    FORWARD ALL TRAPS;

    Note: The port (1161) must match the unused port specified in step 5.

  11. Make the “OracleSNMPPeerEncapsulator” service automatic and start it.
  12. Reboot your computer.

Oracle Monitor – Configuration Tasks on UNIX

The PMM Oracle database monitor uses an SNMP Master Agent to communicate with the Oracle Intelligent Agent. The SNMP Master Agent and the Oracle Intelligent Agent must be configured correctly before the Oracle Intelligent Agent can communicate over SNMP to the Master Agent on a UNIX platform. For detailed information on configuring the Intelligent Agent, see the Oracle Enterprise Manager Configuration Guide.

To use this monitor on UNIX you must:

  1. Configure the SNMP Master Agent.
  2. Start the SNMP Agents.
Configuring the SNMP Master Agent

The necessary SNMP files are installed automatically when you install the Oracle Intelligent Agent. After installing the Oracle Intelligent Agent, you will have to edit the following files as described below:

ź   $ORACLE_HOME/network/snmp/peer/CONFIG.master

ź   $ORACLE_HOME/network/snmp/peer/CONFIG.encap

ź   $ORACLE_HOME/network/snmp/peer/start_peer

ź   /etc/snmpd.config

CONFIG.Master (Peer Master Agent file)

To edit the CONFIG.master file:

ź   Find the line beginning with MANAGER and change the IP address coded in this line to match the IP address of the machine where the SNMP traps will be sent.

CONFIG.encap (Peer Encapsulator file)

To edit the CONFIG.encap file:

ź   Find the line AGENT AT PORT. It normally reads AGENT AT PORT 1161 WITH COMMUNITY public.

If you modify the port number from 1161, you must also modify the start_peer script.

start_peer Script

To edit the start_peer script:

Find the line NEW_SNMPD_PORT= and verify that it is using the same port number listed above in the CONFIG.encap file.

Find the line NEW_TRAPD_PORT= and verify the port number is different from NEW_SNMPD_PORT=.

snmpd.config File

To edit the snmpd.config file:

Add the following line to the file:

trap <hostname or ipaddress>

Replace the information in angle brackets with the actual hostname or IP address of the local host where the file is located.

Starting the SNMP Agents

To start the SNMP agents:

1.   Make sure no SNMP components are running. The three main components are the master_peer, encap_peer, and snmpd. If any of these processes are running, use the ps command to find them, and the kill command to terminate the processes.

For example:

ps -ef | grep snmp

This command checks to see if the SNMP Master Agent is running.

2.   Start the PEER Master Agent, PEER encapsulator, and native Digital UNIX SNMP Agent:

cd $ORACLE_HOME/network/snmp/peer

su root

./start_peer -a

This command starts all three processes.

3.   Now use the ps command to verify that all three processes were started:

ps -aux |grep peer

ps -aux |grep snmpd

ps -ef | grep snmp