6 Logs and Directories

The Logs tab in the Administration section displays the contents of each of the log files that Enterprise Manager Ops Center maintains.

Installation

  • Log of a failed installation: /var/tmp/installer.log.xxxx

  • Log of a successful installation: /var/tmp/installer.log.latest

  • Log of an agent installation: /var/scn/install/log

General

  • Messages: /var/adm/messages*

  • BUI: /var/opt/sun/xvm/logs/emoc.log

  • Actions of the BUI and remote clients on the Enterprise Controller:

    • On Oracle Solaris: /var/cacao/instances/oem-ec/audits/

    • On Linux: /var/opt/sun/cacao/instances/oem-ec/audits/

  • Events between controllers and agents:

    • On an Oracle Solaris Enterprise Controller: /var/cacao/instances/oem-ec/logs

    • On a Linux Enterprise Controller: /var/opt/sun/cacao/instances/oem-ec/logs

    • On each Oracle Solaris Proxy Controller: /var/cacao/instances/scn-proxy/logs/cacao.n

    • On each Linux Proxy Controller: /var/opt/sun/cacao/instances/scn-proxy/logs/cacao.n

Software Updates

The Software Update component has its own server with its own logs. The following logs provide information on the activity for this server:

  • Audit Log

    • On Oracle Solaris: /var/opt/SUNWuce/server/logs/audit.log

    • On Linux: /usr/local/uce/server/logs/audit.log

  • Errors

    • On Oracle Solaris: /var/opt/SUNWuce/server/logs/error.log

    • On Linux: /usr/local/uce/server/logs/error.log

    • Log of errors in download jobs: /opt/SUNWuce/server/logs/SERVICE_CHANNEL/error.log

  • Job Log

    • On Oracle Solaris: /var/opt/SUNWuce/server/logs/job.log

    • On Linux: /usr/local/uce/server/logs/job.log

Component -Specific

  • Agents: /var/scn/update-agents/logs directory.

  • Libraries: /var/opt/sun/xvm/logs/virtimagelib.log

  • Asset Database

    • On the Enterprise Controller:

      • Log of interactions with the database of assets: /var/opt/sun/xvm/logs/db/mgmt/logs/db.log

      • Log of events in collecting data for reports: /var/opt/sun/xvm/logs/db/reports/logs/db.log

    • On the Proxy Controller: /var/opt/sun/xvm/proxydb/*

    • On each agent: /var/opt/sun/xvm/agentdb/*

Upgrade

The log of upgrade actions for the Enterprise Controller and its co-located proxy controller is in the file: /var/scn/update-saved-state/update_satellite_bundle_11.1.n.xxxx/updatelog.txt The log of upgrade actions for a proxy controller that is not co-located is in the file: /var/scn/update-saved-state/update_proxy_bundle_11.1.n.xxxx/updatelog.txt

Event Logs for Jobs

Event logs for jobs are generated by tasks as they progress. See Viewing Job Details for instructions on viewing job event logs.

To Control the Number of Common Agent Container Log Files

The Common Agent Container cacao is a common Java container for JDMX/JMX management and handles the interactions between controllers and agents. All events are recorded in the cacao log files and events that are above the level of INFO are also logged in the syslog. You can view the contents of the current log file using the Ops Center BUI.

  • On an Oracle Solaris Enterprise Controller: /var/cacao/instances/default/logs/cacao.n

  • On a Linux Enterprise Controller: /var/opt/sun/cacao/instances/default/logs/cacao.n

  • On each Oracle Solaris Proxy Controller: /var/cacao/instances/scn-proxy/logs/cacao.n

  • On each Linux Proxy Controller: /var/opt/sun/cacao/instances/scn-proxy/logs/cacao.n

The maximum file size is 1 MB. When the limit is reached, the current log file is closed and a new one created. The default number of log files is three. You can change the number of log files Ops Center retains, using the Common Agent Container's management utility, cacaoadm.

To view the current number of log files maintained for the Enterprise Controller, issue the following command on the system where the Enterprise software is running:

# cacaoadm get-param log-file-count -i default
log-file-count=3

To view the number of log files maintained for a Proxy Controller, issue the following command on the system were the proxy controller software is running:

# cacaoadm get-param log-file-count -i scn-proxy
log-file-count=3

To change the number of log files on the Enterprise Controller, a Proxy Controller, or both:

  1. Verify that there are no active jobs.

  2. Stop the Common Agent Container service on the Enterprise Controller.

    • On Oracle Solaris:

      # /opt/SUNWxvmoc/bin/satadm stop -w -v
      
    • On Linux:

      # /opt/sun/xvmoc/bin/satadm stop -w -v
      

      Stop the Common Agent Container service on a Proxy Controller:

    • On Oracle Solaris:

      # /opt/SUNWxvmoc/bin/proxyadm stop -w -v
      
    • On Linux:

      # /opt/sun/xvmoc/bin/proxyadm stop -w -v
      
  3. Specify the maximum number of log files to be retained in addition to the current log file. In the following example, the count of 10 specifies that nine log files of previous events are retained in addition to the log file for current events. On the Enterprise Controller:

    # cacaoadm set-param log-file-count=10 -i default
    

    On a Proxy Controller:

    # cacaoadm set-param log-file-count=10 -i scn-proxy
    
  4. Start the Enterprise Controller.

    • On Oracle Solaris:

      # /opt/SUNWxvmoc/bin/satadm start -w -v
      
    • On Linux:

      # /opt/sun/xvmoc/bin/satadm start -w -v
      
  5. Verify that the Enterprise Controller has been restarted completely before attempting other operations. For example, if you have stopped both the Enterprise Controller and a Proxy Controller, wait for the Enterprise Controller to restart before restarting each Proxy Controller. On an Oracle Solaris Proxy Controller:

    # /opt/SUNWxvmoc/bin/proxyadm start -w -v    
    

    On a Linux Proxy Controller:

    # /opt/sun/xvmoc/bin/proxyadm start -w -v    
    
  6. Verify that all controllers have restarted completely before attempting other operations.