Most configuration specifications for Directory Server can be made using SMH. Manual configuration of the Directory Server might be required is a configuration is lost or corrupted. Under normal circumstances, manual configuration is not required.
If you need to perform manual configuration of the Directory Server, please contact Software AG Customer Support for assistance.
This document covers the following topics:
To manually configure the Directory Server:
Position to the Software AG Directory Server installation directory.
Set the Directory Server parameters.
Register the Directory Server service.
Start the Directory Server service.
Confirm the configuration.
Refer to the following sections (Example Commands (Windows) and Example Commands (UNIX) for examples of each of these steps.
Note in the following commands "x:" is used to indicate the drive where the Software AG Directory Server has been installed. This would normally be the "C" drive. Substitute the installation's actual value before issuing the commands. From a Windows command prompt window, issue the following commands:
| Activity | Example Command |
|---|---|
| Position to the Software AG Directory Server installation directory. | cd x:\Program Files\Software AG\Directory
Server |
| Set the Directory Server parameters. | xtsdssvc -name XTSDIR -port 0 -directory
INIDIR -dirparms "file=c:\Documents and Settings\All Users\Application
Data\Software AG\xtsurl.cfg" -logdir "c:\Document and Settings\All
Users\Application Data\Software AG" -trace 0 -debug 0 |
| Register the Directory Server service. | xtsdssvc -register |
| Start the Directory Server service. | xtsdssvc -start |
| Confirm the configuration. | xtsdssvc -status |
Once the Directory Server is registered it will be automatically started at boot time. The Windows Services control panel application can be used to confirm the automatic start setting. Navigate the following program items to get to the services control panel applet: . The Software AG Directory Server service is listed as .
This section covers the following topics:
Setting the port parameter to
"0" indicates that the actual port to be used is
determined by the DNS resolution of SAGXTSDSport. If
SAGXTSDSport is not resolved, then port
"4952" is used. The port number is encoded as an IP
address, explained below. One should determine the setting or non-setting of
SAGXTSDSport. If set, then confirm that the desired port
is encoded correctly. To confirm, issue the following ping command:
PING SAGXTSDSport
Text similar to the following should appear if SAGXTSDSport is defined:
Pinging SAGXTSDSport [19.88.0.0] with 32 bytes of data:
Reply from 206.24.181.1: Destination host unreachable.
Reply from 206.24.181.1: Destination host unreachable.
Reply from 206.24.181.1: Destination host unreachable.
Reply from 206.24.181.1: Destination host unreachable.
Ping statistics for 19.88.0.0: Packets:
Sent = 4, Received = 4, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
Minimum =0ms, Maximum = 0ms, Average = 0ms
The "Destination host unreachable" is expected as the SAGXTSDSport is the port number encoded as an IP address and as such is not a real IP address.
The port as an IP address encoding is done as follows:" port/256.port%256.0.0"
In above case, "19.88.0.0" equates to
"4952" (i.e., 256*49+187).
If SAGXTSDSport is set but is not encoded to the the desired port value then one of the following should be done:
Correct DNS entry.
Define SAGXTSDSport in the local "hosts" file.
Under windows the local hosts file can be found at %systemroot%\system32\drivers\etc
Example entry for using port 4952: "19.88.0.0 SAGXTSDSport ".
The -dirparms parameter specifies the fully
qualified name of the flat file repository to be used by the Directory Server. There
should be an xtsurl.cfg file in the standard Windows
application data subdirectory:
c:\Documents and Settings\All Users\Application Data\Software AG\.
In order for applications to access the Directory Server,
SAGXTSDShost must be set and point to the Directory Server host.
If SAGXTSDShost is not set, confirm with a
PING SAGXTSDShost command , then set
SAGXTSDShost in one of the following ways:
Define to a DNS server.
Define in the local hosts file for each computer needing access to the Directory Server.
Set an XTSDSURL environmental variable for any process that needs access to the Directory Server.
For example: set
xtsdsurl=tcpip://dirserverhost:port.
The command xtsdssvc -help will display
help on other xtsdssvc commands.
Under UNIX, manual configuration is possible by modifying the $SAG/common/bin/xtsdsdmn.sh script.
The SAGXTSDSport and SAGXTSDShost settings should be confirmed as in the Windows case.
The xtsurl.cfg file is located at $SAG/common/xts/com/softwareag/XTS. If xtsurl.cfg does not exist at the location there should be an xtsurl.ghost file at that location. If no xtsurl.cfg exists at $SAG/common/xts/com/softwareag/XTS the xtsurl.ghost file can be renamed to xtsurl.cfg.