Oracle® Enterprise Manager Ops Center

Readme

11g Release 1 Update 3 (11.1.3.0.0)

E21574-05

November 2011

Oracle Enterprise Manager Ops Center Readme (this document) includes the following:

This ReadMe file explains how to upgrade Oracle Enterprise Manager Ops Center. A major upgrade is increasing the major release, such as upgrading from version 2.5.0.1200 to version 11.1.0.0.0 (Build 11.1.0.1536). A minor upgrade is going to the latest version of the current release, such as upgrading from version 11.1.0.0.0 to version 11.1.3.0.0.

1 Prerequisites

See the Oracle Enterprise Manager Ops Center Site Preparation Guide for Enterprise Manager Ops Center prerequisites.

This document is available at http://download.oracle.com/docs/cd/E11857_01/nav/management.htm.

2 Major Upgrade Information

If you are using Enterprise Manager Ops Center version 2.5.0.1200, you can upgrade the Enterprise Controller and Proxy Controllers to version 11.1.0.0.0 using an installation and upgrade bundle. You can then upgrade the Enterprise Controller and Proxy Controllers to version 11.1.3.0.0 using the user interface. If you are using an earlier version than 2.5.0.1200, you must first upgrade to version 2.5.0.1200.

The upgrade stops the services on the Enterprise Controller or Proxy Controller, then backs up the current data. The Enterprise Manager Ops Center 11g Release 1 packages are installed, and the Enterprise Controller or Proxy Controller services are restored to their initial state.

If the upgrade fails, the newly installed material is removed, and the product is reinstalled using the version 2.5 installer. The Enterprise Controller or Proxy Controller is then restored using the backup file.

Note:

Some data is not preserved by the upgrade process. Notifications and historical asset data such as power and memory use are lost.

2.1 Before You Begin

Perform the following tasks before beginning the upgrade:

  1. Review the Oracle Enterprise Manager Ops Center Release Notes for pre-installation requirements and known issues.

  2. Verify that your system meets the system requirements outlined in the Site Preparation Guide, since some system requirements have changed. You can use the OC Doctor to check system requirements. The OC Doctor is available at https://updates.oracle.com/OCDoctor/OCDoctor-latest.zip.

  3. Review the online documentation. Some download sites might change, requiring configuration changes. See http://download.oracle.com/docs/cd/E11857_01/index.htm for documentation.

The /var/opt/sun/xvm/update-saved-state/<upgrade name and version>/updatelog.txt directory is used to back out the upgrade changes if the upgrade fails. If you have removed this directory, provide the location of the installation media during the upgrade.

Note:

Several existing features are affected by the upgrade. Review the Release Notes and the entirety of this document before upgrading.

Note:

If you made changes to the uce.rc file, your changes will be erased by the upgrade. Copy your changes to the .uce.rc file before beginning the upgrade.

Note:

If you replaced the self-signed web server certificate for the Enterprise Controller, the upgrade will erase your web server configuration changes, and might erase the certificate. Copy the certificate to a safe location before beginning the upgrade. After the upgrade, reapply your configuration changes and copy the certificate to its original location.

2.2 Performing the Upgrade

When upgrading your Enterprise Manager Ops Center environment, upgrade your systems in the following order:

  1. Upgrade the Enterprise Controller. This will also upgrade the co-located Proxy Controller.

  2. Upgrade the remote Proxy Controllers.

  3. Perform Post-Upgrade Tasks.

  4. Upgrade the Agent Controllers through the UI or manually.

If your data center is large, you can upgrade your Proxy Controllers one at a time. To do so, upgrade your systems in the following order:

  1. Upgrade the Enterprise Controller.

  2. Upgrade one remote Proxy Controller.

  3. Perform Post-Upgrade Tasks.

  4. Upgrade the Agent Controllers managed by the upgraded Proxy Controller.

  5. Upgrade the next remote Proxy Controller.

  6. Upgrade the Agent Controllers managed by the upgraded Proxy Controller.

  7. Repeat steps 5 and 6 for each remote Proxy Controller.

Upgrade log files are stored in the /var/opt/sun/xvm/update-saved-state/<upgrade name and version>/updatelog.txt directory on the Enterprise Controller.

