The Directory Server Port Number

Software AG has registered port number 4952 with the Internet Assigned Numbers Authority (IANA) for use by the Directory Server. You are not required to use this port number for the Directory Server and can change it. However, use of this IANA port number for the Directory Server, when specified also as the Directory Server port expected by applications can eliminate Directory Server port number confusion. Software AG therefore recommends using the new IANA port 4952.

During Directory Server installation, the port number is usually assigned dynamically. If an existing Directory Server exists and is being upgraded, the Directory Server installation will use the port number of the existing installation. On Windows systems, if a new Directory Server is being installed, the default port number 4952 is used. On UNIX systems, if a new Directory Server is being installed, you are prompted for the port number. Note that in all cases, you can modify the port number used by Directory Server by running the Directory Server installation and modifying it there.

Effective with Version 5.2.1.1 of the Directory Server, you can no longer specify the Directory Server port as "0" (zero). However, if you have older installations of Directory Server that use port 0, it is still supported, but it defaults to 4952. Software AG strongly recommends that you change any older installations of Directory Server to specify a non-zero port number, as opposed to using port 0. In addition, if you have specified the Directory Server port number in the xtsdsurl environment variable or parameter settings or in the SAGXTSDSport environment variable or DNS settings, Software AG strongly recommends setting these to non-zero port numbers, as well.

When Directory Server 5.2.1.0 was released (with products such as Entire Net-Work 7.3.1 and Entire Net-Work Client 1.2.1), Directory Server ports set to "0" defaulted to the new IANA port number, 4952. This caused some problems with existing applications that expected port 0 to default to 4952. As a result of these problems, in Software AG Directory Server 5.2.1.1 the default for port 0 has been changed back to 4952, shipment of Directory Server 5.2.1.0 has been discontinued, and new Directory Server installations can no longer use port 0. If you upgrade Software AG products that used Directory Server 5.2.1.0 (such as Entire Net-Work 7.3.1 and Entire Net-Work Client 1.2.1) to newer versions of their software, be aware that the upgrade (or reinstallation) to Directory Server 5.2.1.1 will inherit any port 0 settings from the prior release. In these cases, you will need to manually modify the Directory Server port number to a valid non-zero port number after the upgrade (or reinstallation), as described in Modifying a Directory Server Link Definition .

Changing the Directory Server Port Number

Start of instruction setIf you need to change the Directory Server port number, follow the general procedure described in these steps:

  1. Within the settings for your application, change all specifications for the Directory Server port number to the new port number you want to use.

  2. Shut down your application or application services or daemons.

  3. Shut down the Directory Server service or daemon.

  4. Modify the Directory Server installation, as appropriate for the operating system, changing the Directory Server port number to the new port number you want to use when prompted.

  5. Start up the Directory Server service or daemon, if it is not automatically started after its installation was modified.

  6. Start up your application or application services or daemons.