Skip Headers
Oracle® Enterprise Manager Ops Center Administration Guide
11g Release 1 Update 3 (11.1.3.0.0)

Part Number E18414-04
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

1 Enterprise Controller Administration

The Enterprise Controller is the core of Enterprise Manager Ops Center. It generates the browser user interface, routes commands from the user to the proper Proxy Controller, and communicates with Oracle and other external data sources.

About Enterprise Controller Administration

The Enterprise Controller is the center of the Oracle Enterprise Manager Ops Center infrastructure. It generates the user interface, stores asset and job data, and directs jobs to the Proxy Controllers.

The Administration options for the Enterprise Controller let you manage it directly.

Viewing Enterprise Controller Data

You can view data about the Enterprise Controller through the user interface to troubleshoot problems and ensure good performance. You can view the status of the services used by Oracle Enterprise Manager Ops Center and view log files.

Changing Enterprise Controller Settings

You can change several Enterprise Controller settings that affect the way the software operates.

If there is an HTTP Proxy between your Enterprise Controller and the Internet, you can configure Ops Center to use the HTTP Proxy.

Oracle Enterprise Manager Ops Center requires certain authentications to download content from websites. These authentications include Online Accounts and My Oracle Support accounts. You can create and edit these authentications.

In some cases, products are not correctly recognized by Oracle Enterprise Manager Ops Center. This might prevent management and monitoring actions from being taken on the system. You can correct these issues by adding an alias for a product, which matches the asset to the correct product type.

Changing the Connection Mode

Oracle Enterprise Manager Ops Center can operate in one of two connection modes. In Connected Mode, the software downloads updates and other data from the Internet, and you can directly register your assets with Oracle. In Disconnected Mode, the software operates without an Internet connection; updates and patches are downloaded using a harvester script on a separate system, and manually transferred to the Enterprise Controller system.

You can switch between these modes at any time.

Configuring the Local Agent

An agent is the component of the infrastructure that is installed on operating systems, enabling management and monitoring. A local agent is an agent installed on the Enterprise Controller OS. This enables you to monitor the system that supports the Enterprise Controller and launch some jobs that target the system. Jobs that would restart the Enterprise Controller cannot be launched.

Viewing and Changing the Enterprise Controller Status

Knowing the current status of the Enterprise Controller is necessary for some processes. The product will only function while the Enterprise Controller is online. You can check the status of the Enterprise Controller, and stop or start it, from the command line.

Updating the Enterprise Controller

Updates for the software are released periodically. You can apply these updates to your Enterprise Controller to make use of new and updated features.

When an update is released, you must download it and apply it to the Enterprise Controller before applying it to the Proxy Controllers and Agents.

Viewing Service Status

Oracle Enterprise Manager Ops Center uses the services listed below. The status of these services is monitored and displayed in the UI. The Fault Management Resource Identifier (FMRI) for each service can be used with SMF commands.

These services should not be disabled outside of the software. Use the satadm, proxyadm, and agentadm to manage the services.

To View Service Status

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click the Configuration tab. The Service Status is displayed.

Viewing Logs

You can view logs to diagnose problems or examine Oracle Enterprise Manager Ops Center activities.

To View Logs

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click the Logs tab.

  3. Select a log from the dropdown list.

    • Cacao log

    • UI log

    • DB transaction log

    • DB report log

    • Proxy log

    • Update error log

    • Update channel download log

    • Update channel error log The log is displayed.

  4. (Optional) Click Refresh Log File to refresh the displayed version of the log file.

Changing the HTTP Proxy

If your Enterprise Controller accesses the Internet through an HTTP proxy, you can edit the HTTP proxy information.

To Change the HTTP Proxy

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Change HTTP Proxy in the Actions pane. The Change HTTP Proxy wizard is displayed.

  3. Enter the HTTP proxy information, including:

    • HTTP Proxy server

    • Port number.

    • User Name – Required if the HTTP Proxy requires authentication

    • Password – Required if the HTTP Proxy requires authentication

  4. Click Update. The HTTP proxy information is updated.

Adding a Product Alias

In some cases, an asset's type will not be recognized properly. In these cases, you can add a product alias to ensure that an asset is properly recognized by Oracle Enterprise Manager Ops Center and that all of its features are available.

Note:

This feature should be used as directed by Oracle Support.

To Add a Product Alias

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Add Product Alias in the Actions pane. The Add Product Alias page is displayed.

  3. Enter the Product Alias information.

    • Product Alias – This is the existing asset name.

    • Product ID – This is the full product ID number. If a Product Label is supplied, the Product ID is optional.

    • Product Label – This is the original factory label for the asset. If a Product ID is supplied, the product Label is optional.

  4. Click Add Product Alias to add the product alias to the Enterprise Controller.