2.3 Downloading Enterprise Controller and Proxy Controller Upgrade Bundles Through the User Interface

You can download the upgrade bundles through the UI. Each update must be downloaded before it can be applied.

Note:

You must download and apply the Enterprise Controller bundle before you can download the Proxy Controller bundle.
  1. Click Administration in the Navigation pane.

  2. Click Ops Center Downloads in the Actions pane. The Ops Center Downloads wizard is displayed.

  3. Select one or more upgrades from the list, then click Next. The View License page is displayed.

  4. Accept the license and click Next. The Update Download page is displayed.

  5. Confirm your selections and click Download. The Summary page is displayed.

  6. Click Finish. The selected Update Bundles are downloaded.

2.4 Downloading Enterprise Controller and Proxy Controller Upgrades From the Oracle Software Delivery Cloud

You can download upgrade bundles for the Enterprise Controller and Proxy Controller from the Oracle Software Delivery Cloud. This method is appropriate for a site in disconnected mode.

  1. Log in to the Oracle Software Delivery Cloud 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 Manager 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.

2.5 To Upgrade an Enterprise Controller and Co-located Proxy Controller

You can upgrade an Enterprise Controller from version 2.5.0.1200 to version 11.1.0.0.0. The co-located Proxy Controller is also upgraded.

The Enterprise Controller upgrade log is saved locally as /var/opt/sun/xvm/update-saved-state/<upgrade name and version>/updatelog.txt.

If an error occurs during this process, the system is restored to version 2.5.

Note:

The Enterprise Controller must be online at the beginning of the upgrade process. However, during the process the Enterprise Controller is shut down, which will cause running jobs to fail.
  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 -w command to start Enterprise Manager Ops Center services. The satadm command is located in the /opt/SUNWxvmoc/bin/ directory on Oracle Solaris systems and in the /opt/sun/xvmoc/bin/ directory on Linux systems.

  3. Create a temporary directory on your system, then copy or move the update bundle to the temporary directory that you created. The Enterprise Controller upgrade requires 5 GB of free space. The following example is for a Linux system:

    mkdir /var/tmp/OC/update
    cp enterprise-controller.Linux.i686.11.1.0.1536.tar.gz /var/tmp/OC/update 
    
  4. Change to the directory containing the update bundle.

    cd /var/tmp/OC/update 
    
  5. Uncompress and un-tar the update bundle using the gzcat and tar commands on an Oracle Solaris system or the gunzip and tar commands on a Linux system.

  6. Change to the xvmoc_full_bundle directory and run the install script.

    cd xvmoc_full_bundle
    ./install 
    

    The following option can be used with the install script:

    --install <version 2.5 install bundle path> or -i <version 2.5 install bundle path>

    If you removed the /var/opt/sun/xvm/update-saved-state/<upgrade name and version>/updatelog.txt directory, you must use this option to specify the location of the Enterprise Manager Ops Center 2.5 install bundle. If the directory is present, this option is unnecessary.

    When the upgrade is complete, the install script indicates that all Enterprise Manager Ops Center components are upgraded.

  7. Clear your browser cache. Cached data from the earlier version can cause the Enterprise Manager Ops Center user interface to display incorrectly. Refreshing or logging out and logging in will not clear this data.

2.6 To Upgrade a Remote Proxy Controller

Once you have upgraded your Enterprise Controller, you can upgrade remote Proxy Controllers. The co-located Proxy Controller, if enabled, is upgraded along with the Enterprise Controller.

The Proxy Controller upgrade log is saved locally as /var/opt/sun/xvm/update-saved-state/<upgrade name and version>/updatelog.txt.

If an error occurs during this process, the system will be restored to version 2.5.

Note:

