11 Perform Upgrades

You can upgrade to the latest version of Oracle Enterprise Manager Ops Center 12c if you are currently using Oracle Enterprise Manager Ops Center 12c.

This chapter includes the following sections:

• Introduction to Upgrade

• Roles for Upgrade

• Actions for Upgrade

• Location of Upgrade Information in the User Interface

• Versions Supported for Upgrade

• Planning the Upgrade

• Database Requirements

• Upgrading Your Environment

• Related Resources for Upgrade

Introduction to Upgrade

You can upgrade to the latest version of Oracle Enterprise Manager Ops Center from Oracle Enterprise Manager Ops Center 12c.

Some of the procedures described in this section use the ecadm, proxyadm, and agentadm commands. See Command Line Administration 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.

Roles for Upgrade

You require specific roles to perform upgrade tasks in Oracle Enterprise Manager Ops Center.

The following table lists the tasks and the role required to complete the task. Contact your administrator if you do not have the necessary role or privilege to complete a task.

Table 11-1 Upgrade Tasks and Roles

Task	Role
Upgrading Enterprise Controller High Availability	Ops Center Admin
Upgrading Proxy Controller	Ops Center Admin
Upgrading Agent Controller	Ops Center Admin

Actions for Upgrade

You can perform various upgrade operations using Oracle Enterprise Manager Ops Center.

Using Oracle Enterprise Manager Ops Center, you can perform the following tasks:

• Upgrade from version 12.3

• Upgrade from version 12.2

• Upgrade from version 12.1

• Upgrade from version 11g

Location of Upgrade Information in the User Interface

In the Oracle Enterprise Manager Ops Center user interface, you can find upgrade information in different locations.

Table 11-2 Location of Upgrade Information in the UI

To See	Location
Download Upgrades	Expand Administration in the Navigation pane and select the Enterprise Controller. Select Ops Center Downloads in the Actions pane.
Upgrade Enterprise Controller	Expand Administration in the Navigation pane and select the Enterprise Controller. Select Upgrade Enterprise Controllers in the Actions pane.
Upgrade Enterprise Controllers	Expand Administration in the Navigation pane and select the Proxy Controllers tab. Select Upgrade to Latest Available Version icon in the center pane.
Upgrade Agent Controllers	Expand Assets in the Navigation pane and select All Assets. Select an asset or a group.

Versions Supported for Upgrade

Before planning your upgrade, read this section carefully, as you may need to perform multiple upgrades to reach the latest version.

This section details the supported upgrade paths.

The following topics are covered:

• Upgrading From Version 12.3

• Upgrading From Version 12.2

• Upgrading From Version 12.1

• Upgrading From Version 11g

Upgrading From Version 12.3

Use the following upgrade path when you are upgrading from Oracle Enterprise Manager Ops Center 12.3.0 to later versions.

If you are currently using version 12.3.0 or 12.3.1, you can upgrade directly to version 12.3.2.

Description of the illustration GUID-C14E88F2-CE0E-4715-9546-8B781CB64FF8-default.png

Upgrading From Version 12.2

Use the following upgrade path when you are upgrading from Oracle Enterprise Manager Ops Center 12.2 to later versions.

If you are currently using version 12.2.0, 12.2.1, or 12.2.2, you can upgrade to version 12.3.0, and finally upgrade to the latest version.

Figure 11-1 Supported Upgrade Paths From Version 12.2

Description of "Figure 11-1 Supported Upgrade Paths From Version 12.2"

Upgrading From Version 12.1

Use the following upgrade path when you are upgrading from Oracle Enterprise Manager Ops Center 12.1 to later versions.

If you are currently using Oracle Enterprise Manager Ops Center version 12.1, you can upgrade to version 12.1.3 or 12.1.4, then upgrade to version 12.2.0, then upgrade to version 12.3.0, and finally upgrade to the latest version.

Figure 11-2 Supported Upgrade Paths From Version 12.1

Description of "Figure 11-2 Supported Upgrade Paths From Version 12.1"

You must upgrade in this order:

1. If you are using version 12.1.0, 12.1.1, or 12.1.2, upgrade to version 12.1.4.0.0 as described in Related Resources for Upgrade.

2. Upgrade to version 12.2.0.0.0 as described in this guide.

3. Upgrade to version 12.3.0.0.0 as described in this guide.

4. Upgrade to version 12.3.2.0.0 as described in this guide.

Upgrading From Version 11g

Use the following upgrade path when you are upgrading from Oracle Enterprise Manager Ops Center 11g to later versions.

If you are currently using Oracle Enterprise Manager Ops Center 11g, you can upgrade to version 12.1.1, then upgrade to version 12.1.4, then upgrade to version 12.2.0, then upgrade to 12.3.0, and finally upgrade to the latest version.

Figure 11-3 Supported Upgrade Paths From Version 11g

Description of "Figure 11-3 Supported Upgrade Paths From Version 11g"

You must upgrade in this order:

1. Upgrade to version 12.1.1.0.0 as described in Related Resources for Upgrade.

2. Upgrade to version 12.1.4.0.0 as described in Related Resources for Upgrade.

3. Upgrade to version 12.2.0.0.0 as described in this guide.

4. Upgrade to version 12.3.0.0.0 as described in this guide.

5. Upgrade to version 12.3.2.0.0 as described in this guide.

Planning the Upgrade

Upgrading to a newer version of Oracle Enterprise Manager Ops Center can change the system requirements and affect existing settings and data.

Follow this procedure to plan your upgrade.

• Review the pre-installation requirements and known issues. See Related Resources for Upgrade for information on reviewing the pre-installation requirements and known issues.

• Verify that your system meets the operating system requirements. See Related Resources for Upgrade for information on verifying the operating system requirements.

