How to Specify Repository Ports

From ER/Studio Data Architect
Jump to: navigation, search

Go Up to Administrator Guide

To change the ports that the server listens on you will need to add the following registry keys on the machine that the Repository Application Server is running on.

Server Side

These are the registry keys that need to be set.

On 32-bit Operating System: HKEY_LOCAL_MACHINE\SOFTWARE\Embarcadero\Repository\Database\RepoServer Port HKEY_LOCAL_MACHINE\SOFTWARE\Embarcadero\Repository\Database\RepoProbe Port

On 64-bit Operating System: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Embarcadero\Repository\Database\RepoServer Port HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Embarcadero\Repository\Database\ RepoProbe Port

These are DWORD values and you just need to enter in the port number as a decimal value. You will need to restart the services after setting the values.

Default ports:

  • Communication Port: 54333
  • Identification Port: 54332
  • SSL Port: 54331

Client Side

On the client side, in ER/Studio you can use the menu Repository > Repository Properties, change to the Server tab page and specify the ports that the client communicates on. The register value RepoServer Port mentioned before corresponds to the Communication Port listed on the server tab page. The register value RepoProbe Port corresponds to the Identification Port listed on the server tab page.

The identification port uses a UDP broadcast to identify running Repository servers that can be connected to in order to provide a list to the user (for example, the list in the Repository > Options dialog). This is optional and should not cause any issues if it is unavailable.

The communication port provides all communication between the ER/Studio client and the Repository server services, such as login requests, get diagram requests, checkout/check-in requests, event updates, and any other operations requiring information from the Repository. All communication is initiated by the client via TCP/IP. This port is required for use of the Repository, although it can be changed to a different port number if necessary.

Notepad blue icon 2.pngNote: The SSL port works like the Communications port, except all traffic is encrypted via SSL. The Repository listens on both the SSL port and the Communication port for connections. If a user chooses to use SSL in ER/Studio, then the connection will be made to the SSL port on the server rather than the Communication port for all repository operations. To enable SSL and configure the port you can use menu Repository > Repository Properties.

The registry key that stores this port number can be found on the client machine is RepoSSL Port and is under: HKEY_CURRENT_USER\Software\Embarcadero\ER/Studio Data Architect x.x\Repository

Where x.x is the version of ER/Studio Data Architect.

See Also