The Proxy Controller must be online at the beginning of the upgrade process. However, during the process the Proxy Controller is shut down, which will cause any jobs running on the Proxy Controller to fail.
  1. Acquire the Proxy Controller upgrade bundle.

  2. As root, log in to the Proxy Controller.

  3. Back up the contents of the /etc/cacao/instances/scn-proxy/security/ directory.

  4. Use the proxyadm command to verify that the Proxy Controller is online. If necessary, use the proxyadm start -w command to start Enterprise Manager Ops Center services. The proxyadm command is located in the /opt/SUNWxvmoc/bin/ directory on Oracle Solaris systems and in the /opt/sun/xvmoc/bin/ directory on Linux systems.

  5. Create a temporary directory on your system, then copy or move the update bundle to the temporary directory that you created. The Proxy Controller upgrade requires 2 GB of free space.

    mkdir /var/tmp/OC/update
    cp proxy-controller.Linux.i686.11.1.0.1536.tar.gz /var/tmp/OC/update 
    
  6. Change to the directory containing the update bundle.

    cd /var/tmp/OC/update
    
  7. Uncompress and un-tar the update bundle using the gzcat and tar commands on an Oracle Solaris system or the gunzip and tar commands on a Linux system.

  8. Change to the xvmoc_full_bundle directory and run the install script.

    cd xvmoc_full_bundle
    ./install
    

    The following option can be used with the install script:

    --install <version 2.5 install bundle path> or -i <version 2.5 install bundle path>

    If you removed the /var/opt/sun/xvm/update-saved-state/<upgrade name and version>/updatelog.txt directory, you must use this option to specify the location of the Enterprise Manager Ops Center 2.5 install bundle. If the directory is present, this option is unnecessary.

    When the upgrade is complete, the install script indicates that all Enterprise Manager Ops Center components have been upgraded.

2.7 To Perform Post-Upgrade Tasks

To ensure full functionality, these procedures must be performed after upgrading the Enterprise Controller and Proxy Controller.

2.7.1 Edit OS Update Profiles

OS Update Profiles from Enterprise Manager Ops Center 2.5 are preserved by the upgrade. However, OS Update Profiles in Enterprise Manager Ops Center 11g Release 1 are configured to use a specific network. You must edit existing OS Update Profiles to assign a network. Consider editing the name of the profile to include the network, to avoid confusion. Once you have edited the profile, edit each OS Provisioning Plan that uses the profile so that it uses the new version. Consider editing the name of the plan to match the new profile name, to avoid confusion.

See the Oracle Enterprise Manager Ops Center Provision and Update Guide at http://download.oracle.com/docs/cd/E11857_01/nav/management.htm for more information.

2.7.2 Create Oracle VM Server for SPARC Guest Plans

In Enterprise Manager Ops Center 11g, you provision an Oracle VM Server for SPARC guest using a SPARC OS Profile and a Guest Plan, which are incorporated into a composite plan. The upgrade preserves OS profiles, but you must create a new Guest Plan and composite plan in order to provision.

See the Provision and Update Guide at http://download.oracle.com/docs/cd/E11857_01/nav/management.htm for more information.

2.7.3 Add My Oracle Support Credentials

You must add My Oracle Support Credentials to Enterprise Manager Ops Center's authentications to access data from My Oracle Support.

See the Administration Guide at http://download.oracle.com/docs/cd/E11857_01/nav/management.htm for more information.

2.7.4 Review the Release Notes

Review the Release Notes at http://download.oracle.com/docs/cd/E11857_01/nav/management.htm. Upgrade issues that might affect your systems are documented there.

2.8 To Upgrade Agents Using the User Interface

You can upgrade Agents using the UI. Before you upgrade Agents, upgrade the Proxy Controller that manages them.

  1. Log in to the UI.

  2. Click Administration in the Navigation pane.

  3. Click the Agent Controllers tab in the Center pane.

  4. Select the Agents, then click the Update to Latest Available Version icon. The Update Agents window is displayed.

  5. Select an upgrade option for the system or systems to be upgraded.

    • The Update without requiring SSH credentials option lets you upgrade version 2.5 Agent Controllers without using SSH credentials.

    • The Apply the Same SSH Credentials to All option prompts you for a single set of SSH credentials for all systems to be upgraded.

    • The Enter SSH credentials For Each of the Selected Hosts prompts you for a separate set of credentials for each system to be upgraded.

  6. Click Submit to launch the job. A popup appears confirming that the job has been launched.

  7. Click Ok. The Agent or Agents are upgraded.