• Verify that your system meets the system requirements, since some system requirements have changed. See Related Resources for Upgrade for information on verifying the system requirements.

  You can use the OCDoctor to check system requirements and to identify and address some known issues. See Manage the OCDoctor for more information on using OCDoctor.

• Check if there are any traces from previous Enterprise Controller installation or upgrade procedure. Remove the /tmp/CVU_12.1.0.2.0_oracleoc directory and /tmp/CVU_11.2.0.4.0_oracleoc directory before installing or upgrading the Enterprise Controller.

• If you made changes to the uce.rc file, the upgrade erases your changes. Copy your changes to the .uce.rc file before beginning the upgrade.

• If you replaced the self-signed web server certificate for the Enterprise Controller, the upgrade erases your web server configuration changes, and might erase the certificate. See Oracle Enterprise Manager Ops Center Security for information on replacing the self-signed web server 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.

• If your Enterprise Controller is installed on Oracle Solaris 11, your Oracle Solaris 11 publisher must point to an Oracle Solaris 11 repository that contains the specific version of Oracle Solaris 11 installed on the Enterprise Controller before you begin the upgrade. If not, the upgrade process does not proceed.

• While installing or upgrading Enterprise Controllers with a colocated Oracle 12c database, set either the zfs_arc_max parameter value or the user_reserve_hint_pct parameter value in the /etc/system file or a configuration file located in the /etc/system.d directory for Oracle Solaris 11.x platforms. You can use the OC Doctor to calculate the parameter value. Once the parameter value is set, restart the system for the configuration to take effect.

  At the beginning of the installation or upgrade of an Enterprise Controller, if the parameter values are not set, then the install or the upgrade wizard provides information on the parameter value to be set and how to set the parameter value.

• If you are upgrading to version 12.2.2.0.0 or 12.3.0.0.0, and are using the embedded database, you must download installation bundles for Oracle Database version 11.2.0.4, as the Oracle Enterprise Manager Ops Center upgrade also upgrades the embedded database. The download procedure is described in the Before You Begin section in each upgrade chapter.

  Note:

  Due to improvements to vServer management, Oracle VM Server for SPARC vServer templates from version 12.1.4.0.0 or earlier will not function in version 12.2.0.0.0 or later and must be recreated. In addition, a user with the Cloud Administrator role must configure at least one vNet as a boot network before creating any new vServers.

• If you are upgrading to version 12.3.1.0.0 or later, and are using the embedded database, you must download installation bundles for Oracle Database version 12.1.0.2, as the Oracle Enterprise Manager Ops Center upgrade also upgrades the embedded database. The download procedure is described in the Before You Begin section in each upgrade chapter.

• Any Oracle Enterprise Manager Ops Center IDRs that are installed prior to upgrading are automatically removed during the upgrade. If the upgrade fails and a rollback takes place, these IDRs must be manually re-installed. When the upgrade is successful, these IDRs will no longer be needed and no further action is required. The Ops Center IDRs uninstalled are listed in the upgrade log.

• Do not upgrade the Java version on Oracle Solaris 10 Control Domains or Logical Domains that have LDOM Manager version 3.2 or earlier installed. If you have upgraded the Java on these systems to version 1.6.0_101 or higher, downgrade to Java 1.6.0_95.

Database Requirements

Oracle Enterprise Manager Ops Center version 12c can use either an embedded database on the Enterprise Controller system or a customer-managed database. You cannot change the existing database configuration during the upgrade.

The embedded database is configured and managed by Oracle Enterprise Manager Ops Center. The embedded database requires 10 GB of space, plus 240 MB per managed asset, 400 MB per UCE channel, and 20% of the space currently taken up by the /var/opt/sun/xvm/db/mgmt and var/opt/sun/xvm/db/report directories.

You must install and configure a compatible database to use a customer-managed database. Using a customer-managed database requires no additional space beyond that required by the Enterprise Controller.

Upgrading Your Environment

There are several upgrade procedures available for a variety of environments.

Several factors will determine the procedure that is most appropriate for your environment. The Table 11-3 shows the relevant chapter for you based on your environment and your preferences for the upgrade. Each chapter is a complete upgrade procedure.

Environments with a single Enterprise Controller use a separate procedure from environments with Enterprise Controller High Availability.

You can perform upgrades through the user interface or from the command line.

Table 11-3 Upgrade Procedures by Environment and Upgrade Choices

Enterprise Controller High Availability?	User Interface or Command Line?	Chapter
Yes	User Interface	Chapter 2, Upgrading an HA Environment Using the User Interface
Yes	Command Line	Chapter 3, Upgrading an HA Environment Using the Command Line
No	User Interface	Chapter 4, Upgrading a Single EC Environment Using the User Interface
No	Command Line	Chapter 5, Upgrading a Single EC Environment Using the Command Line

Related Resources for Upgrade

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

For more information, see these Oracle resources:

• For information on upgrading 12.1 versions, see the Upgrading chapter in Version 12.1 Administration Guide

• For pre-installation and known issues, see Oracle Enterprise Manager Ops Center Release Notes

• For information on operating system requirements, see Oracle Enterprise Manager Ops Center Certified Systems Matrix

• For information on system requirements, see Oracle Enterprise Manager Ops Center Installation for Oracle Solaris Operating System or Oracle Enterprise Manager Ops Center Installation for Linux Operating Systems

• To download OCDoctor, go to https://updates.oracle.com/OCDoctor/OCDoctor-latest.zip

• For information on vServer Management, see Oracle Enterprise Manager Ops Center Virtualization Reference

• For information on upgrading procedures, see Oracle Enterprise Manager Ops Center Upgrade

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