Identifying Which Directory Server to Use

More than one Directory Server may be installed for your organization. This document describes how Software AG products determine which Directory Server to use.

The Directory Server implementation diagram is shown below.

graphics/dsid.png

Software AG products obtain the address of the Directory Server by searching the following sources in the specified order:

  1. The environment variable xtsdsurl. For example,

    set xtsdsurl=tcpip://dshost:port

  2. An xtsdsurl parameter passed by an application call.

  3. The well-known names SAGXTSDShost and SAGXTSDSport.

    Port "4952" is used if the well-known name SAGXTSDSport is not defined.

    The well-known names can be defined to a DNS server or as an alternative they can be defined in a local "hosts" file. Use of the local "hosts" file implies manual reconfiguration should the Directory Server host change, but it has the advantage of supporting different Directory Servers per computer. Using xtsdsurl has the advantage of using different Directory Servers per process.

    The following table defines the well known names, their purpose, and encoding requirements.

    Name Purpose
    SAGXTSDShost Specifies the IP address of the Directory Server.
    SAGXTSDSport

    Specifies, through an encoded IP address, the listen port of the Directory Server. The encoded IP address is in the following format:

    nnnn.mmmm.0.0

    ""where:

    nnnn = port / 256

    mmmm = port % 256 (256 modulus)

    The default port is "4952", therefore the encoded default port is "19.88.0.0" .