4 Upgrading a Single EC Environment Using the User Interface

This chapter explains how to upgrade an environment with a single Enterprise Controller through the User Interface.

Upgrade your systems in the following order:

  1. Download the upgrade bundle for your environment.

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

  3. Upgrade the separate Proxy Controllers.

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

Description of graphic_singleec_nostage.png follows
Description of the illustration graphic_singleec_nostage.png

Some of the procedures described in this guide use the ecadm, proxyadm, and agentadm commands. See the Oracle Enterprise Manager Ops Center Administration Guide for more information about these commands.

  • On Oracle Solaris systems, these commands are in the /opt/SUNWxvmoc/bin/ directory.

  • On Linux systems, these commands are in the /opt/sun/xvmoc/bin/ directory.

Note:

The upgrade process creates a backup file for the Enterprise Controller. If the upgrade fails, the Enterprise Controller is uninstalled, the initial version of the Enterprise Controller is reinstalled, and the system is automatically restored from the backup file.

Once you have begun the upgrade, complete it as soon as possible. Do not allow the Enterprise Controller or Proxy Controllers to be restarted before all systems have been upgraded.

4.1 Downloading Upgrades

You can download the upgrade bundle for Oracle Enterprise Manager Ops Center. This includes upgrades for the Enterprise Controller, Proxy Controllers, and Agent Controllers. Downloading an upgrade does not install it on managed assets.

You can download the upgrade bundles through the user interface, from the Oracle Technology Network, or from the Oracle Software Delivery Cloud.

4.1.1 Downloading Upgrades From the User Interface

You can download upgrades for Oracle Enterprise Manager Ops Center through the user interface.

Upgrades are downloaded to these directories:

  • Enterprise Controller upgrades: /var/opt/sun/xvm/images/productUpdate

  • Proxy Controller upgrades: /var/opt/sun/xvm/images/productUpdate

  • Agent Controller upgrades: /var/opt/sun/xvm/images/agent

Note:

The Enterprise Controller upgrade includes the Proxy Controller and Agent Controller upgrades, but the Proxy Controller and Agent Controller upgrades are not saved to these directories until the Enterprise Controller upgrade is applied.

To View and Download Upgrades

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

  2. Click Ops Center Downloads.

    The 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 upgrades in the background, or wait for the downloads to complete.

  7. Click Next.

    The Summary page is displayed.

  8. Click Finish.

4.1.2 Downloading Upgrades From the Oracle Technology Network

You can download upgrade bundles for the Enterprise Controller and Proxy Controller from the Oracle Technology Network.

  1. Log in to the Oracle Technology Network Oracle Enterprise Manager Ops Center page at http://www.oracle.com/technetwork/oem/ops-center/index.html.

  2. Click Enterprise Manager Ops Center in the Enterprise Manager Downloads sidebar.

  3. Select Accept License Agreement.

  4. Click the Enterprise Controller bundle with the correct operating system and architecture to download the full bundle. This bundle contains the Enterprise Controller for the selected architecture, and Proxy Controller and Agent Controller files for every supported operating system and architecture.

  5. Copy the Enterprise Controller bundle to the /var/opt/sun/xvm/images/productUpdate/ directory on the Enterprise Controller system.

4.1.3 Downloading 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.

To Download Upgrades From the Oracle Software Delivery Cloud

  1. Log in to the Oracle Software Delivery Cloud at http://edelivery.oracle.com.

  2. Read and accept the Software License Agreement and Export Restrictions, then click Continue.

  3. Select the Oracle Enterprise Manager product pack and the correct platform for your environment, then click Go.

    The list of download packs is displayed.

  4. Select the Media Pack for the target version and click Continue.

    The list of available bundles is displayed.

  5. Click download next to the Enterprise Controller bundle with the correct operating system and architecture to download the full bundle, then save the downloaded bundle locally. This bundle contains the Enterprise Controller files for the selected architecture and operating system, and Proxy Controller and Agent Controller files for every supported operating system and architecture.

  6. Copy the Enterprise Controller bundle to the /var/opt/sun/xvm/images/productUpdate/ directory on the Enterprise Controller system.

4.2 Upgrading a Single Enterprise Controller from the User Interface

The following procedure describes how to upgrade the Enterprise Controller. You can view and install upgrades from the user interface.

The upgrade log file is stored in the /var/opt/sun/xvm/update-saved-state directory on the Enterprise Controller.

Note:

The upgrade disables the Oracle Solaris 11 update manager service, svc:/application/pkg/update:default, if it is enabled.

Before You Begin