Editing Authentications

Authentications, such as Online Account or My Oracle Support (MOS) credentials, are necessary to download content such as updates from Oracle or third-party sites.

You can add or edit authentications to access additional external resources.

To Edit Authentications

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Edit Authentications in the Actions pane. The Edit Authentications window is displayed.

  3. Edit one or more of the authentications.

    • To edit an online account, click the description, user name, or password field and enter the new information.

    • To add a MOS user, click the Add MOS User icon.

    • To edit a MOS user, click the description, user name, or password field and enter the new information.

    • To remove a MOS user, select the user click the Remove MOS User icon.

    • To set a MOS user as default, select the user and click the Set as Default MOS User icon.

  4. Click Submit. A job is launched to update the authentications.

Editing the Energy Cost

One of the Oracle Enterprise Manager Ops Center capabilities is monitoring power utilization for a server or among groups of servers or virtual hosts.

You can also monitor the cost of power utilization by supplying the cost per currency unit. This information is displayed in the Summary or Energy tab.

To Set the Cost of Energy

  1. Expand Administration in the Navigation pane.

  2. Click Edit Energy Cost in the Actions pane. The Energy Cost Settings window is displayed.

  3. Enter your location's cost for each kilowatt-hour.

  4. Enter your business's currency unit.

  5. Click Submit.

Changing the Connection Mode

Oracle Enterprise Manager Ops Center can operate in either Connected or Disconnected Mode. In Connected Mode, the software communicates with Oracle and other vendors, gathering patch and update information. In Disconnected Mode, the software operates autonomously and does not need an Internet connection.

You can switch between connection modes at any time.

To Switch to Disconnected Mode

To use Disconnected Mode, you must download a Knowledge Base bundle.

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Setup Connection Mode in the Actions pane.

  3. Enter the absolute path of the Knowledge Base bundle that you want to use, then click Load Bundle. You can use the Browse button to locate the Knowledge Base bundle.

  4. Click Switch to Disconnected Mode.

To Switch to Connected Mode

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Setup Connection Mode in the Actions pane.

  3. Click Switch to Connected Mode.

Configuring the Local Agent

The Local Agent is the Agent software installed on the Enterprise Controller system. Configuring the Local Agent enables you to monitor the system that supports the Enterprise Controller and launch jobs that target it.

Jobs that target the Enterprise Controller's hardware or OS that would cause the Enterprise Controller system to restart, such as an OS update that requires a reboot, cannot be performed through the product.

To Configure the Local Agent

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Configure Local Agent in the Actions pane. A confirmation page is displayed.

  3. Click Ok. A job is launched to configure the local Agent.

Unconfiguring the Local Agent

The Local Agent is the Agent software installed on the Enterprise Controller system. You can unconfigure the Local Agent to halt monitoring of the Enterprise Controller system.

To Unconfigure the Local Agent

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Unconfigure Local Agent in the Actions pane. A confirmation page is displayed.

  3. Click Ok. A job is launched to unconfigure the local Agent.

Configuring Oracle Configuration Manager

Oracle Configuration Manager is a tool used to personalize and enhance the support experience by collecting configuration information and uploading it to the Oracle repository. When the configuration data is uploaded on a regular basis, customer support representatives can analyze this data and provide better service.

Oracle Configuration Manager is installed with Oracle Enterprise Manager Ops Center. If you did not configure Oracle Configuration Manager during installation, you can do so using the command line.

Before You Begin

This procedure requires that Java 6 be configured on the Enterprise Controller.

To Configure Oracle Configuration Manager

  1. As root, log in to the Enterprise Controller system.

  2. Run the setupCCR command.

    # /var/opt/sun/xvm/ocm/ccr/bin/setupCCR
    
  3. The Oracle Configuration Manager installation text is displayed. Enter the My Oracle Support user name or email address that you want to associate with Oracle Enterprise Manager Ops Center.

    Provide your email address to be informed of security issues, install and
    initiate Oracle Configuration Manager. Easier for you if you use your My
    Oracle Support Email address/User Name.
    Visit http://www.oracle.com/support/policies.html for details.
    Email address/User Name:
    
  4. If you want security updates to appear on your My Oracle Support page, enter your My Oracle Support password and press Enter. Otherwise, press Enter.

    Provide your My Oracle Support password to receive security updates via your My Oracle Support account.
    Password (optional):
    

    Oracle Configuration Manager is configured.

Checking the Status of the Enterprise Controller

