5
Configuring Oracle Enterprise Manager

This chapter describes how to configure Oracle Management Server, Oracle Intelligent Agent, and the Oracle Enterprise Manager Console 9i (9.2) to manage OracleAS InterConnect.

Topics discussed are:

• Overview

• Configuring Management Infrastructure

• Managing Enterprise Management Components

Overview

Oracle Enterprise Manager 9i, which installs with the Oracle9i Database, consists of the Oracle Management Server, Oracle Intelligent Agents, Oracle Enterprise Manager Console, and the Oracle Enterprise Manager Repository.

Oracle Management Server exposes all Oracle Enterprise Manager services, such as the job system and the event system, and the group and user administration services, to external client applications. In addition to the standard services provided with Oracle Enterprise Manager, additional external services that are unique to a specific client application can be added to Oracle Management Server. Once an external service has been integrated with Oracle Management Server, a client application is able to access all services available to Oracle Enterprise Manager. As part of Oracle Management Server, integrated services are started and shut down along with Oracle Management Server. In case the external service fails prematurely, an error message is reported in Oracle Management Server logs. OracleAS InterConnect offers an external service implementation to monitor the repository and adapters through Oracle Enterprise Manager Console.

Note: OracleAS InterConnect uses the Oracle Enterprise Management components, such as Oracle Enterprise Manager Console and Oracle Management Server, that are shipped with the 9.2 Oracle Database CD. Make sure that these components are configured against the 9.2 hub database.

See Also: Oracle Enterprise Manager Concepts Guide, Release 9.2.0 Oracle Enterprise Manager Administrator's Guide, Release 9.2.0 Oracle Enterprise Manager Configuration Guide, Release 9.2.0.2

Configuring Management Infrastructure

Follow these steps to configure the management infrastructure:

1. Copy and unzip the following file in OMS_ORACLE_HOME and EM_ORACLE_HOME:
   • UNIX: ORACLE_HOME/oai/9.0.4/console/console-unix.zip

   • Windows: ORACLE_HOME\oai\9.0.4\console\console-win.zip

     Note: The following examples provided are UNIX-specific. Follow instructions in ORACLE_HOME\oai\9.0.4\console\console-win.zip for instructions for Windows.

2. Copy oai.jar from OAI_ORACLE_HOME/oai/9.0.4/lib to OMS_ORACLE_HOME/oai/9.0.4/lib and EM_ORACLE_HOME/oai/9.0.4/lib, where
   • OMS_ORACLE_HOME: Oracle home of the Oracle Management Server, 9.2 installation.

   • EM_ORACLE_HOME: Oracle home of the Oracle Enterprise Management Client, 9.2 installation.

     Note: OMS_ORACLE_HOME and EM_ORACLE_HOME can be the same, or separate Oracle homes.

3. Copy OAI_ORACLE_HOME/oai/9.0.4/hub.ini file to OMS_ORACLE_HOME/oai/9.0.4/hub and EM_ORACLE_HOME/oai/9.0.4/hub directories.

The following sections contain postinstallation steps for:

• Configuring Oracle Management Server

• Configuring Oracle Enterprise Manager Client

Configuring Oracle Management Server

The OMSExternralRegistry.registry loads the external service information to the Oracle Management Server repository during the startup. External registry is located in the ORACLE_HOME/sysman/config directory.

Sample registry for OracleAS InterConnect service is located at:

ORACLE_HOME/oai/console/server/omsexternalregistry.tmp

Perform the following steps to configure Oracle Management Server:

1. Navigate to OMS_ORACLE_HOME/oai/9.0.4/console/server directory.

2. Update all files in this directory by changing OMS_ORACLE_HOME to the Oracle home where Oracle Management Server, 9.2 is installed.

3. Append OMSExternalRegistry.registry.tmp to OMS_ORACLE_HOME/sysman/config/OMSExternalRegistry.registry. If the destination file does not exist, create one and append the contents of OMSExternalRegistry.registry.tmp to that file.

