5/5/23, 11:14 AM Note: 2820181.

Note: 2820181.2
Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

TABLE OF CONTENTS

TABLE OF CONTENTS
EM 13.4 Upgrade
PLANNING YOUR UPGRADE
Preparing for the Upgrade
RUNNING PREREQUISITE CHECKS
Readiness Confirmation
INSTALLING SOFTWARE, PLUGINS AND PATCHES
Software Download and Binary Installation
RUNNING THE ACTUAL UPGRADE (requires down-time)
Backup, OMS Upgrade, and Agent Upgrade
POST-PGRADE TASKS
Security Certificates, Authentication Providers, and Webgate
VERSIONS AFFECTED BY FLASH
Versions Affected by Flash
BIP REMOVED IN 13.5
BIP is removed in Upgrade to 13.5
VERSION HISTORY
Version History

This document is intended to act as a Run book for Upgrading Enterprise Manager Cloud Control 13c Release 5,
and covers the different steps involved in the upgrade process along with the key aspects related to upgrade such
as what customization you must redo after the upgrade. This will help you understand the requirements and the
implications of the upgrade, and, hence, prepare for a smooth transition from the previous release.

The entire Upgrade process is divided into 5 phases:

Planning your Upgrade

Installing Software, Plugins and Patches
Running Pre-requisite Checks
Running the actual Upgrade (requires down-time)
Post-upgrade Tasks

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 1/15
5/5/23, 11:14 AM Note: 2820181.2

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

PLANNING YOUR UPGRADE

PLANNING YOUR UPGRADE

 
1. Hardware, Software, and Platform Requirements

Ensure that your system meets all the prerequisites, including the hardware requirements, listed in the chapter on installing Enterprise
Manager Cloud Control, in the Oracle Enterprise Manager Cloud Control Basic Installation Guide.

2. Supported Database Release Requirements

Ensure that the existing database is a database certified for 13c Release. See a list of certified databases in the Enterprise Manager
certification matrix available on My Oracle Support. For instructions, see Accessing the Enterprise Manager Certification Matrix.

3. Database Patch Requirements

Ensure that you apply the latest PSU to the supported database. See the following reference for information on the latest database PSU:

   Database 19c Latest PSU Information

   Note 854428.1 Patch Set Updates for Oracle Products

4. Verify certification for the target OS, target databases and other target types you are monitoring.

   Accessing the Enterprise Manager Certification Matrix

5. Captive BIP not Supported in EM 13.5

The following will be removed from the Enterprise Manager 13.5.0.0.0 Framework:

BI Publisher configuration in the Enterprise Manager Installer

BI Publisher Out of Box Reports Page in the Cloud Control Console
emctl and emcli commands that pertain to BI Publisher

These documents will elaborate the actions to be taken in this regard:

Note 2698627.1 Announcement: BI Publisher Support on Solaris, HPIA, AIX platforms, and BI Publisher Reports Page, and BI
Publisher emctl and emcli are Deprecated in Enterprise Manager Cloud Control 13.4

Note 2753983.1 EM 13c: How to export custom BI Publisher Reports and Schedules

Installing and Configuring Oracle Analytics Server with Oracle Enterprise Manager Cloud Control

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 2/15
5/5/23, 11:14 AM Note: 2820181.2

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 3/15
5/5/23, 11:14 AM Note: 2820181.2

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

RUNNING PREREQUISITE CHECKS

RUNNING PREREQUISITE CHECKS

 

1. The following prerequisite checks can be validated by running the OUI with this option: EMPREREQ_KIT=true

Optimizer Adaptive Features Disabling Requirements

EMKEY Copy Requirements
Other Database parameter checks

Note:
This step must be performed with a graphical installer session (GUI).  

./em13500_linux64.bin EMPREREQ_KIT=true

For each failed prerequisite check, refer to the following table to fix them manually:

Enterprise Manager Cloud Control 13.5

Cloud Control Basic Installation Guide
Appendix A Overview of the EM Prerequisite Kit
Repository Prerequisite Checks Run by the EM Prerequisite Kit
Table A-4 Repository Prerequisites

2. Validate other prerequisites manually:

Note 2761728.1 13.5: Checklist for Upgrading Enterprise Manager Cloud Control from Version 13.3/13.4 to 13.5

3. Update Server Load Balancer Configuration Settings

Validate that the SLB Configuration is as mentioned in the Advanced Guide referenced below:

