E Managing Oracle Database Port Numbers

E.1 About Managing Ports

During installation, Oracle Universal Installer assigns port numbers to components from a set of default port numbers. Many Oracle Database components and services use ports. As an administrator, it is important to know the port numbers used by these services, and to ensure that the same port number is not used by two services on your host.

Most port numbers are assigned during installation. Every component and service has an allotted port range, which is the set of port numbers Oracle Database attempts to use when assigning a port. Oracle Database starts with the lowest number in the range and performs the following checks:

• Is the port used by another Oracle Database installation on the host?

  The installation may be up or down at the time; Oracle Database can still detect if the port is used.

• Is the port used by a process that is currently running?

  This could be any process on the host, even a non-Oracle Database process.

If the answer to any of the preceding questions is yes, Oracle Database moves to the next highest port in the allotted port range, and continues checking until it finds a free port.

E.2 Viewing Port Numbers and Access URLS

In most cases, the port number of the Oracle Database component is listed in the tool used to configure the port. In addition, ports for some Oracle Database applications are listed in the portlist.ini file. This file is located in the ORACLE_HOME\install directory.

If you change a port number, it is not updated in the portlist.ini file, so you can only rely on this file immediately after installation. To find or change a port number, use the methods described in this appendix.

E.3 Port Numbers and Protocols of Oracle Components

Table E-1 lists the port numbers and protocols used by components that are configured during the installation. By default, the first port in the range is assigned to the component, if it is available.

E.4 Changing the Oracle Enterprise Management Agent Port

To find the current setting for the Oracle Management Agent port, search for EMD_URL in the ORACLE_HOME\host_sid\sysman\config\emd.properties file.

To change the Oracle Management Agent HTTP port, use the emca -reconfig ports command:

emca -reconfig ports -AGENT_PORT 1831

E.5 Changing the Oracle Enterprise Manager Database Control Ports

To find the current HTTP, RMI, and JMS port settings, search in the following files:

• HTTP port: Search for REPOSITORY_URL in the ORACLE_HOME\host_sid\sysman\config\emd.properties file.

• RMI port: Search for the port attribute in the rmi-server tag in the ORACLE_HOME\oc4j\j2ee\OC4J_DBConsole_host_sid\config\rmi.xml file.

• JMS port: Search for the port attribute in the jms-server tag in the ORACLE_HOME\oc4j\j2ee\OC4J_DBConsole_host_sid\config\jms.xml file.

To change the Oracle Enterprise Manager Database Control ports, use the emca -reconfig ports command:

ORACLE_HOME\bin> emca -reconfig ports option setting

where option can be:

• DBCONTROL_HTTP_PORT: Sets the HTTP port, for example:

  emca -reconfig ports -DBCONTROL_HTTP_PORT 1820
  

• RMI_PORT: Sets the RMI port, for example:

  emca -reconfig ports -RMI_PORT 5520
  

• JMS_PORT: Sets the JMS port, for example:

  emca -reconfig ports -JMS_PORT 5521
  

You can enter multiple -reconfig port settings in one line, for example:

emca -reconfig ports -DBCONTROL_HTTP_PORT 1820 -AGENT_PORT 1821 -RMI_PORT 5520

E.6 Changing the Oracle XML DB Ports

To change the Oracle XML DB FTP and HTTP ports, you must run the catxdbdbca.sql script, which in a default installation is located in ORACLE_HOME\rdbms\admin.

To change the Oracle XML DB ports:

1. Check that the Oracle listener is running. To do so, in the Windows Services utility, ensure that the Oracle TNS Listener service (for example, OracleOraDb11g_home1TNSListener) is set to Started.

   If you cannot start the listener, see Oracle Database Net Services Administrator's Guide.

2. Log in to SQL*Plus as SYS or XDB using the SYSDBA role.

   For example, to log in to SQL*Plus as SYS using the password password:

   DRIVE_LETTER:\sqlplus /nolog
   SQL> CONNECT SYS AS SYSDBA
   Enter password: password
   

3. Run the catxdbdbca.sql script.

   For example, to use 2200 for the FTP port and 8200 for the HTTP port, and assuming your Oracle home is in the following location, enter the following command:

   SQL> @C:\app\username\product\11.2.0\dbhome_1\rdbms\admin\catxdbdbca.sql 2200 8200
   

4. Exit SQL*Plus.

E.7 Changing the Oracle Services for Microsoft Transaction Server Port

In most cases, you are not required to reconfigure the port number. If you must, then you can edit its value in the HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\OracleMTSRecoveryService\Protid_0 Registry Editor key.

If you are doing a silent install, then the default port is 2030. A default port number automatically appears in the port number field when using Oracle Universal Installer. The value displayed is taken from the registry if it exists, otherwise a free port ranging from 49152 to 65535 is chosen.