| Oracle® Enterprise Manager Cloud Control Upgrade Guide 12c Release 1 (12.1.0.1) Part Number E22625-08 |
|
|
PDF · Mobi · ePub |
Before you use the upgrade approaches to upgrade to Enterprise Manager Cloud Control, keep these points in mind:
The following upgrade paths are supported:
You can upgrade from Enterprise Manager 10g Grid Control Release 5 (10.2.0.5.0) directly to Enterprise Manager Cloud Control
You can upgrade from Enterprise Manager 11g Grid Control Release 1 (11.1.0.1.0) directly to Enterprise Manager Cloud Control.
You can upgrade from Enterprise Manager 10g Grid Control Release 5 (10.2.0.5.0) to Enterprise Manager 11g Grid Control Release 1 (11.1.0.1.0), and then upgrade to Enterprise Manager Cloud Control.
If you have Enterprise Manager 10g Grid Control Release 1 (10.1) or Enterprise Manager 10g Grid Control Release 4 (10.2.0.4.0) or lower, then you must first upgrade or patch them to Enterprise Manager 10g Grid Control Release 5 (10.2.0.5.0) or Enterprise Manager 11g Grid Control Release 1 (11.1.0.1.0). After upgrading or patching them to the supported releases, upgrade them to Enterprise Manager Cloud Control.
The following platforms are supported:
1-System upgrade, understandably, must always be done on the same platform as the earlier release of the Enterprise Manager system because you are upgrading on the same host.
2-System upgrade is possible on the same platform as the earlier release of the Enterprise Manager system, and from Linux (32-bit) to Linux (64-bit) (or vice versa) because you are upgrading on a remote host.
1-System upgrade on a different host is possible on the same platform as the earlier release of the Enterprise Manager system, and from Linux (32-bit) to Linux (64-bit) (or vice versa) because you are upgrading on a remote host, much like 2-System upgrade approach.
The following are some facts about the upgrade approaches:
You can choose to use either 1-System, 2-System, or 1-System upgrade approach on a different host. However, regardless of the approach you choose, the upgrade operation is always an out-of-place upgrade where you see new Oracle homes of Oracle Management Service (OMS) and Oracle Management Agent (Management Agent).
The upgrade approaches do NOT upgrade your existing database where the Management Repository is configured.
To upgrade such databases, use the database upgrade tool. For more information, on the upgrade tool, see the Oracle Database Upgrade Guide available in the Oracle Database documentation library at:
http://www.oracle.com/technetwork/indexes/documentation/index.html
Oracle Management Service 12c communicates only with Oracle Management Agent 12c. Therefore, it is important to upgrade your Management Agents before upgrading your OMS.
You can upgrade any Management Agent as long as the Oracle Management Agent 12c software for that platform is available.
You must not upgrade to Enterprise Manager Cloud Control in a middleware home that is on an NFS-mounted drive. Upgrading on an NFS-mounted drive causes the Oracle HTTP Server to restart frequently, which inturn makes the OMS inaccessible. If you are forced to upgrade on such a shared drive, then ensure that the OMS instance base directory (gc_inst) is created in a non-NFS-mounted location.
The Enterprise Manager Cloud Control Installation Wizard installs Java Development Kit (JDK) 1.6 v24 and Oracle WebLogic Server 11g Release 1 (10.3.5) if they do not exist in your environment.
If Oracle WebLogic Server 11g Release 1 (10.3.5) does not exist, then Oracle recommends you to allow the installation wizard to install it for you. However, if you want to manually install it, then ensure that you install it using JDK 1.6 v24+ (64-bit version for 64-bit platforms and 32-bit version for 32-bit platforms).
Download JDK 1.6 v24+ for your platform from the platform vendor's Web site. For example, download SUN JDK 1.6 v24+ for Linux platforms from Oracle Web site. Similarly, download the JDK for other platforms from other vendors' trusted Web sites.
If you already have JDK, then verify its version by navigating to the <JDK_Location>/bin directory and running the following command:
"./java -fullversion"
To verify whether it is a 32-bit or a 64-bit JDK, run the following command:
"file *"
If you want to manually install Oracle WebLogic Server 11g Release 1 (10.3.5) on Linux 64-bit platforms, first install the 64-bit JDK for your platform, and then download and use the wls1035_generic.jar file to install Oracle WebLogic Server.
For example,
<JDK home>/bin/java -d64 -jar <absolute_path _to_wls1035_generic.jar>
If you want to manually install Oracle WebLogic Server 11g Release 1 (10.3.5) on Linux 32-bit platforms, then download and use either the wls1035_linux32.bin file or the wls1035_generic.jar file.
For example,
<JDK home>/bin/java -jar <absolute_path _to_wls1035_generic.jar>
You must follow the instructions outlined in the Oracle® Fusion Middleware Installation Guide for Oracle WebLogic Server to install Oracle WebLogic Server. The guide is available in the Fusion Middleware documentation library available at:
http://www.oracle.com/technetwork/middleware/weblogic/documentation/index.html
You must ensure that the Oracle WebLogic Server installation is a typical installation, and even if you choose to perform a custom installation, ensure that components chosen for custom installation are the same as the ones associated with a typical installation.
You must ensure that the user installing the WebLogic Server is the same as the one installing Enterprise Manager Cloud Control.
You must ensure that the Oracle WebLogic Server 11g Release 1 (10.3.5) installed by the Enterprise Manager Cloud Control Installation Wizard or by you is dedicated for Enterprise Manager Cloud Control. You must not have any other Oracle Fusion Middleware product installed in that middleware home.
Enterprise Manager Cloud Control cannot coexist with any Oracle Fusion Middleware product in the same middleware home because the ORACLE_COMMON property is used by both the products.
When you upgrade your Management Agents, the ports used by the earlier release of the Management Agents are carried over to the upgraded Management Agents. Therefore, your firewall settings are not affected in any way.
When you upgrade your OMS, the following ports are assigned:
For 2-System upgrade approach, the Enterprise Manager Cloud Control Installation Wizard assigns default ports to all the core components.
For information about the core components, the range within which a port is selected, and the free port that is assigned, see the chapter on installation basics in the Oracle Enterprise Manager Cloud Control Advanced Installation and Configuration Guide.
For 1-System upgrade approach, the ports used for the earlier release of the following core components are carried over:
Enterprise Manager Upload HTTP Port
Enterprise Manager Upload HTTP SSL Port
Enterprise Manager Central Console HTTP Port
Enterprise Manager Central Console HTTP SSL Port
Oracle Management Agent
However, for the rest of the core components, the Enterprise Manager Cloud Control Installation Wizard assigns default ports, unless other values are provided in the wizard.
For information about the core components, the range within which a port is selected, and the free port that is assigned, see the chapter on installation basics in the Oracle Enterprise Manager Cloud Control Advanced Installation and Configuration Guide.
To identify the plug-ins required for upgrade, in the Enterprise Manager 12c Upgrade Console, in the Preupgrade Steps section, click Manage Software. On the Manage Software page, view the plug-ins that are required for upgrading your system.
The plug-ins listed on the Manage Software page are based on the targets monitored by the old Management Agents in your existing system, and also based on the new plug-in requirement Enterprise Manager Cloud Control has. You need all the plug-ins listed on this page to successfully upgrade your existing system.
This section describes how you can download and install the required plug-ins while upgrading the Management Agent and OMS. In particular, this section covers the following:
To install the required plug-ins while upgrading the Management Agents, follow these steps:
Access the following URL:
http://www.oracle.com/technetwork/oem/grid-control/downloads/oem-upgrade-console-502238.html
Download the Management Agent software to an accessible location. Do NOT extract the contents of the software ZIP file. The Management Agent software is platform-specific, so ensure that you copy the software for the platform on which you want to install.
Download all the required plug-ins to the same location. Plug-ins are generic, so they are common for all platforms.
Ensure that you download all the plug-ins listed as required plug-ins on the Manage page, whether or not you want to monitor a target with them. You may feel that a few plug-ins are not required because you do not have targets to be monitored by them, but those plug-ins may be required for upgrading your system. Therefore, download all the plug-ins listed on the Manage Software page. Ensure that you download these plug-ins before backing up the database that contains the Management Repository.
Note:
You can also download these plug-ins from the<software_kit>/plugins directory, but Oracle recommends you to download them from OTN so that you always procure the latest plug-ins and the plug-ins for all platforms.Note:
To identify what plug-ins are required, in the Enterprise Manager 12c Upgrade Console, in the Preupgrade Steps section, from the table, click Manage Software. On the Manage Software page, in the Plug-In Software section, see the required plug-ins.Download all the plug-ins listed as required plug-ins on the Manage Software page, whether or not you want to monitor a target with them. You may feel that a few plug-ins are not required because you do not have targets to be monitored by them, but those plug-ins may be required for upgrading your system. Therefore, download all the plug-ins listed on the Manage Software page. And ensure that you download these plug-ins before backing up the database that contains the Management Repository.
In the Enterprise Manager 12c Upgrade Console, on the Manage Software page (Preupgrade Steps section), in the Provide Software Location section, enter the absolute path to the directory where the plug-in is present, and click Validate to register that location with the Management Repository.
See:
For information about registering and validating the plug-in location, see Chapter 9.To install the required plug-ins while upgrading the OMS, invoke the installer and proceed to the Select Plug-Ins screen. The screen lists all the required plug-ins you registered via the the Enterprise Manager 12c Upgrade Console while upgrading the Management Agents. The mandatory ones are enabled by default.
Note:
If you had missed registering some required plug-ins, then the wizard prompts you to visit the Enterprise Manager 12c Upgrade Console to register them before proceeding with the upgrade.Ensure that the software for the plug-ins listed on this screen are available in the Enterprise Manager Cloud Control software kit (DVD or downloaded software). If the software for the required plug-ins are not available, then do the following:
Manually download the plug-ins from the following URL to an accessible location:
http://www.oracle.com/technetwork/oem/grid-control/downloads/oem-upgrade-console-502238.html
Invoke the installation wizard and pass the plug-in download location:
./runInstaller -pluginLocation <absolute_path_to_plugin_software_location>
After you upgrade a Management Agent, by default, the Management Agent and the host on which you upgraded the Management Agent get automatically discovered in the Enterprise Manager Cloud Control console.
After you upgrade an OMS, by default, the following get automatically discovered in the Enterprise Manager Cloud Control console:
Oracle WebLogic Domain (for example, GCDomain)
Oracle WebLogic AdminServer
Oracle WebLogic Server
Oracle Web Tier
Application deployments, one for the Enterprise Manager Cloud Control console and one for the platform background services.
Oracle Management Service
Oracle Management Repository
Oracle Management Agent
The host on which you upgraded the OMS
However, the other targets running on that host and other hosts do not get automatically discovered and monitored. To monitor the other targets, you need to add them to Enterprise Manager Cloud Control either using the Auto Discovery Results page, the Add Targets Manually page, or the discovery wizards offered for the targets you want to monitor.
For information about discovering targets in Enterprise Manager Cloud Control, refer to the Oracle Enterprise Manager Cloud Control Administrator's Guide available in the Enterprise Manager documentation library at:
http://www.oracle.com/technetwork/indexes/documentation/index.html
After upgrading the entire Enterprise Manager system, all notification rules and alerts created in the earlier release continue to work in Enterprise Manager Cloud Control. However, note that they have been enhanced and subsumed into a larger and newer concept—Notification Rules are now called Incident Rulesets, and Alerts are now called Events in Enterprise Manager Cloud Control.
For information about Incident Rulesets and how they map to notification rules, and for information about Events and how they map to alerts, see Appendix A.
During upgrade, the alerts from the ealier release are migrated as Events in Enterprise Manager Cloud Control in the following manner. For 1-System upgrade approach, the alerts are migrated while upgrading the Management Repository. For 2-System upgrade approach, the alerts are migrated while backing up the Management Repository to the remote host.
This section covers the following:
Creating Incidents and Events for Different Types of Open Alerts
Creating Incidents and Events for Different Types of Closed Alerts
The following are the ways in which the alerts are migrated:
Table 3-1 shows how and when incidents and events are created for different types of open alerts.
All alerts that were closed 180 days prior to upgrading or backing up the Management Repository are migrated as part of the Deferred Data Migration Process. This period of 180 days can be changed by the administrator.
Table 3-2 shows how and when incidents and events are created for different types of closed alerts. Also note that if a closed alert had an associated ticket, then that information is not captured as part of the event migration.
All open statefull alerts, and open stateless alerts created within 7 days prior to upgrading or backing up the Management Repository are migrated.
Note:
In case of 2-System uprade approach, if an alert is created in the earlier release of the Enterprise Manager system after the Management Repository is backed up, then that open alert is migrated as part of the Accrued Data Migration Process (see Table 3-1). In addition, all availability records are also migrated as part of the Accrued Data Migration Process.Table 3-1 shows how and when incidents and events are created for different types of open alerts.
Table 3-1 Incidents and Events Created for Different Types of Open Alerts
| Open Alert Type | Incident Created | Event Created |
|---|---|---|
|
Critical Alert |
Yes |
Yes |
|
Warning Alert |
No |
Yes |
|
Critical Alert with Ticket |
Yes |
Yes (with Ticket) |
|
Warning Alert with Ticket |
Yes |
Yes (with Ticket) |
|
Warning Alert with Notification Pending |
Yes |
Yes |
|
Warning Alert without Notification Pending |
No |
Yes |
|
Critical Alert with Acknowledgement |
Yes |
Yes |
|
Warning Alert with Acknowledgement |
Yes |
Yes |
Table 3-2 shows how and when incidents and events are created for different types of closed alerts. Also note that if a closed alert had an associated ticket, then that information is not captured as part of the event migration.
Table 3-2 Incidents and Events Created for Different Types of Closed Alerts
| Closed Alert Type | Incident Created | Event Created |
|---|---|---|
|
Critical Alert |
No |
Yes |
|
Warning Alert |
No |
Yes |
|
Critical Alert with Ticket |
No |
Yes (without Ticket) |
|
Warning Alert with Ticket |
No |
Yes (without Ticket) |
|
Warning Alert with Notification Pending |
No |
Yes |
|
Warning Alert without Notification Pending |
No |
Yes |
|
Critical Alert with Acknowledgement |
No |
Yes |
|
Warning Alert with Acknowledgement |
No |
Yes |
For 1-System upgrade approach, jobs can run more or less as expected. During the downtime, jobs do not run, and any job that is running during the downtime is aborted or failed. In addition, all the scheduled jobs continue as they were planned.
For 2-System upgrade approach, there are some restrictions and caveats on how jobs run. Firstly, since a Management Agent is monitored only by one particular Enterprise Manager system at any point, jobs can run only in the system that monitors the Management Agent. Until a Management Agent is migrated, all jobs against targets monitored by that Management Agent are run in the old Enterprise Manager system. This also means that only one Enterprise Manager system has the true status of a job because the Management Agent communicates only with one of the systems at a given time, so only that Enterprise Manager system knows what the actual status is.
If a Management Agent is not migrated, then a future job appears as a scheduled job in the old Enterprise Manager system, but appears as a suspended job on the Management Agent unavailable in Enterprise Manager Cloud Control.
A job running in the old Enterprise Manager system at the time of the backup either aborts or fails in Enterprise Manager Cloud Control. Once the Management Agent is migrated, a future job appears as a suspended job on the Management Agent unavailable in the old Enterprise Manager system, but appears as a scheduled job in Enterprise Manager Cloud Control. If the Management Agent is subsequently removed from the old Enterprise Manager system, then that job is removed as well.
If the backup of the old Enterprise Manager system did not require a downtime, then the jobs running at the time of the backup continue to run. (If the backup required a downtime, then the job may abort due to the downtime.) Such jobs appear as aborted, failed, or skipped jobs in Enterprise Manager Cloud Control.
Repeating jobs continue to run in the old Enterprise Manager system according to their schedule. In Enterprise Manager Cloud Control, such jobs appear to be aborted, failed, or skipped. Once the Management Agent is migrated, such jobs start to run in Enterprise Manager Cloud Control. In the old Enterprise Manager system, such jobs are suspended on the Management Agent unavailable.
Jobs submitted in the old Enterprise Manager system after the backup do NOT appear in Enterprise Manager Cloud Control. Jobs submitted in Enterprise Manager Cloud Control do NOT appear in the old Enterprise Manager system. Usually, jobs are created only in the system that is currently monitoring the target.
Jobs created in the old Enterprise Manager system before the Management Agent of its targets is migrated run in the old Enterprise Manager system as expected.
Repeating jobs run until the Management Agent is migrated at which point they are stuck as suspended jobs on the Management Agent unavailable.
If jobs are created in the old Enterprise Manager system after the target is migrated, then they never run; they remain stuck as suspended jobs on the Management Agent unavailable. So do not create a job in the old Enterprise Manager system after the Management Agent is migrated.
Jobs created in Enterprise Manager Cloud Control on targets for which the Management Agent has already been migrated behave normally and run as expected.
Jobs can be created in Enterprise Manager Cloud Control before the Management Agent for its target is migrated, but they will be in suspended mode on Management Agent unavailable until the Management Agent is migrated.
This is particularly useful when a new job is created in the old Enterprise Manager system and a copy of it is desired in Enterprise Manager Cloud Control for use after the target is migrated. Usually, this will be a repeating job.
If the Management Agent is migrated before the scheduled time of the job, then the job runs in Enterprise Manager Cloud Control.
If the Management Agent is migrated after the scheduled time of the job, then the job is skipped. This is to prevent a case where the job runs on both the systems.
If the job has a repeating schedule, then the times before the migration are skipped, while the times after the migration are run.
A job with an immediate schedule does not run in Enterprise Manager Cloud Control and is eventually skipped. So do not create an immediate job on target that is not migrated.
For jobs with multiple executions, one job per target, some targets may be suspended, while others run.
Consider a job against two databases, dbA monitored by Management Agent A, and dbB monitored by Management Agent B. If only Management Agent B is migrated, then the execution for dbA is suspended, while the execution for dbB runs when it reaches its scheduled time. If this is a repeating job, then the execution for dbA is skipped. Once the Mangement Agent A is migrated, then both executions are run as usual.
This behavior is important for jobs with many targets, such as those submitted to a group. Those executions for targets monitored by the old Enterprise Manager system run in the old Enterprise Manager system, while those for targets monitored by Enterprise Manager Cloud Control run in Enterprise Manager Cloud Control. The corresponding executions on the other systems are suspended or skipped.
For jobs on multiple targets, one job for many targets, the jobs can neither run in the old Enterprise Manager system nor in Enterprise Manager Cloud Control unless the Management Agents for all the targets are migrated at one time. To determine the correct set of Management Agents to migrate at one time to address this, run the SQL queries described in Appendix C.
The alternative is to migrate the Management Agents independently, and then, once the last Management Agent is migrated, the job may run if the grace period allows it to run or if the scheduled time was after the last agent migration.
After upgrading the entire Enterprise Manager system, none of the old deployment procedure runs will be available in the upgraded Enterprise Manager. If you want to reference any of the old runtime data, then you must use the following EM CLI verb to export all of the runtime data as an XML file.
get_instance_data_xml
The following is the status of Oracle Software Library (Software Library) after the Enterprise Manager is upgraded:
For 1-System upgrade approach, the Software Library is functional the moment the Enterprise Manager is upgraded. No manual effort is required to make it functional.
For 2-System upgrade approach, the Software Library is functional only when it is reconfigured after the Enterprise Manager is upgraded.
To understand the 2-System upgrade approach workflow and to know when you must reconfigure the Software Library, see Chapter 5. For information about reconfiguring the Software Library, see Chapter 23.
For 1-System upgrade approach on a different host, the Software Library is functional the moment the Enterprise Manager is upgraded.
After upgrading the entire Enterprise Manager system, the connectors that were configured with your old Enterprise Manager system will continue to work in Enterprise Manager Cloud Control. However, the ones that were not configured will not work.
Some metrics related to the Oracle Fusion Middleware targets have been renamed in Enterprise Manager Cloud Control. In addition, a few have been introduced. The following are the targets for which the metrics have undergone some changes. For information about the metric changes, see Appendix B.
Oracle SOA Infrastructure
Oracle SOA Composite
Oracle Service Bus
Oracle WebLogic Server
JBoss Application Server
Siebel Enterprise
Siebel Server
In general, do not modify the metric thresholds after deploying and configuring the Management Agents.
You must upgrade all existing EMCLI clients of the earlier release to 12c Release 1 so that they can work with Enterprise Manager Cloud Control. This means, you must discard the old one and set up a new one.
For information about setting up a new EMCLI client, see the Enterprise Manager Command Line Interface Download page within the Cloud Control console. To access that page, in Cloud Control, from the Setup menu, select My Preferences, and then, click Command Line Interface.