2.9 To Upgrade Agents Manually

You can manually upgrade Agents. Before upgrading Agents, upgrade the Proxy Controller that manages them.

If you are manually upgrading Agents running in non-global zones, complete these upgrade steps for any Agent running in the global zone before upgrading all of the non-global zones. The global zone and the non-global zones must all use the same Agent Controller version.

This procedure requires root access.

  1. Copy the new agent bundle from the Enterprise Controller to the client, remove the version 2.5 Agent directory, and extract the new agent bundle. For example, on Oracle Solaris Agents:

    scp <IP of Enterprise Controller>:/var/opt/sun/xvm/images/agent/SunConnectionAgent.`uname -s`.`uname -p`.11.1.0.1536.zip /var/tmp
    cd /var/tmp
    rm -r SunConnectionAgent
    unzip SunConnectionAgent.`uname -s`.`uname -p`.11.1.0.1536.zip
    

    On Linux Agents:

    scp -p <IP of Enterprise Controller>:/var/opt/sun/xvm/images/agent/SunConnectionAgent.`uname -s`.i686.11.1.0.1536.zip /var/tmp
    cd /var/tmp
    rm -r SunConnectionAgent
    unzip SunConnectionAgent.`uname -s`.i686.11.1.0.1536.zip 
    
  2. Stop the version 2.5 Agent. For example, on Oracle Solaris Agent Controllers:

    /opt/SUNWxvmoc/bin/agentadm stop
    

    On Linux Agent Controllers:

    /opt/sun/xvmoc/bin/agentadm stop 
    
  3. Install the agent upgrade.

    cd /var/tmp/SunConnectionAgent
    ./install 
    
  4. Configure the new Enterprise Manager Ops Center Agent. On Oracle Solaris Agents:

    /opt/SUNWxvmoc/bin/agentadm configure --keep-connection
    

    On Linux Agents:

    /opt/sun/xvmoc/bin/agentadm configure --keep-connection
    

    This step also starts the Agent.

    Note:

    The following errors can be ignored. These refer to the addition of two sysidcfg scripts, which are already present from a prior agentadm configure step, such as from the original version 2.5 agent installation and configuration. The correct sysidcfg scripts will be called properly by sysidcfg.

    Failed to add the zone configuration automation.

    Failed to add the service tags recreate script.

  5. Verify the connection.

    sc-console list-connections scn-agent https://172.25.14.21:21165 urn:scn:clregid:1234567-aaaa-bbbb-cccc-123456789abc:YYYYMMDDHHMMSSss
    

3 Minor Upgrade Information

If you are using Enterprise Manager Ops Center version 11.1.0.0.0, 11.1.1.0.0, or 11.1.2.0.0, you can upgrade the Enterprise Controller and Proxy Controllers to version 11.1.3.0.0 using an upgrade bundle. If you are using version 2.5.0.1200, you must upgrade to version 11.1.0.0.0 before upgrading to version 11.1.3.0.0.

3.1 Before You Begin

Perform the following tasks before beginning the upgrade:

  1. Review pending and scheduled jobs. The Enterprise Controller and Proxy Controllers are shut down during the upgrade, which will cause running jobs to fail.

  2. Back up your Enterprise Manager Ops Center data.

3.2 Downloading Enterprise Controller and Proxy Controller Update Bundles

You can download the update bundles through the UI.

Note:

You must download and apply the Enterprise Controller bundle before you can download the Proxy Controller bundle.
  1. Click Administration in the Navigation pane.

  2. Click Ops Center Downloads in the Actions pane. The Ops Center Downloads wizard is displayed.

  3. Select one or more updates from the list, then click Next. The View License page is displayed.

  4. Accept the license and click Next. The Update Download page is displayed.

  5. Confirm your selections and click Download. The Summary page is displayed.

  6. Click Finish. The selected Update Bundles are downloaded.

3.3 Downloading Enterprise Controller and Proxy Controller Updates From the Oracle Software Delivery Cloud

You can download update bundles for the Enterprise Controller and Proxy Controller from the Oracle Software Delivery Cloud. This method is appropriate for a site in disconnected mode.

  1. Log in to the Oracle Software Delivery Cloud 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 Manager 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.

