
Administration	Version 6.2.1	SEARCH INDEX CONTENTS \| PDF PAGE PDF BOOKS \| HOME UP PREV NEXT

— Software AG Directory Server Administration —

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
The xtsdsdmn Program

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 "12731" will be used. If SAGXTSDSport is not defined then "12731" 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.

SEARCH INDEX CONTENTS | PDF PAGE PDF BOOKS | HOME UP PREV NEXT