Port Numbers in EntireX

This document covers the following topics:


Ensuring Unique Port Numbers

The following four port numbers must be unique for each installation of EntireX.

  • Default EntireX Broker
    • TCP/IP port

    • SSL port

  • Administration
    • TCP/IP port

  • Application Monitoring Data Collector
    • TCP/IP port

Uniqueness checks are performed during installation with the Software AG Installer. If one port in block Default EntireX Broker or Administration is in use, both ports in this block are recalculated. You can change these values as required.

Any new port number must be a positive integer greater than 1024. If you enter a port number that is already in use, an error message is displayed. All four ports must be assigned correctly before the installation can continue.

Port Number Configuration

In versions before 8.2, the default broker ID was "localhost", which implied "localhost:1971" (default port number). From version 8.2, however, the default port number can be changed during installation, and must be changed in the case of multiple installations (see Ensuring Unique Port Numbers).

The following RPC server configuration/property files in directory EntireX/config contain a default broker ID:

  • dotNetServer.cfg (Windows only)

  • cserver.cfg

  • exxatm.cfg

  • entirex.cicseci.properties

  • entirex.imsconnect.properties

  • entirex.javarpcserver.properties

  • entirex.rpcacibridge.properties

  • entirex.wmqbridge.properties

  • entirex.wmqbridgelistener.properties

  • entirex.xmlrpcserver.properties

The configuration/property files are updated automatically during installation. "BrokerID=localhost" is now "BrokerID=localhost:1971", or, for example, if port 1988 was specified during installation, "BrokerID=localhost" becomes "BrokerID=localhost:1988".

If the port numbers are changed after installation, you need to update the config/property files in the list above accordingly.

Port Numbers when Installing with Command Central

Since version 10.1 you can also install EntireX using Command Central. When installing EntireX using Command Central, no parameters can be specified. This means:

  • The number of the TCP/IP port for the Application Monitoring Data Collector is set to 57900 (same default as standard installation).

  • Free TCP and SSL ports are determined automatically by the installation. You can modify these ports after installation as described under Post-installation Configuration in section Installing EntireX using Command Central.