3.4 Performing the Upgrade

When upgrading your Enterprise Manager Ops Center environment, upgrade your systems in the following order:

  1. Upgrade the Enterprise Controller. This also upgrades the co-located Proxy Controller.

  2. Upgrade the separate Proxy Controllers.

  3. Upgrade the Agent Controllers through the UI or manually.

If your data center is large, you can upgrade your Proxy Controllers one at a time. To do so, upgrade your systems in the following order:

  1. Upgrade the Enterprise Controller.

  2. Upgrade one Proxy Controller.

  3. Upgrade the Agent Controllers managed by the upgraded Proxy Controller.

  4. Upgrade the next Proxy Controller.

  5. Upgrade the Agent Controllers managed by the upgraded Proxy Controller.

  6. Repeat steps 4 and 5 for each Proxy Controller.

3.5 To Upgrade the Enterprise Controller

You can upgrade an Enterprise Controller to Enterprise Manager Ops Center 11g version 11.1.3.0.0. The co-located Proxy Controller will be upgraded as well.

Note:

During the upgrade process, the Enterprise Controller will be shut down. This might cause any jobs that are currently running on the Enterprise Controller to be canceled and marked as failed.
  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 Enterprise Manager Ops Center installation file cannot be found, the Install Path Verification page is displayed. If the upgrade fails, the installation file is used for rollback.

  5. If the Install Path Verification page is displayed, enter the path to the Enterprise Manager Ops Center installer and click Next. The Job Details page is displayed. When the upgrade 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 upgrade is launched. The upgrade 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 upgrade is complete.

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

3.6 To Upgrade the Enterprise Controller in Disconnected Mode

You can upgrade an Enterprise Controller to Enterprise Manager Ops Center 11g version 11.1.3.0.0. The co-located Proxy Controller will be upgraded as well.

In Disconnected Mode, you must acquire the upgrade bundle, transfer it to the Enterprise Controller system, and apply it manually.

  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 upgrade bundle to the temporary directory that you created.

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

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

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

    gzcat enterprise-controller.SunOS.sparc.11.1.3.0.tar.gz | tar xf -
    

    On Linux systems, use the gunzip and tar commands to unzip and un-tar the upgrade bundle. Note that the following command example retains the original compressed archive file.

    gunzip enterprise-controller.Linux.i686.11.1.3.0.tar.gz
    tar xf enterprise-controller.Linux.i686.11.1.3.0.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:

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

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

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

3.7 To Upgrade a Proxy Controller

Once you have upgraded your Enterprise Controller, you can upgrade any Proxy Controllers. The co-located Proxy Controller, if enabled, is upgraded along with the Enterprise Controller, but separate Proxy Controllers must be upgraded separately.

Proxy Controller files are stored in the /var/opt/sun/xvm/images/productUpdate directory on the Enterprise Controller. If you are using Connected Mode, use the Ops Center Downloads action to download Proxy Controller files. If you are using Disconnected Mode, Proxy Controller files must be downloaded outside of Ops Center and moved to the Proxy Controller system.

To upgrade a Proxy Controller through the UI, the Enterprise Controller must be able to reach the Proxy Controller with an SSH connection using port 22 during the upgrade process. This connection is used to transfer Proxy Controller bundles and execute commands on the Proxy Controller system. If your security restrictions do not allow this connection, upgrade the Proxy Controller from the command line.

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

  2. Click the Proxy Controllers tab. Proxy Controller information is displayed.

  3. Select one or more Proxy Controllers.

  4. Click the Update to Latest Available Version icon in the center pane. The Update Proxy(s) wizard is displayed.

  5. Select a method for providing SSH credentials for the Proxy Controller or Proxy Controllers.

    • Re-use the SSH credentials used during discovery

    • Apply the same SSH credentials to all

    • Enter SSH credentials for each

  6. Click Finish. A job is launched to upgrade the Proxy Controller.

3.8 To Upgrade a Proxy Controller from the Command Line

Once you have upgraded your Enterprise Controller, you can upgrade any Proxy Controllers. The co-located Proxy Controller, if enabled, is upgraded along with the Enterprise Controller, but separate Proxy Controllers must be upgraded separately.