Perform the following tasks before you upgrade the Enterprise Controller:

  • Download the Enterprise Controller upgrade bundle.

  • Review pending and scheduled jobs before updating the Enterprise Controller. The upgrade shuts down the Enterprise Controller, which causes running jobs to fail.

  • Use the OCDoctor to verify that there are no outstanding issues on the Enterprise Controller system. Run the OCDoctor with the --update option, then run the OCDoctor script with the --troubleshoot option. See the Oracle Enterprise Manager Ops Center Administration Guide for more information about the OCDoctor.

  • When you are using an embedded database, verify that the required Oracle Database 11g Enterprise Edition installation files are present in the /var/tmp/downloads directory on the Enterprise Controller system.

    • If you are currently using Oracle Enterprise Manager Ops Center version 12.2.1 or earlier, the Oracle Database 11g Enterprise Edition 11.2.0.3 installation files must be present.

    • If you are upgrading to Oracle Enterprise Manager Ops Center 12.2.2, and you are currently using Oracle Enterprise Manager Ops Center version 12.2.0 or version 12.2.1, the Oracle Database 11g Enterprise Edition 11.2.0.4 installation files must be present.

    Follow this procedure to download the required installation files if they are not present:

    Note:

    The download procedure requires a valid My Oracle Support (MOS) account, which must be associated with a Customer Service Identifier (CSI) with a software contract.
    1. Create a /var/tmp/downloads directory on the Enterprise Controller system.

    2. Navigate to http://support.oracle.com, click Sign In, and sign in with your My Oracle Support (MOS) credentials.

    3. Click the Patches & Updates tab.

    4. Enter the patch number for your version in the field next to Patch Name or Number.

      For Oracle Database 11g Enterprise Edition version 11.2.0.3, enter 10404530.

      For Oracle Database 11g Enterprise Edition version 11.2.0.4, enter 13390677.

    5. Click the Add Filter icon, then select your Enterprise Controller system's operating system and architecture in the drop-down menu next to Platform.

    6. Click Search.

      The Oracle Database 11g Enterprise Edition patch set of the appropriate version is displayed.

    7. Click Download.

      The file download popup is displayed.

    8. Download the first two files. For Oracle Solaris x86, these files end with _1of6.zip and _2of6.zip. For Oracle Solaris SPARC and Linux, these files end with _1of7.zip and _2of7.zip

    9. Copy or move the downloaded installation bundles to the /var/tmp/downloads directory on the Enterprise Controller system.

To Upgrade the Enterprise Controller

  1. Disable the Auto Service Request (ASR) feature if it is enabled.

    1. Click Administration in the Navigation pane, then select the Enterprise Controller.

    2. Click Disable ASR in the Actions pane.

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

  3. Click Upgrade Enterprise Controller.

    The Upgrade Enterprise Controller Wizard is displayed.

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

  5. Select an upgrade 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 upgrade fails, the installation file is used for rollback.

  6. If the Install Path Verification page is displayed, enter the path to the Oracle Enterprise Manager Ops Center installer and click Next. By default, the upgrade process uses the /var/opt/sun/xvm/update-saved-state/ directory to back out the changes if the upgrade fails.

  7. The Job Details page is displayed. When the upgrade shuts down the Enterprise Controller, any jobs that are running fail. View the job details, then click Next. The Summary page is displayed.

  8. 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 displays normally when the upgrade is complete.

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

  10. Back up your Oracle Enterprise Manager Ops Center data using the ecadm command and the backup subcommand.

  11. (Optional) Once the upgrade has completed successfully, remove the version 12.1 installer to reclaim disk space.

    # rm -rf /var/opt/sun/xvm/EnterpriseController_installer_12.1.*
    
  12. Enable the Auto Service Request (ASR) feature if you disabled it at the beginning of the upgrade.

    1. Click Administration in the Navigation pane, then select the Enterprise Controller.

    2. Click Enable ASR in the Actions pane.

Note:

If you are upgrading to version 12.2.0.0.0, then when the Enterprise Controller upgrade is complete, view the contents of the /var/opt/sun/xvm/update-saved-state/update_EC_minor_bundle_12.2.0.<build number>/updatelog.txt file. If an error message indicates that the database must be migrated manually, see Appendix A, "Manually Upgrading Database Tables" for this procedure.

4.3 Upgrading a Proxy Controller from the User Interface

You can remotely upgrade Proxy Controllers to the latest available version.

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. See Upgrading a Proxy Controller from the Command Line for more information.

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

Note:

The upgrade disables the Oracle Solaris 11 update manager service, svc:/application/pkg/update:default, if it is enabled.

Before You Begin

Upgrade the Enterprise Controllers before you upgrade the Proxy Controllers.

To Upgrade a Proxy Controller

  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 Upgrade to Latest Available Version icon in the center pane.

    The Upgrade 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 update the Proxy Controllers.

4.4 Upgrading Agent Controllers from the User Interface

You can remotely upgrade Agent Controllers to the latest available version.

If you are upgrading Agent Controllers running in non-global zones, upgrade the Agent Controller in the global zone before upgrading all of the non-global zones. If you are upgrading Agent Controllers running in zones within a Logical Domain, upgrade the Agent Controller in the Control Domain before upgrading the Agent Controllers on the zones.

Caution:

If you upgrade Agent Controllers on virtualized systems in an order other than that specified here, the assets do not display correctly in the user interface. To cause the assets to display correctly, unconfigure the Agent Controllers, then reconfigure or reinstall them in the specified order.

Note:

Virtualization Agent Controllers require 1024 MB of memory after the upgrade to version 12.2.1.0.0.

Note:

The upgrade disables the Oracle Solaris 11 update manager service, svc:/application/pkg/update:default, if it is enabled.

To Upgrade Agent Controllers

  1. Select one or more assets with Agent Controllers.

    • Select an asset from the All Assets section of the Assets tab.

    • Select a group that contains operating systems.

  2. Click Upgrade Agent Controller if you selected one asset, or Upgrade All Agent Controllers if you selected a group.

    The Upgrade Agent Controllers page is displayed.

  3. Select an upgrade option for the system or systems to be upgraded, then click Next.

    • The Automatic upgrade option lets you upgrade Agent Controllers without using SSH credentials. The Agent Controllers must be running for an automatic upgrade.

    • The SSH upgrade using one set of credentials for all targets option prompts you for a single set of SSH credentials for all systems to be upgraded.

    • The SSH upgrade using individual credentials for each target option prompts you for a separate set of credentials for each system to be upgraded.

    The Summary page is displayed.

  4. Click Finish.

    The Agent Controller upgrade job is launched.