UNIX Directory Server Operations

The Directory Server for UNIX is run as a UNIX daemon.

This document covers the following topics:


Running Directory Server as a UNIX Daemon

After Software AG Directory Server is installed, it can be run as a UNIX daemon. Modify the shell script $SAG/common/bin/xtsdsdmn.sh, if desired (no modifications are required), and then invoke it.

The xtsdsdmn Program

The xtsdsdmn program, located in the $SAG/common/bin subdirectory, is used to start and stop the Directory Server.

To stop the Directory Server daemon, first obtain the xtsdsdmn process ID, as follows:

ps -ef | grep xtsdsdmn

Then enter the UNIX kill command and the process ID (nnnnn), as follows:

kill -9 nnnnn

The parameters described in the following table can be passed to xtsdsdmn at start time.

Parameter Value
-name STRING
Indicates the Software AG Directory Server name. The default value is "XTSDIR".
-port  NUMBER
Indicates the listen port for the server. A "0" value indicates that either the value defined by SAGXTSDSport or "4952" will be used. If SAGXTSDSport is not defined then "4952" is used. The default value is "0".
-directory STRING
Indicates the type of Directory Server to be employed. The default value is "INIDIR".
-dirparms STRING

Sets directory parameters appropriate for the Directory Server identified by the -directory parameter. If the -directory parameter is set to "INIDIR", then this parameter is set to the full path name of the Software AG Directory Server URL configuration file.

The installation procedure sets this parameter to reference the file: $SAG/common/xts/com/softwareag/XTS/xtsurl.cfg.

-logdir STRING
Specifies the directory to contain the Directory Server process log controlled by the -trace parameter. (Refer to the documentation for -trace below. The installation default value is null, which results writing to the root directory by default.
-trace NUMBER

Turns on Directory Server process logging. The log is written to the root directory or the directory set by -logdir parameter. The default value is "0".

Specify "65534" to obtain full tracing. Specifying "65535" results in an internal buffer trace only, do not specify "65535", unless specifically instructed to do so.

The Directory Server should be stopped and restarted when changing the trace value.

-pid This parameter is optional. Indicates the file where the Directory Server daemon process identifier will be recorded. When the daemon is terminated, an attempt will be made to delete the file identified in this parameter.
-help
Prints the help message.