5 Upgrading a Single EC Environment Using the Command Line

You can upgrade an environment with a single Enterprise Controller through the command line.

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 the illustration GUID-C5F2B357-60C9-4712-932C-CBE2B4D262E1-default.png

Some of the procedures described in this guide use the ecadm, proxyadm, and agentadm 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.

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.

The following topics are covered:

• Downloading Upgrades From the User Interface

• Downloading Upgrades From the Oracle Technology Network

• Downloading Upgrades From the Oracle Software Delivery Cloud

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.

1. Expand the Administration section of the Navigation pane, then select Enterprise Controller.
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. Select 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.

Downloading Upgrades From the Oracle Technology Network

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

This procedure describes the steps to download upgrades from the Oracle Technology Network.

1. Log in to the Oracle Technology Network Oracle Enterprise Manager Ops Center page. See Related Resources for Single EC Upgrade Using the Command Line for the link to log in.
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.

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. See Related Resources for Single EC Upgrade Using the Command Line for the link to log in.
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.

Upgrading a Single Enterprise Controller from the Command Line

You can upgrade a single Enterprise Controller from the command line interface.

Before you begin:

The following procedures describe how to upgrade the Enterprise Controller, with either an embedded database or a customer-managed database. If you are running Oracle Enterprise Manager Ops Center in Disconnected Mode, you must upgrade from the command line. The co-located Proxy Controller is upgraded as well, even if it is not enabled.

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

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

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.

• Verify that the Enterprise Controller has at least five (5) GB of free space for the upgrade bundle other than the space required for the patch downloads.

• Acquire the upgrade bundle from Oracle and transfer it to the Enterprise Controller system.

• Review pending and scheduled jobs before updating the Enterprise Controller. The upgrade shuts down the Enterprise Controller, which causes running jobs to fail. Scheduled jobs cannot be launched while the upgrade is being applied.

• 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.

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

  • If you are upgrading to Oracle Enterprise Manager Ops Center 12.3.0, the Oracle Database 11g Enterprise Edition 11.2.0.4 installation files must be present.

  • If you are upgrading to Oracle Enterprise Manager Ops Center 12.3.1 or later, the Oracle Database 12c Enterprise Edition 12.1.0.2 installation files must be present.

To download Oracle Database 12c Release 1 (12.1.0.2.0) Enterprise Edition version installation bundles:

1. Create a /var/tmp/downloads directory on the Enterprise Controller system.

2. Download the Oracle 12c Enterprise Edition installation files from http://www.oracle.com/technetwork/database/enterprise-edition/downloads/index-092322.html.

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

To download Oracle Database 11g Enterprise Edition version installation bundles:

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 My Oracle Support page, click Sign In, and sign in with your My Oracle Support (MOS) credentials. See Related Resources for Single EC Upgrade Using the Command Line for the link to log in.

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.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 an Enterprise Controller with an embedded database from the command line:

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

   1. Expand the Administration section of the Navigation pane, then select Enterprise Controller.

   2. Click Disable ASR in the Actions pane.

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

3. Verify that the Enterprise Controller is online using ecadm command. If necessary, use the ecadm start command to start the Enterprise Controller. For example:

   # /opt/SUNWxvmoc/bin/ecadm status
   online
   

4. Create a temporary directory within the directory where you installed Oracle Enterprise Manager Ops Center, then copy or move the upgrade bundle to the new directory. For example:

   # mkdir /var/tmp/OC/update
   # cp enterprise-controller.Solaris.sparc.12.3.1.608.tar.zip /var/tmp/OC/update
   

5. Change to the directory containing the upgrade bundle.

   # cd /var/tmp/OC/update
   

6. Unzip and un-tar the bundle.

   • If your upgrade bundle has the .tar.zip extension, use the unzip and tar commands to uncompress and un-tar the bundle, then list the contents of the temporary directory. The following command example retains the original compressed bundle file. For example:

     # unzip enterprise-controller.Solaris.i386.12.3.1.608.tar.zip | tar xf -
     # ls
     enterprise-controller.Solaris.i386.12.3.1.608.tar.zip
     xvmoc_full_bundle
     #
     

   • If your upgrade bundle has the .zip extension, use the unzip command to uncompress the bundle. For example:

     # unzip enterprise-controller.Solaris.i386.12.3.1.608.zip
     # ls
     enterprise-controller.Solaris.i386.12.3.1.608.zip
     xvmoc_full_bundle
     #
     

7. 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:

   --verbose or -v: Increases verbosity of output from upgrade program. Without this option, non-verbose output is given.

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

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

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

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

    # rm -rf /var/opt/sun/xvm/EnterpriseController_installer_12.2.*
    

11. Enable the Auto Service Request (ASR) feature if you disabled it at the beginning of the upgrade.

    1. Expand the Administration section of the Navigation pane, then select Enterprise Controller.

    2. Click Enable ASR in the Actions pane.

Note:

If an error message is displayed indicating that the database must be migrated manually. see Manually Upgrading Database Tables for this procedure.

Note:

To revert to an earlier version after upgrading to version 12.3.1 or later, if you are using a customer-managed database, you must revert both the Enterprise Controller system and database system to the same pre-upgrade state. If you revert to an earlier version, all monitoring data gathered since the reversion point is lost.

Upgrading a Proxy Controller from the Command Line

You can manually update Proxy Controllers to the latest available version to gain access to new and updated features.

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

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

Note:

During the upgrade process, the Proxy Controller is shut down. However, the Proxy Controller must be online at the beginning of the process.

Note:

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

Upgrade the Enterprise Controllers before you upgrade the Proxy Controllers.