Proxy Controller files are stored in the /var/opt/sun/xvm/images/productUpdate directory on the Enterprise Controller. If you are using Connected Mode, use the Ops Center Downloads action to download Proxy Controller files, then move them to the Proxy Controller system. If you are using Disconnected Mode, Proxy Controller files must be downloaded outside of Ops Center and moved to the Proxy Controller system.

To Upgrade a Proxy Controller

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

  2. Change to the directory containing the proxyadm command.

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

    • On Linux systems, this directory is /opt/sun/xvmoc/bin/.

  3. Run the proxyadm status command to verify that the Proxy Controller is online. If the Proxy Controller is offline, start it using the proxyadm start command.

    # ./proxyadm status
    online
    
  4. Change to the directory containing the upgrade bundle.

  5. Uncompress and un-tar the installation archive, then list the contents of the temporary directory.

    • For example, on a Linux Proxy Controller:

      # unzip proxy-controller.Linux.i686.11.1.3.0.tar.zip
      # tar xf proxy-controller.Linux.i686.11.1.3.0.tar
      # ls
      xvmoc_full_bundle
      proxy-controller.Linux.i686.11.1.3.0.tar
      #
      
    • On an Oracle Solaris Proxy Controller:

      # unzip proxy-controller.SunOS.i386.11.1.3.0.tar.zip | tar xf -
      # ls
      xvmoc_full_bundle
      proxy-controller.SunOS.i386.11.1.3.0.tar.zip
      
  6. Change to the xvmoc_full_bundle directory.

  7. Run the install script.

    # ./install
    

    The upgrade is installed on the Proxy Controller.

3.9 To Upgrade Agent Controllers Using the User Interface

You can upgrade Agent Controllers using the UI. Before you upgrade Agent Controllers, upgrade the Proxy Controller that manages them.

  1. Click Administration in the Navigation pane.

  2. Click the Agent Controllers tab in the Center pane.

  3. Select the Agent Controllers, then click the Update to Latest Available Version icon. The Update Agents window is displayed.

  4. Select an upgrade option for the system or systems to be upgraded.

    • The Update without requiring SSH credentials option lets you upgrade version 2.5 Agent Controllers without using SSH credentials.

    • The Apply the Same SSH Credentials to All option prompts you for a single set of SSH credentials for all systems to be upgraded.

    • The Enter SSH credentials For Each of the Selected Hosts prompts you for a separate set of credentials for each system to be upgraded.

  5. Click Submit to launch the job. A popup appears confirming that the job has been launched.

  6. Click Ok. The Agent Controllers are upgraded.

3.10 To Upgrade Agent Controllers from the Command Line

You can upgrade Agent Controllers from the command line. Before you update an Agent Controller, you must update the Proxy Controller that manages it.

Agent Controller files are stored in the /var/opt/sun/xvm/images/agent directory on the Enterprise Controller.

  1. Log in to the Agent Controller system.

  2. Create a directory for the Agent Controller update bundle.

    # mkdir /var/tmp/agent_bundle_update
    
  3. Copy the Agent Controller bundle to the new directory.

    # cd agent_bundle_update
    # pwd
    /var/tmp/agent_bundle_update
    # scp root@EC:/var/opt/sun/xvm/images/agent/SunConnectionAgent.SunOS.i386.11.1.3.0.zip
    
  4. Unzip the Agent Controller bundle.

    # unzip SunConnectionAgent.SunOS.i386.11.1.3.0.zip
    
  5. Run the agentadm stop command to stop the Agent Controller.

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

    • On Linux systems, this directory is /opt/sun/xvmoc/bin/.

    # ./agentadm stop
    
  6. Change to the SunConnectionAgent directory and run the install script.

    # cd SunConnectionAgent
    # ./install
    

4 Installation

See the Installation and Configuration Guide for Oracle Solaris or Installation and Configuration Guide for Linux for installation and post-install configuration instructions.

These documents can be downloaded from the Enterprise Manager Ops Center Documentation Library at:

http://download.oracle.com/docs/cd/E11857_01/nav/management.htm