https://docs.oracle.com/en/enterprise-manager/cloud-control/enterprise-manager-cloud-control/13.5/emadv/enterprise-manager-high-
availability.html#GUID-F45A2F2E-FE04-414E-A4F0-A33518157F82

This is very important as the SLB to OMS communication can be impacted as the Java and weblogic stack gets upgraded as part of the
Enterprise Manager Upgrade to 13.5.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 4/15
5/5/23, 11:14 AM Note: 2820181.2

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 5/15
5/5/23, 11:14 AM Note: 2820181.2

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

INSTALLING SOFTWARE, PLUGINS AND PATCHES

INSTALLING SOFTWARE, PLUGINS AND PATCHES

 

1. Download Software and Plug-ins

   https://www.oracle.com/enterprise-manager/downloads/cloud-control-downloads.html

2. Download Add-on Plug-ins

  https://www.oracle.com/enterprise-manager/downloads/oem-v135-update-plugins-downloads.html

If you have any of the Plug-ins listed in the table below, download them from the link above and stage them on the OMS host:

Add-on Plug-in Sources

Download Plug-in Description
13.5.1.1.0_oracle.apps.psft_2000_0.opar Enterprise Manager Plug-in for Peoplesoft
13.4.3.0.0_oracle.dba.odba_2000_0.opar Enterprise Manager Plug-in for Oracle Database Appliance
13.4.3.0.0_oracle.db.ott_2000_0.opar Enterprise Manager Plug-in for TimesTen
13.4.2.0.0_oracle.fmw.gg_2000_0.opar Enterprise Manager Plug-in for Oracle GoldenGate
13.4.1.0.0_oracle.oud.odir_2000_0.opar Enterprise Manager for Oracle Unified Directory
13.4.1.0.0_oracle.tugbu.outy_2000_0.opar Enterprise Manager for Utilities (TUGBU)
13.4.1.0.0_oracle.fmw.txdo_2000_0.opar Enterprise Manager Plug-in for Tuxedo

 
3. Download Partner-Built Integration Plug-ins

   https://apexapps.oracle.com/pls/apex/f?p=138:1:116213409263153:::::

If you have any of the Plug-ins listed in the table below, download them from the link above and stage them on the OMS host:

Partner Built Plug-in Sources

Plug-in Description
Centralized visibility of mongoDB database environments, giving administrators a single
SSL Certificate
view on component availability and performance at both a database and estate level
Centralized visibility of NGINX environments, giving administrators a single view of
REDIS Data Store
component availability and performance at a target and estate level
Centralized visibility of REDIS environments, giving administrators a single view of
HBase
component availability and performance at a target and estate level
Centralized visibility of SSL certificates, giving administrators a single view of certificate
mongoDB
availability and configuration at a target and estate level
NGINX  

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 6/15
5/5/23, 11:14 AM Note: 2820181.2

PostgreSQL Enterprise Manager plug-in for Pure Storage Flash Arrays

Fujitsu SPARC Extends the native database monitoring capabilities of Oracle Enterprise Manager to
M12/M10 PostgreSQL database environments
MySQL Integrated view of the Hitachi storage infrastructure for Oracle databases
Pure Storage Flash Monitor MySQL targets in the same way Oracle Databases are monitored (available at the
Array Pythian website)
Hitachi Storage The SPARC M12/M10 plug-in for Oracle Enterprise Manager Cloud Control provides
Adaptor monitoring functionality for SPARC M12/M10 server hardware

4. Invoke the Enterprise Manager Cloud Control Installer for Installing Only the Software Binaries in GUI Mode Along with
Plug-ins

Note:
As described, this step must be performed with a graphical installer session (GUI). 
This method is preferable to the silent option due to its simplicity.

The silent option, if required, is described here:

https://docs.oracle.com/en/enterprise-manager/cloud-control/enterprise-manager-cloud-control/13.5/emupg/editing-response-file-
upgrading-oracle-management-service-and-oracle-management-repository-silent-mo.html#GUID-F50C9FB2-D4C9-4294-B9BB-
AE7FF4C069FB

./em13500_<platform>.bin  PLUGIN_LOCATION=<absolute_path_to_plugin_software_location> [-invPtrLoc

<absolute_path_to_oraInst.loc>]

 
The installer requires about 14 GB of hard disk space in the temporary directory. If your temporary directory does not have this space,
then pass the -J-Djava.io.tmpdir parameter and provide an alternative directory where there is 14 GB of space.

