C Redirecting Oracle Management Agent to Another Oracle Management Service

This appendix explains how to redirect or repoint your Oracle Management Agent (Management Agent), that is already communicating with an Oracle Management Service (OMS), to communicate and upload data to another OMS that is part of a different Enterprise Manager Cloud Control (Cloud Control) deployment.

Note:

When you repoint a Management Agent to another OMS that is part of a different Cloud Control deployment, you lose all the changes made to the agent instance home, such as user defined metric collections, changes made to the emd.properties file, and so on.

In particular, this appendix covers the following:

Prerequisites
Procedure

Prerequisites

Before redirecting or repointing a Management Agent, ensure that you meet the following prerequisites:

Ensure that the new OMS that you want to point the Management Agent to is of the same version as the Management Agent, or of a higher version.

To view the version of the Management Agent you want to repoint, from the Setup menu, select Manage Cloud Control, then select Agents. Click the name of the Management Agent. The Management Agent version is displayed in the Summary section.

To view the version of the new OMS, from the Setup menu, select Manage Cloud Control, then select Management Services. Click the name of the new OMS. The OMS version is displayed in the Summary section.

You can repoint the Management Agent only if the new OMS is compatible with the Management Agent. Using the Enterprise Manager certification matrix, you can view the compatibility between an OMS version and a Management Agent version. For information on accessing this matrix, refer Oracle Enterprise Manager Cloud Control Basic Installation Guide.
Ensure that the previous OMS that the Management Agent was pointing to, and the new OMS that you want to point the Management Agent to have the same set of plug-ins deployed on them, and that all the plug-ins configured on the Management Agent are deployed on the new OMS. Also, ensure that all these plug-ins deployed on the new OMS are of the same version, (that is, the version configured on the Management Agent or the previous OMS) or a higher version.

To view the list of plug-ins deployed on a particular OMS, log in to the Enterprise Manager system, from the Setup menu, select Extensibility, then select Plug-ins.

To view the list of plug-ins configured on a particular Management Agent, run the following command:

$<AGENT_INSTANCE_HOME>/bin/emctl listplugins agent -type all
Ensure that you check the contents of <AGENT_BASE_DIR>/plugins.txt. Only the plug-ins mentioned in plugins.txt will be configured on the Management Agent after you repoint it to the new OMS.
Ensure that all the patches applied on the Management Agent that change the target type or collection metadata are also applied on the new OMS that you want to point the Management Agent to.

To view all the patches applied on the Management Agent, from the Targets menu, select All Targets. Click the name of the Management Agent Oracle Home target. All the patches applied on the Management Agent are displayed in the Applied Patches section.

From the displayed list of patches, apply the required patches (the patches that change the target type or collection metadata) on the new OMS. For information on how to apply a patch on an OMS, refer the Patching Enterprise Manager chapter present in Oracle Enterprise Manager Cloud Control Administrator's Guide.
If you have applied any one-off patches on the Management Agent you want to repoint, ensure that you apply the fix for Bug 15904425 on the Management Agent and the new OMS.

Procedure

To redirect or repoint a Management Agent, follow these steps:

Run the following command to stop the Management Agent:

$<AGENT_INSTANCE_HOME>/bin/emctl stop agent
Run the following EMCLI command to delete the Management Agent target on the old OMS:

$<OMS_HOME>/bin/emcli delete_target -delete_monitored_targets -name=<name_of_agent_target> -type="oracle_emd"

For more information about the delete_target EMCLI command, refer Oracle Enterprise Manager Command Line Interface Guide.
Run the following command to remove the Management Agent instance home:

rm -rf <absolute_path_to_agent_instance_home>

If the agent base directory and the agent instance home point to the same physical location, do not run this command. Instead, remove the <AGENT_INSTANCE_HOME>/bin, <AGENT_INSTANCE_HOME>/sysman, <AGENT_INSTANCE_HOME>/diag, and <AGENT_INSTANCE_HOME>/install directories.
Run the agentDeploy.sh (agentDeploy.bat for Microsoft Windows hosts) script with the -configOnly option to create a new instance home for the Management Agent and redirect it to the new OMS:

$<AGENT_BASE_DIR>/core/12.1.0.2.0/sysman/install/agentDeploy.sh AGENT_BASE_DIR=<absolute_path_to_agent_base_dir> RESPONSE_FILE=<absolute_path_to_responsefile> -configOnly

Ensure that you pass a response file when you run the agentDeploy.sh or agentDeploy.bat scripts. The response file must contain the OMS_HOST, EM_UPLOAD_PORT, and AGENT_REGISTRATION_PASSWORD parameters. The OMS_HOST parameter must specify the new OMS host name, the EM_UPLOAD_PORT parameter must specify the upload port to be used to connect to the new OMS, and the AGENT_REGISTRATION_PASSWORD parameter must specify the password to be used for registering new Management Agents that join the Enterprise Manager system.

For more information about the parameters you can specify in the response file, refer Table 6-3. For more information about the -configOnly option, refer Table 6-6.

Note:
The specified agent base directory location and the new agent instance home location map to locations on the same host, where the Management Agent was already configured. The OMS host name, of course, maps to the other host where the new OMS is configured, that is, the OMS with which you want the Management Agent to communicate now.