Patch for Bug # 28373706
Platform: Generic
Released: August 31, 2018.
This document describes the following:
The previous bundle number is 28216294.
The additional bugs fixed by this patch are as follows:
28373706: EM-AGENT Bundle Patch 13.2.0.0.180831
27838774: Host logical memory usage metric is EM has wrong value
28353025: signoff_agents job deleted whole agent base directory
28189153: OPC: CDC2 - Agent Upgrade blackout not ending post BP18 upgrade
28072161: Support num occurrences before target is declared to be in MCE
27912409: Agent Restart Issue
27144188: Host Refresh Configuration job failing with timeout waiting for postload
21512882: Fresh agent install using agent push to honor SCRATCHPATH from additional param
|
Note: Apply patch for 27612395 and 27994582 on the OMS side before you apply this patch. |
To apply an Management Agent patch, follow these steps:
In Cloud Control, from the Enterprise menu, select Patching and Provisioning, and then click Patches and Updates.
On the Patches and Updates page, in the Patch Search Region, enter the 28373706 available in the ReadMe, and click Search.
Select the patch, and from the context menu click Add to a Plan, and select Add to New.
In the Add Patch to Plan dialog box, enter a unique name for the plan, and click the search icon to view the list of targets reporting to the OMS running on your host. From the list, select the Management Agent targets (or group of targets) that need to be patched. Ensure that you add at least one target of type agent, and then click Create Plan.
On the Patches and Updates page, in the Plans region, click the Patch Plan you created in the previous step. Alternatively, select the Patch Plan, and from the context menu, click View.
In the Create Plan wizard, on the Plan Information page, in the Overview section, validate the Patch Plan name. You can choose to edit it if you want.
(Optional) Select a date and time when you want to deploy the Patch Plan, and enter a short description to describe the Patch Plan.
Click Next.
On the Patches page, review the patches added to the Patch Plan.
Click Next.
In the Deployment Options page, do the following:
In the Where to Stage section, retain the default location (%emd_emstagedir%) available on the target machine, or edit the Stage Location to provide a new location for staging the Management Agent patches.
In the Oracle Home Credentials section, select Oracle Home Preferred Credentials if you have already set them earlier. You can otherwise click Override Oracle Home Preferred Credentials to set the Normal Oracle Home Credentials and Privileged Oracle Home Credentials, to access the Oracle home of the target.
Click Next.
On the Validation page, click Analyze to check for conflicts. If there are conflicts, then review the issues, and resolve it according to the corresponding solutions available on the page. After resolving the issue, click Re-Analyze.
Click Next.
On the Review & Deploy page, review the details you have provided for the patch plan, then click Deploy.
To deinstall Management Agent patches, follow these steps:
In Cloud Control, from the Enterprise menu, select Patching and Provisioning, and then click Patches and Updates.
On the Patches and Updates page, in the Patch Search Region, enter 28373706, and click Search.
Select the patch, and from the context menu click Add to a Plan, and select Add to New.
In the Add Patch to Plan dialog box, enter a unique name for the plan, and click the search icon to view the list of targets reporting to the OMS running on your host. From the list, select the Management Agent targets (or group of targets) that need to be patched. Ensure that you add at least one target of type agent, and then click Create Plan.
On the Patches and Updates page, in the Plans region, click the Patch Plan you created in the previous step. Alternatively, select the Patch Plan, and from the context menu, click View.
In the Create Plan wizard, on the Plan Information page, in the Overview section, validate the Patch Plan name. You can choose to edit it if you want.
(Optional) Select a date and time when you want to deploy the Patch Plan, and enter a short description to describe the Patch Plan.
Click Next.
On the Patches page, review the patches added to the Patch Plan.
Click Next.
In the Deployment Options page, do the following:
In the Where to Stage section, retain the default location (%emd_emstagedir%) available on the target machine, or edit the Stage Location to provide a new location for staging the Management Agent patches. The Management Agent patches are required to be staged even for deinstallation because the Patch Plan runs certain prerequisite checks that are available only within the staged Management Agent patches.
In the Oracle Home Credentials section, select Oracle Home Preferred Credentials if you have already set them earlier. You can otherwise click Override Oracle Home Preferred Credentials to set the Normal Oracle Home Credentials and Privileged Oracle Home Credentials, to access the Oracle home of the target.
In the Rollback section, select Plan deployment rolls back the patches in this plan.
Click Next.
On the Validation page, click Analyze to check for conflicts. If there are conflicts, then review the issues, and resolve it according to the corresponding solutions available on the page. After resolving the issue, click Re-Analyze.
Click Next.
On the Review & Deploy page, review the details you have provided for the patch plan, then click Deploy.
The Appendix covers the following:
Before you apply or deinstall Management Agent patches manually, ensure that you meet the following requirements:
Ensure that the Oracle Management Agent (Management Agent) on which you are installing the patch or from which you are rolling back the patch is Oracle Management Agent 13c Release 2 (13.2.0.0.0).
Ensure that you have the latest version of OPatch.
If you do not have the latest version, then follow the instructions outlined in the My Oracle Support note 224346.1 available at:
https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=224346.1
Ensure that you set the ORACLE_HOME environment variable to Management Agent core home as follows:
For standalone agent: <%installation_base_directory%>/agent_13.2.0.0.0
For an Management Agent that ships with the OMS: <%middleware_home%>/agent/agent_13.2.0.0.0
Ensure that you set the PATH environment variable to include the location of the unzip executable, and the <ORACLE_HOME>/bin and the <ORACLE_HOME>/OPatch directories present in the Oracle home of the Management Agent.
Verify the Oracle Inventory because OPatch accesses it to install the patches. To verify the inventory, run the following command. If the command displays some errors, then contact Oracle Support and resolve the issue.
$ opatch lsinventory
Shut down the Management Agent by running the following command:
$ emctl stop agent
|
Note: If the Management Agent is installed on a cluster, then ensure that you shut down the Management Agents on the nodes on which you want to apply the patch. |
To apply patches manually, follow these steps:
Run the following command to stop the Management Agent:
$ $ORACLE_HOME/bin/emctl stop agent
Maintain a location for storing the contents of the patch ZIP file.
In the rest of the document, this location (absolute path) is referred
to as <PATCH_TOP_DIR>.
Extract the contents of the patch ZIP file to the location you created in Step (1). To do so, run the following command:
$ unzip -d <PATCH_TOP_DIR> p28373706_132000_Generic.zip
Navigate to the <PATCH_TOP_DIR>/28373706 directory:
$ cd <PATCH_TOP_DIR>/28373706
Run the following commands to install the patch.
$ORACLE_HOME/OPatch/opatch napply
Start the Management Agent by running the following command:
$ $ORACLE_HOME/bin/emctl start agent
|
Note: If the Management Agent is installed on a cluster, then ensure that you start the Management Agent on all the nodes of the cluster. |
To deinstall patches manually, follow these steps:
Navigate to the following location within the Oracle home of the Management Agent, and run the command to stop the Management Agent:
$ $ORACLE_HOME/bin/emctl stop agent
|
Note: If the Management Agent is installed on a cluster, then ensure that you stop the Management Agent on all the nodes of the cluster. |
Deinstall the patch by running the following command:
$ORACLE_HOME/OPatch/opatch nrollback -id 28373706,25610702
Navigate to the following location within the instance home of the Management Agent, and run the command to start the Management Agent:
$ $ORACLE_HOME/bin/emctl start agent
|
Note: If the Management Agent is installed on a cluster, then ensure that you start the Management Agent on all the nodes of the cluster. |