5 Uninstallation

You can uninstall the components of Enterprise Manager Ops Center. See the Uninstalling and Unconfiguring Enterprise Manager Ops Center Software section of the Administration Guide for uninstallation procedures.

This document can be downloaded from the Enterprise Manager Ops Center Documentation Library at:

http://download.oracle.com/docs/cd/E11857_01/nav/management.htm

6 Known Issues

The following are known issues in Oracle Enterprise Manager Ops Center.

6.1 Job Manager Properties are Overwritten by Upgrade

If you have modified any job manager properties in the jobmanager.properties file, they will be overwritten by the upgrade. The following error will appear in the log file:

18 updatePropFile /var/opt/sun/xvm/jobmanager.properties /tmp/jobmanager.properties.orig: failed to edit orig-propfile /var/opt/sun/xvm/jobmanager.properties, not changed

6.2 Upgrade Script Might Not Preserve Tables

Some report data might not be preserved by the upgrade process. The upgrade might drop tables.

6.3 Discovery Jobs From Enterprise Manager Ops Center 2.5 Cannot Be Re-run

After the upgrade, discovery jobs originally launched in Enterprise Manager Ops Center 2.5 cannot be re-run due to changes in the discovery process. Create new discovery jobs to discover assets.

6.4 Roles for OS and Firmware Provisioning are Erased by the Upgrade

The Enterprise Manager Ops Center upgrade removes the old roles tied to the version 2.5 profiles. Role assignments made for these 2.5 profiles to non-admin users are abandoned and the Enterprise Controller Admin must re-grant the newly created roles for the new profiles to those non-admins who had them.

6.5 After Upgrade, OS ISO is Redownloaded by Proxy Controller and New /var/js/# is Created

After the upgrade, when a new OS Provisioning job is launched, a new version of the OS ISO is downloaded to the Proxy Controller, even though a version exists from before the upgrade. The old version is not deleted.

6.6 Enterprise Controller Installation on RHEL/OEL 5.6 gives "Error: Cannot determine Linux version"

Installing Ops Center Echelon RR gives the following errors but the installation can continue:

Error: Cannot determine Linux version.

Error: Check that /etc/redhat-release or /etc/SuSE-release is present and that this OS and version is supported.

The workaround is to continue past the error.

6.7 RHEL/OEL 5.6 Proxy Controller Deployment From UI Fails Due To Unsupported Linux Error

Deploying RHEL/OEL 5.6 PC from UI hangs, times out and fails due to the unsupported Linux version warning or error.

The workaround is to install and configure the RHEL/OEL 5.6 Proxy Controller from the command line.

7 References

The following documents are related to installing, or upgrading to, Enterprise Manager Ops Center 11g Release 1 Update 3.

See the Oracle Enterprise Manager Ops Center Documentation Library at:

http://download.oracle.com/docs/cd/E11857_01/nav/management.htm

  • Oracle Enterprise Manager Ops Center Release Notes, 11g Release 1 Update 3 (11.1.3.0.0)

The Release Notes document provides instructions on installing, upgrading or de-installing of the software. It also includes a list of known issues related to installation and upgrade, as well as post-installation configuration.

  • Oracle Enterprise Manager Ops Center Installation and Configuration Guide for Oracle Solaris, 11g Release 1 Update 3 (11.1.3.0.0)

The document provides detailed instructions on performing a fresh installation of Oracle Enterprise Manager Ops Center on Oracle Solaris systems.

  • Oracle Enterprise Manager Ops Center Installation and Configuration Guide for Linux, 11g Release 1 Update 3 (11.1.3.0.0)

The document provides detailed instructions on performing a fresh installation of Oracle Enterprise Manager Ops Center on Oracle Linux or Red Hat Enterprise Linux systems.

  • Oracle Enterprise Manager Ops Center Administration Guide, 11g Release 1 Update 3 (11.1.3.0.0)

The document provides instructions on updating and administering Oracle Enterprise Manager Ops Center.

8 Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.


Oracle® Enterprise Manager Ops Center ReadMe, 11g Release 1 Update 3 (11.1.3.0.0)

E21574-05

Copyright © 2007, 2011, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.