Subject: Configuring the Intelligent Agent on UNIX.
Creator: SDADDOLA
Modified: 09 May 97 09:55:26
In order to run Oracle Enterprise Manager Intelligent Agent on UNIX platforms,
it is necessary to apply a mandatory patch to the Intelligent Agent. The patch
is not shipped with the server bundle which contains the Intelligent Agent
software.
The appropriate patch should be applied to the Intelligent Agent. If there is
no specific patch listed below for an Agent installed in an v7.3.2.3
ORACLE_HOME then for most platforms it should be safe to apply the v7.3.2.2
copy of the patch.
The patchutil script which applies the patch is non-destructive and so the
patch can be backed out if necessary.
For proper configuration of the Intelligent Agent, the configuration files used
on both the NT OEM console and the managed UNIX node must be created by Network
Manager. The Intelligent Agent is particularly sensitive to the syntactic format
of the SNMP.ORA file and support will not be given if the files are generated
by any other means then netman.
When generating the SNMP.ORA file be aware that the port which the Intelligent
Agent listens on [defined in the DBSNMP.ADDRESS and DBSNMP.SPAWNADDRESS] is NOT
the same as the address used by the LISTENER. These port number should be unique
on the system. An example of the format of the SNMP.ORA file is included below.
Once generated using netman, copy all the configuration files - tnsnames.ora,
snmp.ora, listener.ora - to the appropriate managed server. It is important that
the entries in the snmp.ora for VISIBLESERVICES etc can find exact matches on
the tnsnames aliases in the local tnsnames.ora file.
The Intelligent Agent is managed on the managed UNIX node by means of the
lsnrctl command interface. To start, stop or obtain status information from
the Agent issue the following commands;
lsnrctl dbsnmp_start
DBSNMP for HPUX: Version 7.3.2.2.0 - Production on 25-FEB-97 16:25:55
Copyright (c) Oracle Corporation 1996. All rights reserved.
NMS-00001: Warning: dbsnmp unable to connect to SNMP master agent
lsnrctl dbsnmp_status
The db subagent is already running.
lsnrctl dbsnmp_stop
The NMS-00001 error is normal and can be ignored. It simply means the Agent was
unable to contact the SNMP master agent. It is not necessary to run SNMP on the
managed node in order to run Enterprise Manager.
Startup of the Agent may fail with the following errors;
NMS-00001: Warning: dbsnmp unable to connect to SNMP master agent
NNL-00018: warning: could not contact default name server
NL-00851: control program finished
This is caused by the Agent attempting to register with the Oracle Names server
which is erroneously assumes to have been configured. To prevent this error on
startup, add the following line to the server SNMP.ORA file;
NMI.REGISTER_WITH_NAMES = FALSE
INTELLIGENT AGENT PATCHES FOR UNIX.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Here's an updated list of Intelligent Agent patches for UNIX platforms,
available on tcpatch. If you do not have access to tcpatch you can obtain the
patches via World Wide Support. (Accurate on 04-FEB-97).
/u01/patch/HP9800/7.3.2.2/IAPatch_7322
/u01/patch/SNI_RM400-600/7.3.2.2/IA_PATCH_7322
/u01/patch/ALPHA_OSF/7322_ia_patch <-- Note different patch bundle name.
/u01/patch/DG_AViiON_612/732.1/IApatch_7322
/u01/patch/DG_AViiON_612/732.2/IApatch_7322
/u01/patch/DG_AViiON_612/7323/IApatch_7322
/u01/patch/IX86/7.3.2/IApatch_7322
/u01/patch/DG_AViiON_162/732.1/IApatch_7322 DG Aviion Intel
/u01/patch/DG_AViiON_162/732.2/IApatch_7322 DG Aviion Intel
/u01/patch/DG_AViiON_162/7323/IApatch_7322 DG Aviion Intel
/u01/patch/NCR_3000/IApatch_7322
/u01/patch/SGI/7.3.2.1/IApatch_7322
/u01/patch/SGI/7.3.2.2/IApatch_7322
/u01/patch/SGI/IApatch_7322
/u01/patch/PYRAMID_DCOSX/7.3.2.1/IApatch_7322
/u01/patch/PYRAMID_DCOSX/7.3.2.2/IApatch_7322
/u01/patch/INTEL_SVR4/7.3.2.2/IApatch_7322
/u01/patch/INTEL_SVR4/7.3.2.1/IApatch_7322
/u01/patch/NEC_EWS4800/MIPSABI/7.3.2.2/IApatch_7322
/u01/patch/NEC_EWS4800/MIPSABI/7.3.2.1/IApatch_7322
/u01/patch/PYRAMID_RM1000/7.3.2/IApatch_7322
/u10/patch/SUN_SOLARIS2/7.3.2.1/IApatch_7322
/u10/patch/SUN_SOLARIS2/7.3.2.2/IApatch_7322
/u01/patch/SEQUENT_PTX/7.3.2.1/IApatch_7322
/u14/patch/IBM_RS6000/7.3.2/IApatch_7322 See note (1).
/u14/patch/IBM_RS6000/7.3.2.2/IApatch_7322 See note (1).
NOTES;
(1). Intelligent Agent Patch for V7.3.2.2 for IBM SP/2
There is no Intelligent Agent Patch for V7.3.2.2 for IBM SP/2, as there is no
V7.3.2.2 release for SP/2. You cannot use the AIX IApatch for V7.3.2.2. In
order to use the Intelligent Agent on SP/2, you will need to upgrade to
V7.3.2.3, which is just becoming available.
SAMPLE SNMP.ORA FILE.
~~~~~~~~~~~~~~~~~~~~~
################
# Filename......: snmp.ora
# Date..........: 03-FEB-97 17:42:32
################
#
# Sample SNMP.ORA configuration file, for REFERENCE ONLY.
# SNMP.ORA FILE MUST BE GENERATED BY NETWORK MANAGER.
#
################
# Trace levels can be OFF or 0-15
#
NMI.TRACE_LEVEL = OFF
NMI.TRACE_MASK = (106)
NMI.TRACE_DIRECTORY = /oracle/app/oracle/product/7.3.2.3/network/trace
#
# If your site doen't use Oracle Names, then add the following line to prevent
# the associated warning message being issued.
#
NMI.REGISTER_WITH_NAMES=FALSE
#
# NOTE: The following lines have been split over more than one line for clarity.
# normally the DBSNMP ADDRESS lines must be entered on a single line.
#
DBSNMP.ADDRESS = (DESCRIPTION=(ADDRESS=(COMMUNITY=TCP.uk.oracle.com)
(PROTOCOL=TCP) (Host=uknode.uk.oracle.com)(Port=1748)))
DBSNMP.SPAWNADDRESS = (DESCRIPTION=(ADDRESS=(COMMUNITY=TCP.uk.oracle.com)
(PROTOCOL=TCP) (Host=uknode.uk.oracle.com)(Port=1754)))
#
# NOTE: The following lines have been split over more than one line for clarity.
# normally the SNMP.VISIBLESERVICES must be entered on a single line.
#
# The list of visible services must include entries for all objects being
# managed/monitored.
#
SNMP.VISIBLESERVICES =(LISTENER_uknode.uk.oracle.com,uknode_V7323.uk.oracle.com,
uknode_V723.uk.oracle.com,uknode_V716.uk.oracle.com)
#
# The SNMP.INDEX_alias entries must have unique indicies on a given UNIX server.
#
SNMP.INDEX.LISTENER_uknode.uk.oracle.com = 4
SNMP.INDEX.uknode_V7323.uk.oracle.com = 9
SNMP.SID.uknode_V7323.uk.oracle.com = V7323
#
# If the server has more than one discrete ORACLE_HOME then define an entry
# for SNMP.ORACLEHOME.alias for each instance.
# Note: On NT the Agent won't start unless this parameter is defined.
#
SNMP.ORACLEHOME.uknode_V7323.uk.oracle.com = /oracle/app/oracle/product/7.3.2.3
#
SNMP.INDEX.uknode_V723.uk.oracle.com = 7
SNMP.SID.uknode_V723.uk.oracle.com = V723
SNMP.ORACLEHOME.uknode_V723.uk.oracle.com = /oracle1/V723
#
SNMP.INDEX.uknode_V716.uk.oracle.com = 8
SNMP.SID.uknode_V716.uk.oracle.com = V716
SNMP.ORACLEHOME.uknode_V716.uk.oracle.com = /oracle1/V716