My Oracle Support Banner

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

Last updated on FEBRUARY 22, 2019

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.
Checked for relevance on 07-Aug-2014

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:

# EMCA Properties File

#Default Port Ranges

# Agent Port Ranges
AGENT_PORT_MIN=1830
AGENT_PORT_MAX=1849

# DB Control Agent Port assigned by IANA
AGENT_PORT_DEFAULT=3938

# DB Control Port Ranges
DBCONTROL_HTTP_PORT_MIN=5500
DBCONTROL_HTTP_PORT_MAX=5519

# DB Control Http Port assigned by IANA
DBCONTROL_HTTP_PORT_DEFAULT=1158

# RMI Port Ranges
RMI_PORT_MIN=5520
RMI_PORT_MAX=5539

# DB Control RMI Port assigned by IANA
RMI_PORT_DEFAULT=-1

# JMS Port Ranges
JMS_PORT_MIN=5540
JMS_PORT_MAX=5559

# DB Control JMSt Port assigned by IANA
JMS_PORT_DEFAULT=-1
If this is the first DB Control configured on the node, the default ports are:
DB Control HTTP port: 1158
RMI port: 5521
JMS port: 5541
DB Control Agent port: 3938

[...]


Example of portlist.ini file content:

Enterprise Manager Console HTTP Port (prodrh) = 5500
Enterprise Manager Agent Port (prodrh) = 3938
Enterprise Manager Console HTTP Port (prodmkg) = 5501
Enterprise Manager Agent Port (prodmkg) = 1830


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:

<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.

Details

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!


In this Document
Purpose
Scope
 How are determined the Ports used by the DB Control
Details
 Change the DB Control port numbers on a single node with emca in interactive mode
 Change the DB Control port numbers on a single node with emca in silent mode
 Change RAC DB Control port number with emca in interactive mode
 Change RAC DB Control port number with emca in silent mode
 Documentation
References

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.