If you are upgrading a multi-OMS setup, on each additional OMS instances, run the following:

./em13500_<platform>.bin -invPtrLoc <absolute_path_to_oraInst.loc_Inventory Pointer_File> PLUGIN_LOCATION=

<absolute_path_to_plugin_software_location>  PARALLEL_ADD_OMS_UPG=true

      

5. Run the allroot.sh Script

$<ORACLE_HOME>/allroot.sh

6. Obtain the latest versions of the key EM 13.5 patching utilities to allow sucessful patching:

  a)  Note 2728285.1 13.5: How to Upgrade OPatch to 13.9.4.2.7 on the OMS

  b)  Note 2809842.1 13.5: How To Upgrade Enterprise Manager 13.5 Cloud Control OMSPatcher Utility to Version 13.9.5.0.0

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 7/15
5/5/23, 11:14 AM Note: 2820181.2

7. Apply the Release Update in Bit Only Mode

Note 2810169.1 13.5: How to Apply Release Update on the OMS During the Install/Upgrade

Oracle® Enterprise Manager 13c Release 5 Update 1 (13.5.0.1) for Oracle Management Service

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 8/15
5/5/23, 11:14 AM Note: 2820181.2

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

RUNNING THE ACTUAL UPGRADE (requires down-time)

RUNNING THE ACTUAL UPGRADE (requires down time)

 

A. Ensure that you back up the OMS (the middleware home and the inventory), Oracle Management Repository,
and Oracle Software Library. The restoration requires Instance home (gc_inst) backup. In case the upgrade fails,
you can always restore using the backup. For instructions to back up, refer to Oracle Enterprise Manager Cloud
Control Administrator's Guide.

B. Stop the Agent running on primary OMS as well as on repository database host. In case of RAC repository,
stop the Agent on all instances.

C. Shut down the OMS you are about to upgrade and also the other OMS instances that connect to it.

D. Invoke the Enterprise Manager Cloud Control Installer for Configuring the Software Binaries in GUI Mode
by running the following script from the 13.5 Oracle home of the OMS:

$<ORACLE_HOME>/sysman/install/ConfigureGC.sh [-invPtrLoc <absolute_path_to_oraInst.loc>]

E. Monitor the Upgrade Progress

F. Perform Additional OMS Upgrades in Parallel

   For UNIX environment, run: <ORACLE_HOME>/sysman/install/ConfigureGC.sh

   For Windows environment, run: <ORACLE_HOME>/sysman/install/ConfigureGC.bat

G. Upgrade Central Agents or Standalone Management Agents to 13c Release 5 Using the Agent Upgrade
Console.

   From the Setup menu, select Manage Cloud Control, then select Upgrade Agents.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 9/15
5/5/23, 11:14 AM Note: 2820181.2

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

POST-PGRADE TASKS

POST-UPGRADE TASKS

Common Required Actions after Upgrade to EM 13.5

1. Custom Certificates Status When Upgrading to Enterprise Manager Cloud Control 13c Release 5

When you upgrade to 13c Release 5, all custom certificates configured for the upload and console ports of the
OMS must be reconfigured after the OMS upgrade.

If custom certificates were configured for Oracle WebLogic Servers (admin server as well as managed servers),
then after upgrading to 13c Release 5, the custom certificates are not carried over. Instead, the Oracle WebLogic
Servers are configured with demo certificates. Therefore, after upgrading, make sure you reconfigure the Oracle
WebLogic Servers with custom certificates.

2. Reconfiguring External Authentication Providers Used with Enterprise Manager

If Enterprise Manager is authenticated with any external authentication provider or single sign-on solutions
(SSO), then, after upgrading to Enterprise Manager Cloud Control 13c Release 5, the external authentication
provider or SSO must be configured again.

3. Status of Webgate When Upgrading to Enterprise Manager Cloud Control 13c Release 5

If you have Webgate configured in your Oracle Enterprise Manager 13c Release 3 then upgrading to Oracle
Enterprise Manager 13c Release  will not configure Webgate automatically. For instructions about reconfiguring
after completing the upgrade process, see Reconfiguring Oracle HTTP Server Webgate.

4. Update the SLB Configuration in a Multiple OMS EM System

In the upgrade of a multiple-OMS EM 13.5 system, the SLB connection must be updated to preserve
communication with existing EM Agents. See the following reference for these details:

Enterprise Manager Cloud Control 13.5