The Enterprise Controller can be in one of two states. In the online state, the Enterprise Controller is running normally. In the offline state, the Enterprise Controller is stopped, and cannot be used.

You can check the status of the Enterprise Controller using the satadm command.

To Check the Status of the Enterprise Controller

  1. As root, log in to the Enterprise Controller system.

  2. Run the satadm status command.

    • On Oracle Solaris systems, this command is in the /opt/SUNWxvmoc/bin/ directory.

    • On Linux systems, this command is in the /opt/sun/xvmoc/bin/ directory. The following options can be used:

    • -h | --help – Displays the usage synopsis for the subcommand. For example:

      # ./satadm status
      online
      

      The status of the Enterprise Controller is displayed.

Starting the Enterprise Controller

The Enterprise Controller can be in a stopped state due to a system reboot or maintenance. While the Enterprise Controller is stopped, Oracle Enterprise Manager Ops Center does not function.

You can start the Enterprise Controller using the satadm command.

To Start the Enterprise Controller

  1. As root, log in to the Enterprise Controller system.

  2. Run the satadm start command.

    • On Oracle Solaris systems, this command is in the /opt/SUNWxvmoc/bin/ directory.

    • On Linux systems, this command is in the /opt/sun/xvmoc/bin/ directory. The following options can be used:

    • -h | --help – Displays the usage synopsis for the subcommand.

    • -w | --wait – satadm does not exit until all services have been started.

    • -t | --temporary – The state change is made temporary until next reboot.

    • -v | --verbose – Displays verbose error and informational messages.

    • -l | --logfile <logfile> – Captures any output from satadm in the <logfile>. For example:

      # ./satadm start -vw
      satadm: Starting Enterprise Controller with SMF...
      satadm: ... milestone "satellite-enable" succesfully enabled
      satadm: ... Waiting for Enterprise Controller services to go "online"
      satadm: Enterprise Controller services have started
      #
      

      The Enterprise Controller is started.

Stopping the Enterprise Controller

When the Enterprise Controller is online, Oracle Enterprise Manager Ops Center functions normally. However, certain maintenance tasks can only be performed when the Enterprise Controller is offline.

You can stop the Enterprise Controller using the satadm command.

To Stop the Enterprise Controller

  1. As root, log in to the Enterprise Controller system.

  2. Run the satadm stop command.

    • On Oracle Solaris systems, this command is in the /opt/SUNWxvmoc/bin/ directory.

    • On Linux systems, this command is in the /opt/sun/xvmoc/bin/ directory. The following options can be used:

    • -h | --help – Displays the usage synopsis for the subcommand.

    • -w | --wait – satadm does not exit until all services have been started.

    • -t | --temporary – The state change is made temporary until next reboot.

    • -v | --verbose – Displays verbose error and informational messages.

    • -l | --logfile <logfile> – Captures any output from satadm in the <logfile>. For example:

      # ./satadm stop -vw
      satadm: Shutting down Enterprise Controller using SMF...
      satadm: ... milestone "satellite-enable" successfully disabled
      satadm: ... waiting for services to go "offline"
      satadm: Enterprise Controller services have stopped
      #
      

      The Enterprise Controller is stopped.

Ops Center Downloads

You can download updates for Oracle Enterprise Manager Ops Center. This includes updates for the Enterprise Controller, Proxy Controllers, and Agents. Downloading an update does not install it on managed assets.

Updates are downloaded to these directories:

To View and Download Updates

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Oracle Ops Center Downloads. The Oracle Ops Center Downloads wizard is displayed.

  3. (Optional) Hover over the details icon for a download to view more information about it.

  4. Select one or more downloads and click Next. The View License page is displayed.

  5. Read the license and click Accept. The Download Status page is displayed.

  6. Check I wish to download the remaining updates in the background, or wait for the downloads to complete.

  7. Click Next. The Summary page is displayed.

  8. Click Finish. The updates are now available.

To Make Downloads Available in Disconnected Mode

  1. Download the updates using the harvester script.

  2. Copy the update bundle onto the Enterprise Controller.

    • Proxy Controller updates go in the /var/opt/sun/xvm/images/productUpdate directory.

    • Agent updates go in the /var/opt/sun/xvm/images/agent directory. The updates are now available.

Downloading Updates From e-Delivery