1. As root, log in to the Proxy Controller system.
2. Use the proxyadm command with the backup subcommand to back up the Proxy Controller.

   For example:

   proxyadm backup
   

   The following options may be used with the proxyadm command:

   • -o|--output <backup file>: Specify the file in which the backup archive is generated. Do not specify a path inside the /opt/*xvm* directories. The default output file is /var/tmp/proxy-backup-<date>-<time>.tar.

   • -l|--logfile <logfile>: Save output from command in <logfile>. Log files are stored in the /var/tmp/ directory.

   • -d|--description <description string>: Embed the <description string> as the description of the backup archive.

   • -t|--tag <tag>: Embed <tag> as a single-word tag in the backup archive.

   • -T|--tempdir <dir>: Specify the temporary staging directory location.

   • -v|--verbose: Increase the verbosity level. This option may be repeated.

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

   For example:

   # ./proxyadm status
   online
   

4. Create a temporary directory on the Proxy Controller system, then copy or move the Proxy Controller upgrade bundle from the /var/opt/sun/xvm/images/productUpdate directory on the Enterprise Controller system to the new directory on the Proxy Controller system.
5. Uncompress and un-tar the upgrade bundle, then list the contents of the temporary directory.

   • For example, on a Linux Proxy Controller:

     # unzip proxy-controller.Linux.i686.12.3.1.608.tar.zip
     # tar xf proxy-controller.Linux.i686.12.3.1.608.tar
     # ls
     xvmoc_full_bundle
     proxy-controller.Linux.i686.12.3.1.608.tar
     #
     

   • On an Oracle Solaris Proxy Controller:

     # gzcat proxy-controller.Solaris.i386.12.3.1.608.tar.zip | tar xf -
     # ls
     xvmoc_full_bundle
     proxy-controller.Solaris.i386.12.3.1.608.tar.zip
     

6. Change to the xvmoc_full_bundle directory.
7. Run the install script.

   # ./install
   

   The following option may be used with the install script:

   --install <install bundle path> or -i <install bundle path> : If the Oracle Enterprise Manager Ops Center install bundle cannot be found in the /var/opt/sun/xvm/ directory, you must use this option to specify the location of the Oracle Enterprise Manager Ops Center install bundle.

   The upgrade is installed on the Proxy Controller. When the upgrade is complete, the install script indicates that all components have been upgraded.

Upgrading Agent Controllers from the Command Line

You can upgrade Agent Controllers manually. Before you upgrade an Agent Controller, you must upgrade the Proxy Controller that manages it.

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 display the assets correctly, unconfigure the Agent Controllers, then reconfigure or reinstall them in the specified order.

Note:

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

This procedure requires root access.

1. Copy the new Agent Controller bundle from the Enterprise Controller to the client, remove the existing Agent Controller directory, and extract the new Agent Controller bundle.

   For example, on Oracle Solaris 8, 9, or 10 Agent Controllers:

   # scp <IP of Enterprise Controller>:/var/opt/sun/xvm/images/agent/OpsCenterAgent.Solaris.`uname -p`.12.3.1.608.zip /var/tmp
   # cd /var/tmp
   # rm -r OpsCenterAgent
   # unzip OpsCenterAgent.Solaris.`uname -p`.12.3.1.608.zip
   

   On Oracle Solaris 11 Agent Controllers:

   # scp <IP of Enterprise Controller>:/var/opt/sun/xvm/images/agent/OpsCenterAgent.SolarisIPS.all.12.3.1.608.zip /var/tmp
   # cd /var/tmp
   # rm -r OpsCenterAgent
   # unzip OpsCenterAgent.SolarisIPS.all.12.3.1.608.zip
   

   On Linux Agent Controllers:

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

2. Use the agentadm command with the stop subcommand to stop the Agent Controller.

   • 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.

   For example:

   ./agentadm stop
   

3. Install the Agent Controller upgrade.

   # cd /var/tmp/OpsCenterAgent
   # ./install
   

4. Use the agentadm command with the configure subcommand and the --keep-connection option to configure the new Agent Controller.

   For example:

   # ./agentadm configure --keep-connection
   

   This step also starts the Agent Controller.

   Note:

   The following errors may safely 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 Agent Controller installation and configuration. The correct sysidcfg scripts are 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://192.0.2.1:21165 urn:scn:clregid:1234567-aaaa-bbbb-cccc-123456789abc:YYYYMMDDHHMMSSsss
   

Related Resources for Single EC Upgrade Using the Command Line

You can view the Oracle Enterprise Manager Ops Center documents for additional information.

For more information, see these Oracle resources:

• For information on ecadm, proxyadm, and agentadm commands and for information on OCDoctor, see the following chapters in the Oracle Enterprise Manager Ops Center Administration:

  • Manage the OCDoctor

  • Command Line Administration

• For Oracle Technology Network Oracle Enterprise Manager Ops Center log in page, go to http://www.oracle.com/technetwork/oem/ops-center/index.html

• For Oracle Software Delivery Cloud log in page, go to http://edelivery.oracle.com

• For My Oracle Support page, go to http://support.oracle.com

• To download Oracle Database 12c Enterprise Edition installation bundle, see http://www.oracle.com/technetwork/database/enterprise-edition/downloads/index-092322.html

• The Oracle Enterprise Manager Ops Center Documentation Library is located at http://docs.oracle.com/cd/E59957_01/index.htm

• For more information on product administration, see http://docs.oracle.com/cd/E59957_01/nav/administer.htm

• For end-to-end examples, see the Deploy How To library at http://docs.oracle.com/cd/E59957_01/nav/deploy.htm and the Operate How To library at http://docs.oracle.com/cd/E59957_01/nav/operate.htm

• For more information on Enterprise Manager Ops Center, see the Ops Center blog at https://blogs.oracle.com/opscenter/