A Understanding the Enterprise Manager Directory Structure

Before you perform maintenance and advanced configuration tasks, you must be familiar with the directories and files that are copied to disk when you install Enterprise Manager. Understanding where specific files are located can help you if you need to troubleshoot installation or configuration problems.

When installing Enterprise Manager, if you select a location that does not contain WebLogic Server, then JDK will be installed in the jdk16 directory before installation of WebLogic Server.

Use the following sections to become familiar with the directories that are created on your disk when you install Enterprise Manager:

  • Understanding the Enterprise Manager Directories Installed with Oracle Enterprise Manager Cloud Control 12c

  • Understanding the Enterprise Manager Directories Installed with an Oracle Management Service

  • Understanding the Enterprise Manager Directories Installed with Management Agent

A.1 Understanding the Enterprise Manager Directories Installed with Oracle Enterprise Manager Cloud Control 12c

When you install Oracle Enterprise Manager Cloud Control 12c, you install the Oracle Management Service. With the Oracle Management Service, you install the following Oracle home directories:

  • Oracle Management Service home directory

  • Middleware WebTier home directory

  • Middleware Common home directory

  • Oracle Management Service Instance home directory

  • Oracle Management Agent home directory

  • Oracle Management Agent Instance home directory

  • Oracle Management Service Plug-in homes

  • Oracle Management Agent Plug-in homes

  • Oracle Business Intelligence Publisher home

A.1.1 About the Oracle Management Service Home Directory

The Oracle Management Service is a J2EE application that is installed and deployed using the Oracle WebLogic Server.

The installation procedure installs the Enterprise Manager components within the Cloud Control Home, including the Oracle Management Service.

Information about the directories that are specific to the Fusion Middleware installation can be found in the Fusion Middleware documentation.

A.1.2 About the Oracle Management Agent Home (AGENT_HOME) Directory

The Oracle Management Agent Home (AGENT_HOME) directory contains all the binaries required to configure and run the Oracle Management Agent on the host.

This directory serves as the Oracle Home for the Oracle Management Agent.

Information about the directories that are specific to the Fusion Middleware installation can be found in the Fusion Middleware documentation.

A.1.3 About Business Intelligence Publisher Home Directory

The Business Intelligence Publisher is a J2EE application that is installed in the Oracle_BI1 directory. This directory contains all the Business Intelligence Publisher configuration files and software binaries.

The business intelligence publisher directory is created in the Middleware home (middleware_home) directory.

To use the Business Intelligence Publisher, configure it as described in Chapter 14.

A.1.4 Summary of the Important Directories in the Oracle Management Service Home

Figure A-1 shows some of the important directories you should be familiar with in a typical Cloud Control installation. You can use this information as you begin to maintain, troubleshoot, and configure the Oracle Management Service installation.

Figure A-1


Table A-1 Directories Installed with Enterprise Manager

Directory Description

wlserver_10.3, logs, utils, modules

These directories contain Fusion Middleware files.

jdk16

This directory contains JDK configuration files.

oms

This directory contains OMS configuration files. For more information, see Section 10.2.2.

plugins

This directory contains metadata plug-ins configuration files installed on the OMS.

agent

This directory contains agent configuration files. For more details, see Section 10.2.3.

[optional] Oracle_BI1

This directory contains the Oracle Business Intelligence Publisher configuration files.

oracle_WT

This directory contains Oracle WebTier configuration files.

oracle_common

This directory contains common files used by OMS, Oracle WebTier, and WebLogic Server directories.


A.2 Understanding the Enterprise Manager Directories Installed with Management Service

Table A-2 describes in detail the Oracle Management Service directories installed with Oracle Management Service. In the table, ORACLE_HOME refers to the Oracle Management Service home directory in which the Oracle Management Service is installed and deployed.

Table A-2 Important Directories in the Management Service Oracle Home

Directory Description

ORACLE_HOME/bin

The bin directory in the Management Service home contains commands used to control the components of the Cloud Control installation.

 

OMS_INSTANCE_HOME/WebTierIH1

This directory contains WebTier instance Oracle Home corresponding to EMGC_OMS#.

OMS_INSTANCE_HOME/NodeManager

This directory contains WebLogic Node Manager properties, logs, and domain information.

OMS_INSTANCE_HOME/em

This is the OMS instance directory and contains emgc.properties and Enterprise Manager log files.

OMS_INSTANCE_HOME/user_projects

This directory contains EMGC_ADMINSERVER and EMGC_OMS# domains and their logs.

ORACLE_HOME/sysman/log

This directory contains schema log files. The repository log files are under sysman/log/schemamanager. The install logs are under ORACLE_HOME/cfgtoollogs. The operation logs are under OMS_INSTANCE_HOME/em/EMGC_OMS1/sysman/log.


A.3 Understanding the Enterprise Manager Directories Installed with Management Agent

