Directory Structure and Locations of Important Trace and Log Files of Enterprise Manager Cloud Control 13c

Because of the size and complexity of the Enterprise Manager Cloud Control software, while browsing through the folders on OMS server, you may feel confused and think that everything is in complete disorder. In fact, the directory structure of EM13c is quite simple. During EM13c installation (“advanced mode”), the installer expects you to enter the folder names:

  • Middleware home location (MW_HOME)
  • OMS instance base location (EM_INSTANCE_BASE)
  • Agent base location

Depending on your inputs, the installer will create a directory structure similar to the below one:

Middleware Home /u01/oracle/Middleware
EM Instance Base u01/oracle/gc_inst
Agent Base /u01/oracle/emagent
EM Instance Home /u01/oracle/gc_inst/em/EMGC_OMS1
EM NodeManager /u01/oracle/gc_inst/user_projects/domains/GCDomain/nodemanager
Middleware Common /u01/oracle/Middleware/oracle_common
Weblogic Domain Home /u01/oracle/gc_inst/user_projects/domains/GCDomain
Admin Server /u01/oracle/gc_inst/…./servers/EMGC_ADMINSERVER
EM Managed Server /u01/oracle/gc_inst/user_projects/domains/GCDomain/servers/EMGC_OMS1
BI Publisher /u01/oracle/gc_inst/user_projects/domains/GCDomain/servers/BIP
OHS /u01/oracle/gc_inst/user_projects/domains/GCDomain/servers/ohs1
Agent Instance Home /u01/oracle/emagent/agent_inst

As you may notice, there are slight differences between directory structures of EM12c and EM13c. For example, in EM13c, there is no separate folder called “oms” in the middleware home. Therefore the binaries located in OMS folder (such as emctl) are now located in the “bin” folder in the Middleware home. Oracle_WT is also merged into the middleware home.

Knowing the directory structure helps you to access the important trace and log files of EM13c. Here’s the trace and log files you may use to diagnose problems about EM13c.

The Trace and Log Files of OMS:

The Oracle Management Service has two applications: OMS Console (emgc) and OMS Platform (empbs). The trace and log files of these applications are located in “sysman/log” directory in the EM Instance Home (for example: /u01/oracle/gc_inst/em/EMGC_OMS1/sysman/log ). These logs are very useful to diagnose OMS related problems.

  • emoms.log The main log file for the OMS Console (emgc) application.
  • emoms.trc The main trace file for the OMS Console (emgc) application.
  • emoms_pbs.log The main log file for the OMS pbs (empbs) application.
  • emoms_pbs.trc The main trace file for the OMS pbs (empbs) application.
  • secure.log This log provides additional logs for “emctl secure oms” command.
  • emctl.log This log contains OMS startup/shutdown details.
  • emctl.msg This log is created by the OMS HealthMonitor thread, when it re-starts the OMS due to a critical error.

The Trace and Log Files of EM Managed Server:

EM Managed Server is the weblogic server hosting OMS applications. The logs are located in “logs” directory in EM Manager Server Home folder (for example: /u01/oracle/gc_inst/user_projects/domains/GCDomain/servers/EMGC_OMS1/logs):

  • EMGC_OMS1.log: The EMGC_OMSn instance writes all messages from its subsystems and applications to this logfile.
  • EMGC_OMS1.out: The messages written to sysout and syserr are saved in this file by the nodemanager. This log file is rotated by the nodemanager only at the time of Managed server start, and older files need to be manually purged.
  • access.log: This log file contains details of HTTP requests processed by EM Managed Server.
  • EMGC_OMS1-diagnostic.log: This log file contains application-related security errors.

The Trace and Log Files of Oracle HTTP Server (OHS)

Oracle HTTP Server (OHS) is the web server component of EM13c. It works as a reverse proxy for Oracle WebLogic Server and the framework for hosting static pages. It’s located in “logs” folder in the “OHS Home” (/u01/oracle/gc_inst/user_projects/domains/GCDomain/servers/ohs1/logs):

  • access_log: Access logs stores all the client requests. The HTTP Response code is useful in identifying whether the client request was successful or not.
  • ohs1.log: This is the error log for the OHS.
  • admin_log: This log file keeps Oracle Dynamic Monitoring Service (DMS) requests.
  • em_upload_http_access_log: The log file contains entries for Agent uploads in http mode.
  • em_upload_https_access_log: The log file contains entries for Agent uploads in https mode.

The Trace and Log Files of EM Agents:

The agent log files are located in the “sysman/log” folder in the “Agent Instance Home” (for example: /u01/oracle/emagent/agent_inst/sysman/log).

  • gcagent.log: This log file contains trace, debug, information, error, or warning messages from the Agent. It can be used for debugging Agent framework issues.
  • gcagent_errors.log: It’s similar to the gcagent.log but it contains only the log messages of ERROR and FATAL levels. The log has no size limit.
  • emagent.nohup: Nohup logs of the agent. This log contains startup and shutdown messages including JVM flags. It can be used to determine when the agent is down, and the errors generated on startup of shutdown can be examined with this log.
  • gcagent_mdu.log: This log tracks the metadata updates (such as save or remove targets, blackouts, deployments of metric extensions) to the Agent.
  • gcagent_sdk.trc: The gcagent_sdk.trc file contains log messages from each of the plugins and can be used for debugging plugin related issues.
  • emctl.log: emctl.log provides logging for emctl commands.
  • emdctlj.log: emdctlj.log contains logging for the entry point and the exit codes of the emctl commands.
  • secure.log: This log provides additional logs for “emctl secure agent” command, and can be useful to diagnose failures during securing of the Agent.
  • emagent_perl.trc: Trace file for the PERL scripts. EM uses perl scripts to gather some metrics and target discovery. The log level can be changed by modifying EMAGENT_PERL_TRACE_LEVEL variable in “sysman/config/emd.properties” file.
Please share
  • 4
  •  
  •  
  •  
  •  
  •  

AWS Big Data Specialist. Oracle Certified Professional (OCP) for EBS R12, Oracle 10g and 11g. Co-author of "Expert Oracle Enterprise Manager 12c" book published by Apress. Awarded as Oracle ACE (in 2011) and Oracle ACE Director (in 2016) for the continuous contributions to the Oracle users community. Founding member, and vice president of Turkish Oracle User Group (TROUG). Presented at various international conferences including Oracle Open World.

10 Comments

  1. Onur

    Thanks for sharing this great post.

    If  agents are installed in some windows servers(e.g as apps server), is there a specific log location within this windows servers for those agents or all of them are logged in the database server?

    Regards,

    Onur

    • Gokhan Atil

      Hi Onur,

      The log locations are not different on Windows servers. They are located in SYSMAN\log folder in the agent instance home. Let’s say you deployed your agent to “C:\oracle\emagent”. In this case, you can find the logs in “C:\oracle\emagent\agent_inst\sysman\log” folder.

  2. Ravi Singh

    HI Gokhan,

    I am discovering oracle supercluster in EM13C .. but all time I am getting error

     

    • Gokhan Atil

      Ravi, what kind of error do you get? You didn’t provide any details. Anyway, it’s better to ask this question on Oracle Community forums or raise a service request.

Leave Comment

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.