You can download update bundles for the Enterprise Controller and Proxy Controller from e-Delivery.

  1. Log in to the Oracle e-Delivery website at http://edelivery.oracle.com.

  2. Select the Oracle Enterprise Manager product pack.

  3. Select the correct platform for your environment.

  4. Click Go. The list of download packs is displayed.

  5. Select the Oracle Enterprise Manger Ops Center 11g Release 1 Media Pack and click Continue. The list of available bundles is displayed.

  6. Click the download button next to the appropriate bundle to download it, then save the downloaded bundle locally.

  7. Move the downloaded file to the Enterprise Controller system.

  8. Unzip the bundle.

  9. Download the required Proxy Controller update bundle, unzip it and move the proxy-controller-patch*.gz file to the /var/opt/sun/xvm/images/productUpdate directory.

Updating the Enterprise Controller

The following procedure describes how to update the Enterprise Controller. You can view and install updates from the user interface. Updates might be available for the Enterprise Controller, Proxy Controller, or Agents. When new updates are available, a medium priority notification is sent announcing the update, and the update is indicated by an icon in the UI.

Before You Begin

Perform the following tasks before you update the Enterprise Controller:

To Update the Enterprise Controller

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Upgrade Enterprise Controller. The Upgrade Enterprise Controller wizard is displayed. All available Enterprise Controller updates are displayed.

  3. (Optional) Mouse over the details icon for an update to view more information about it.

  4. Select an update and click Next. If the current Oracle Enterprise Manager Ops Center installation file cannot be found, the Install Path Verification page is displayed. If the update fails, the installation file is used for rollback.

  5. If the Install Path Verification page is displayed, enter the path to the Oracle Enterprise Manager Ops Center installer and click Next. The Job Details page is displayed. When the update shuts down the Enterprise Controller, any jobs that are running will fail.

  6. View the job details, then click Next. The Summary page is displayed.

  7. Click Finish. The update is launched. The update can take up to an hour, during which time the Enterprise Controller is not accessible. Reload the browser regularly, and the login page will display normally when the update is complete.

  8. Clear the browser cache and refresh the browser before you log in to the newly updated Enterprise Controller.

Updating the Enterprise Controller in Disconnected Mode

The following procedure describes how to update the Enterprise Controller. You can manually update an Enterprise Controller to the latest version. If you are running Oracle Enterprise Manager Ops Center in Disconnected Mode, you must update manually. The co-located Proxy Controller is updated as well, even if it is not enabled. If you have one or more remote Proxy Controllers, you must update them after the Enterprise Controller update has completed.

The Enterprise Controller update log will be saved locally as /var/scn/update-saved-state/update_satellite_bundle_2.5.0.<version number>/updatelog.txt.

Note:

During the update process, the Enterprise Controller will be shut down. This causes any jobs that are currently running on the Enterprise Controller to be canceled and marked as failed. However, the Enterprise Controller must be online at the beginning of the process.

Before You Begin

Perform the following tasks before you update the Enterprise Controller:

To Upgrade the Enterprise Controller in Disconnected Mode

  1. As root, log in to the Enterprise Controller.

  2. Use the satadm command to verify that the Enterprise Controller is online. If necessary, use the satadm start command to start the Enterprise Controller.

    # /opt/SUNWxvmoc/bin/satadm status
    online
    
  3. Create a temporary directory on your system, then copy or move the update bundle to the temporary directory that you created.

    # mkdir /var/tmp/OC/update
    # cp enterprise-controller.SunOS.sparc.2.5.0.1171.tar.gz /var/tmp/OC/update
    
  4. Change to the directory containing the update bundle.

    # cd /var/tmp/OC/update
    
  5. Unzip and un-tar the bundle.

    • On Solaris OS systems, use the gzcat and tar commands to unzip and un-tar the update bundle.

      # gzcat enterprise-controller.SunOS.sparc.2.5.0.1171.tar.gz | tar xf -
      
    • On Linux systems, use the gunzip and tar commands to unzip and un-tar the update bundle. Note that the following command example retains the original compressed archive file.

      # gunzip enterprise-controller.Linux.i686.2.5.0.1171.tar.gz
      # tar xf enterprise-controller.Linux.i686.2.5.0.1171.tar
      
  6. Change to the xvmoc_full_bundle directory and run the install script.

    # cd xvmoc_full_bundle
    # ./install
    

    The following options can be used with the install script:

    • --acceptedlicenseor-a – Accepts the license terms and conditions. Without this option, the terms and conditions are displayed, and you are prompted to accept them.

    • --verboseor-v – Increases verbosity of output from update program. Without this option, non-verbose output is given. You must accept the license terms and conditions to complete the update. When the update is complete, the install script indicates that all Oracle Enterprise Manager Ops Center components have been updated to the latest version.

  7. Clear your browser cache and refresh your browser before you log in to the newly updated Enterprise Controller.