The Oracle Management Agent is installed automatically when you install Oracle Management Service. This local instance of the Oracle Management Agent gathers management information about the targets on the Oracle Management Service host. You can then manage those targets, such as the host itself, from the Cloud Control Console.

You can install additional Oracle Management Agents using different installation methods. This enables you to install the Oracle Management Agent on the hosts throughout your enterprise. The Oracle Management Agent can then gather management data about the targets on each host so those targets can be managed from the Cloud Control Console.

Specifically, the Oracle Management Agent files are installed into the same directory structure shown in the agent directory when you install the Oracle Management Service (Figure A-1).

The agent directory structure, when you install a standalone agent or install the OMS is the same. The AGENT_BASE_DIR is the directory where agent is installed and contains the following main directories:

  • AGENT_HOME

  • AGENT_INSTANCE_HOME

  • SBIN_HOME

  • PLUGIN_HOME

The directory that contains the files required to run the Oracle Management Agent is referred to as the AGENT_INSTANCE_HOME directory. For example, to start or stop an Oracle Management Agent, you use the emctl command located in the bin directory of the AGENT_INSTANCE_HOME. Similarly, to configure files for the Oracle Management Agent, you modify the configuration files in the sysman/config directory of the AGENT_INSTANCE_HOME. See Figure A-2 for the agent directory structure.

Figure A-2 Agent Directory Structure


A.3.1 Summary of the Important Directories in the Oracle Management Agent Home

Table A-3 describes some of the important agent directories.

Table A-3 Important Directories in Oracle Management Agent Home

Directory Description

AGENT_HOME

The AGENT_HOME directory contains all the binaries required to configure and run the Oracle Management Agent on this host.

The default AGENT_HOME location is AGENT_BASE_DIR/core/12.1.0.2.0.

This directory serves as the Oracle Home for the Oracle Management Agent.

AGENT_HOME/bin

This directory contains binaries for the Oracle Management Agent.

AGENT_HOME/install

This directory contains installation-related files for deploying the agent.

AGENT_HOME/prereqs

This directory contains prerequisite files for EMPrereqKit.

AGENT_HOME/oui

This directory contains files related to the installer framework.

AGENT_HOME/cfgtoollogs

This directory contains agent deployment and configuration log files.

AGENT_HOME/EMStage

This directory is used by the provisioning framework for provisioning activities.

AGENT_HOME/sysman/admin

This directory contains the files used by the Oracle Management Agent to define agent core target types (such as databases, hosts, and so on), to run configuration scripts, and other administrative tasks.

AGENT_INSTANCE_HOME

The AGENT_INSTANCE_HOME directory contains agent-related configuration files after agent is installed and configured.

The default AGENT_INSTANCE_HOME location is AGENT_BASE_DIR/agent_inst.

AGENT_INSTANCE_HOME/bin

The AGENT_INSTANCE_HOME/bin directory in the Cloud Control Home contains the emctl command that controls the Oracle Management Agent for this host.

You use the following emctl commands in this directory to start and stop the Oracle Management Agent on this host:

<AGENT_INSTANCE_HOME>/bin/emctl start agent

<AGENT_INSTANCE_HOME>/bin/emctl stop agent

AGENT_INSTANCE_HOME/sysman/config

This directory contains the configuration files for the Oracle Management Agent. For example, this is where Enterprise Manager stores the emd.properties file. The emd.properties file defines settings such as the Oracle Management Service upload URL for this particular agent.

AGENT_INSTANCE_HOME/sysman/log

This directory contains the log files for the Oracle Management Agent.

AGENT_INSTANCE_HOME/sysman/emd

The emd directory contains information about targets discovered on hosts.

SBIN_HOME

This directory contains set UIDs for the agent. The default location is AGENT_BASE_DIR/sbin.

PLUGIN_HOME

This directory contains all the discovery and monitoring plug-ins required for the agent.

The default location is AGENT_BASE_DIR/plugins.


A.3.2 Understanding the Oracle Management Agent Directory Structure in Windows

When you install the Oracle Management Agent on a Windows system, the directory structure of the AGENT_HOME directory is the same as the directory structure for installations on a UNIX system.

A.4 Identifying the Agent Instance Home When Using the emctl Command

When you install Cloud Control, the resulting directory structure can often include multiple subdirectories with the same name. For example, you can have a bin directory within the agent_instance_home directory. Use the emctl command within the agent_instance_home/bin directory to control the Oracle Management Agent.

In addition, you can have a bin directory within the Oracle Management Service Oracle home. Use the emctl command in this directory to control the Oracle Management Service.

To quickly identify the Agent Instance home that is controlled by the files in a particular bin directory, use the following command:

$PROMPT> emctl getemhome

This command displays the path to the current Agent Instance home that will be affected by commands executed by this instance of the emctl command.