4. Copy the following TCL files to the locations specified:
   • filecheck.tcl and createfile.tcl: Copy to OMS_ORACLE_HOME/network/agent/events/oracle/host/generic

   • oai_system.tcl: Copy to OMS_ORACLE_HOME/network/agent/config

5. Append "oai_system.tcl" at the end of OMS_ORACLE_HOME/network/agent/config/nmiconf.lst.

6. Create a directory named notify in the OMS_ORACLE_HOME/network/agent directory, and append "Created by OAI" string to a new file named updown.txt in that directory.

7. Execute the following steps:
   1. Navigate to the OMS_ORACLE_HOME/oai/9.0.4/console/server directory.

   2. Execute the following command:

      post_install_server [oms_repo_user]/[password]@tnsname
      
      

      where tnsname is the hub database tnsname.

Configuring Oracle Enterprise Manager Client

Oracle Enterprise Manager Client Registry is a client side registry which is available to all the Enterprise Manager client applications, including Oracle Enterprise Manager Console, installed on a particular client. Oracle Enterprise Manager Console uses the client side registry to find out about applications which have registered for launch, and objects which are registered for inclusion into the Oracle Enterprise Manager Console navigator. The Enterprise Manager Client Registry is a properties file and is located in the ORACLE_HOME/sysman/config directory with a file name, OEMClient.properties.

Perform the following steps to configure Oracle Enterprise Manager Client:

1. Navigate to the OEM_ORACLE_HOME/oai/9.0.4/console/client directory.

2. Edit the EM_ORACLE_HOME/bin/oemapp file using the following steps:
   1. After the line that starts "XMLCLASSES" variable, add the following as a new line:

      OAIXMLCLASSES=$ORACLE_HOME/lib/xmlparserv2.jar:$ORACLE_
      HOME/lib/xmlcomp.jar:$ORACLE_HOME/oai/9.0.4/lib/oai.jar
      
      

   2. On the line that starts "CLASSPATHADD" variable, add the following:

      ":$OAIXMLCLASSES"
      
      

      Sample:

      CLASSPATHADD=$ORBCLASSES:$BALICLASSES:$HELPCLASSES:$DBUICLASSES:$JDBCCLA
      SSES:$CLASSROOT:$OEMCLASSES:$KODIAKCLASSES:$SECURITYCLASSES:$OSDNETCLASS
      ES:$OSDPKICLASSES:$NETMGRCLASSES:$XMLCLASSES:$NETCHARTCLASSES:$AURORACLA
      SSES:$OLAPCLASSES:$MISCCLASSES:$QSMACLASSES:$OAIXMLCLASSES
      
      

3. Append contents of oai.registry.tmp to EM_ORACLE_HOME/sysman/config/OEMClient.properties.

4. Append contents of oaievents.registry.tmp to EM_ORACLE_HOME/sysman/config/OEMClient.properties.

Managing Enterprise Management Components

This section contains information about managing the following enterprise management components:

• Oracle Intelligent Agent

• Oracle Management Server

• Oracle Enterprise Manager Console

Oracle Intelligent Agent

Use the following commands to start and stop the Oracle Intelligent Agent:

Start: ORACLE_HOME/bin/agentctl start agent

Stop: ORACLE_HOME/bin/agentctl stop agent

Oracle Management Server

Use the following commands to start and stop the Oracle Management Server:

Start: ORACLE_HOME/bin/oemctl start oms

Stop: ORACLE_HOME/bin/oemctl stop oms <username/password>

Oracle Enterprise Manager Console

Use the following commands to start and stop the Oracle Enterprise Manager Console:

Start: ORACLE_HOME/bin/oemapp console

When you run this command, the console window appears. To quit the console, select Exit from the File menu.

See Also: Oracle Enterprise Manager Administrator's Guide, Release 9.2.0 for detailed information on managing Enterprise Management components, including corresponding information for Windows.