Cloud Control Advanced Installation and Configuration Guide
Chapter 23 Enterprise Manager High Availability
Section: Configuring Multiple Management Services Behind a Server Load Balancer (SLB)

5. For the NFS-Mounted OMS Installation

If your OMS Instance Home is on an NFS File-system, follow the steps in the following document to put the
locks file on a local file-system:

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 10/15
5/5/23, 11:14 AM Note: 2820181.2

Note 2117861.1 EM 13c: OMS takes Long Time to Start, Console Access is Slow and Webtier Crashes
Frequently When OMS is Installed on a Shared Location

6. General Post-Upgrade Concerns

See the following information for other actions you may wish to take after upgrade to EM 13.5:

Enterprise Manager Cloud Control 13.5

Cloud Control Upgrade Guide
Chapter 8 Postupgrade Tasks After Upgrading to Enterprise Manager Cloud Control 13c Release 5

 
7. Installing and Configuring Oracle Analytics Server with Oracle Enterprise Manager Cloud Control

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 11/15
5/5/23, 11:14 AM Note: 2820181.2

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

VERSIONS AFFECTED BY FLASH

Here is the list of EM pages which are Adobe Flash dependent, by EM version:

EM 13.3.1 (supported though January 2021):

Performance Page (SI & RAC)

Performance Home
Top consumers (SI & RAC)
Top Activity Page (SI & RAC)
Top Activity
ASH Analytics Page
ASH Analytic
SQL Monitoring Page
SQL Monitoring
SQL Details Page
SQL details page - Activity, Plan, and SQL Monitoring Tabs
Session Details Page
Session details - Activity and SQL Monitoring Tabs
AWR Pages
Emergency Performance Page
Real- Time ADDM
Real-time ADDM
Advisor Central --> ADDM Page
Cluster cache coherency page
Cluster Cache Coherency
Cluster cache coherency page --> Average Current Block Receive Time By Instance Page
Cluster cache coherency page --> Average Current Block Transfer Rate Page
Cluster cache coherency page --> Active Session History Page
Database Replay
RAC Drilldowns
RAC Cluster Cache Coherency
Database Throughput by Instance (RAC Only)
Latency for Synchronous Single Block Reads by Instance (RAC Only)
I/O Megabytes per Second By Instance For I/O Function (RAC Only)
Parallel Execution by Instance (RAC Only)
Real-time SQL Monitoring
Service Activity from Top Consumers

EM 13.3.2 (PG):

RAC Historical Drilldowns

RAC Cluster Cache Coherency
Database Throughput by Instance (RAC Only)
Latency for Synchronous Single Block Reads by Instance (RAC Only)
I/O Megabytes per Second By Instance For I/O Function (RAC Only)
Parallel Execution by Instance (RAC Only)

EM 13.4 through RU6:

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 12/15
5/5/23, 11:14 AM Note: 2820181.2

RAC Historical drill downs

RAC Cluster Cache Coherency
Database Throughput by Instance (RAC Only)
Latency for Synchronous Single Block Reads by Instance (RAC Only)
I/O Megabytes per Second By Instance For I/O Function (RAC Only)
Parallel Execution by Instance (RAC Only)

EM 13.4 RU7: All Flash pages removed

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 13/15
5/5/23, 11:14 AM Note: 2820181.2

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

BIP REMOVED IN 13.5

ATTENTION

1) The following will be removed from the Enterprise Manager 13.5.0.0.0 Framework:

BI Publisher configuration in the Enterprise Manager Installer

BI Publisher Out of Box Reports Page in the Cloud Control Console
emctl and emcli commands that pertain to BI Publisher

    The following documents will elaborate the actions to be taken in this regard:

Note 2698627.1 Announcement: BI Publisher Support on Solaris, HPIA, AIX platforms, and BI Publisher
Reports Page, and BI Publisher emctl and emcli are Deprecated in Enterprise Manager Cloud Control 13.4

Note 2753983.1 EM 13c: How to export custom BI Publisher Reports and Schedules

Installing and Configuring Oracle Analytics Server with Oracle Enterprise Manager Cloud Control

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 14/15
5/5/23, 11:14 AM Note: 2820181.2

Copyright (c) 2023, Oracle. All rights reserved. Oracle Confidential.

VERSION HISTORY

Version History
Date Author Change Summary
 12/12/2020  d.eschliman  Versin history page added
     
     
     
     
     
     
     
     

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8a0vifyfw_119&id=2820181.2 15/15