How to Change the Database Control (DB Control) Port Number (Doc ID 395755.1)

Last updated on AUGUST 19, 2022

Applies to:

Enterprise Manager Base Platform - Version 10.2.0.2 to 11.2.0.2 [Release 10.2 to 11.2]
Enterprise Manager for Oracle Database - Version 10.2.0.2 to 11.2.0.2 [Release 10.2 to 11.2]
Information in this document applies to any platform.

Purpose

This bulletin explains how to change ports using emca for DB Control 10.2.x.x and 11.x.x.x.

Scope

How are determined the Ports used by the DB Control

When the DB Control is initially configured with emca, it uses a set of default system ports.

EMCA reads the default ports from the file emca.properties located in the Oracle Database $ORACLE_HOME/sysman/config directory.
EMCA checks the file $ORACLE_HOME/install/portlist.ini file to determine if other DB Control have already been configured on the host and which ports are used.
EMCA updates the file $ORACLE_HOME/install/portlist.ini each time a new DB Control is configured on the host.
If you have several DB Control configured on a node, the DB Control HTTP and Agent ports are stored in the same file portlist.ini.

Example of content of the emca.properties file for a 11.2.0.2 Oracle Database:

It is possible to change the default ports and the system range ports that emca will use to create the DB Control by updating the file $ORACLE_HOME/sysman/config.emca.properties file.
<Document 1074067.1> - How to Change the Database Control (DB Control) Default Port Range

It is possible to change the ports used by EMCA at the DB Control creation time by specifying the port value with the parameters:

-DBCONTROL_HTTP_PORT <port_number>
-RMI_PORT <port_number>
-JMS_PORT <port_number>
-AGENT_PORT <port_number>

<Document 330130.1> Overview Of The EMCA Commands Available for DB Control 10.2 Installations

It is possible to change one, some or all four port numbers through one emca command-line once the DB Control has been configured without having to recreate the DB Control.

This is covered in the current document.