To Change agent port in Oracle Enterprise Manager Cloud Control 12C

Agent port is an integral part of Agent target name and EMD_URL property of Agent's monitored targets in Repository tables. Every port change would lead to duplicate targets in Repository and would need manual corrections.

Agent port change is one of the least frequent operations one would do. Using emctl set property can change  EMD_URL property value however Display name remain the same (old name)
But can see the new EMD_URL value with new Portnumber:

Steps to change agent port

$/u03/agent_12c/core/12.1.0.2.0/bin/emctl stop agent  

2. Set  EMD_URL property

$/u03/agent_12c/core/12.1.0.2.0/bin/emctl setproperty agent -name EMD_URL -value https://oracleDBlinux.domain.com:3870/emd/main/
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
EMD setproperty succeeded

3. Verify the properties and targets.xml file

$ grep EMD_URL  /u03/agent_12c/core/12.1.0.2.0/sysman/config/emd.properties
EMD_URL=https://oracleDBlinux.domain.com:3870/emd/main/


Verify modified the EMD_URL value in targets.xml

$ grep -i 'oracle_emd' /u03/agent_12c/core/12.1.0.2.0/sysman/emd/targets.xml
        <Target TYPE="oracle_emd" NAME="oracleDBlinux.domain.com:3870" DISPLAY_NAME="oracleDBlinux.domain.com:3870" ON_HOST="" EMD_URL="https://oracleDBlinux.domain.com:3870/emd/main/" TIMEZONE_REGION="" IDENTIFIER="TARGET_GUID=3472BF9E47A45FGGRGD47AA90073F387"/>

Taregts.xml is not yet modified  



4. Start agent

$/u03/agent_12c/core/12.1.0.2.0/bin/emctl start agent
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
Starting agent ................... started.

$/u03/agent_12c/core/12.1.0.2.0/bin/emctl status agent
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
---------------------------------------------------------------
Agent Version     : 12.1.0.2.0
OMS Version       : 12.1.0.2.0
Protocol Version  : 12.1.0.1.0
Agent Home        : /u03/agent_12c/agent_inst
Agent Binaries    : /u03/agent_12c/core/12.1.0.2.0/
Agent Process ID  : 8734
Parent Process ID : 8645
Agent URL         : https://oracleDBlinux.domain.com:3870/emd/main/
Repository URL    : https://oracleEM_OMS.domain.com:4902/empbs/upload
Started at        : 2013-06-21 13:49:44
Started by user   : oracle
Last Reload       : (none)
Last successful upload                       : 2013-06-21 13:49:55
Last attempted upload                        : 2013-06-21 13:49:55
Total Megabytes of XML files uploaded so far : 0
Number of XML files pending upload           : 1
Size of XML files pending upload(MB)         : 0
Available disk space on upload filesystem    : 96.32%
Collection Status                            : Collections enabled
Heartbeat Status                             : Ok
Last attempted heartbeat to OMS              : 2013-06-21 13:49:54
Last successful heartbeat to OMS             : 2013-06-21 13:49:54
Next scheduled heartbeat to OMS              : 2013-06-21 13:50:54

---------------------------------------------------------------
Agent mis Running and Ready

5. Verify the new port number in EMD_URL property

$/u03/agent_12c/core/12.1.0.2.0/bin/emctl getproperty agent -name EMD_URL
Oracle Enterprise Manager Cloud Control 12c Release 2
Copyright (c) 1996, 2012 Oracle Corporation.  All rights reserved.
EMD_URL=https://oracleDBlinux.domain.com:3870/emd/main/

 On Console Agent Display name will be shown with old name and EMD_URL will be shown with new port#

Editing targets.xml file

Strictly not recommended to edit the targets.xml file. This may block agent or impact agent functionality or agent would become outof sync with repository or upload failure