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 a different OMS that is part of a different Enterprise Manager Cloud Control (Cloud Control) deployment.
Redirecting Management Agents to a different OMS that is part of a different Cloud Control deployment is supported only for Management Agents that were deployed fresh, and were not upgraded from an earlier version. You cannot redirect a Management Agent that was upgraded from an earlier version.
When you redirect a Management Agent to a different 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:
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
$AGENT_HOME/perl/bin/perl $AGENT_HOME/sysman/install/create_plugin_list.pl -instancehome <AGENT_INSTANCE_HOME>
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.
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 EM CLI 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_BASE_DIR>/core/220.127.116.11.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.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.
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.