Chapter 5 Starting, Restarting, and Stopping Directory Proxy Server

This chapter describes how to start, stop, and restart Directory Proxy Server and how to check its current status.



Note	You can use the Directory Proxy Server consoles only when the appropriate directory server (identified as the configuration directory) and Administration Server are running. Be sure to start Administration Server at the port you specified during Directory Proxy Server installation. To minimize security risks, shut down Administration Server when you have finished using the Sun Java System Server Console. For instructions on starting and shutting down Administration Server, see Sun Java System Administration Server.

Starting and Stopping Directory Proxy Server

Once Directory Proxy Server is installed, it runs constantly, listening for and accepting requests; it runs as a UNIX daemon process.

Note that stopping Directory Proxy Server shuts down all its components completely, interrupting service until the server is started again. If the host machine crashes or is taken off line, the server stops, and any requests it was servicing are lost. You need to start the server again to restore the service.

Starting and Stopping Directory Proxy Server From Sun Java System Server Console

You can use the Sun Java System Server Console to start and stop Directory Proxy Server installed on a local or remote host.

To Start or Stop Directory Proxy Server

Starting and Stopping Directory Proxy Server From Command Line

To Start or Stop Directory Proxy Server from the Command Line

Open a terminal window to your server.

In a UNIX system, log in as root if the server runs on ports less than 1024; otherwise, log in either as root or with the server's user account. (By default, if Directory Proxy Server is run by root, it changes its user ID to nobody.)

At the command-line prompt, enter either of the following lines:

To start Directory Proxy Server: <server-root>/dps-<hostname>/start-dps

To stop Directory Proxy Server: <server-root>/dps-<hostname>/stop-dps

<server-root> is the directory where the Directory Proxy Server binaries are kept. You first specified this directory during installation.

<hostname> is the name of the host on which this instance of Directory Proxy Server is installed.



Note	If Directory Proxy Server is already running, the start-up command fails. Stop the server first using the stop-dps command, then use the start-dps command.

Restarting Directory Proxy Server

Whenever you change the Directory Proxy Server configuration, you must save your changes for them to be stored in the configuration directory. All configuration changes require that you restart Directory Proxy Server after you save the changes. If restarting is required, the console prompts you accordingly.

During restart, Directory Proxy Server re-reads its configuration and uses the new configuration for future connections. Client connections that are already established continue to use the old configuration until the clients disconnect. The restart function is only available on UNIX platforms.

Restarting Directory Proxy Server From Command Line

To Restart Directory Proxy Server From the Command Line

Reloading Directory Proxy Server From Sun Java System Server Console on UNIX Platforms

On UNIX platforms you can use the Directory Proxy Server Console to reload a Directory Proxy Server configuration installed on a local or remote host. Whenever you change the Directory Proxy Server configuration on UNIX platforms reloading the Directory Proxy Server configuration causes the changes to take effect. On NT platforms you must restart the Directory Proxy Server configuration.

To Reload Directory Proxy Server From the Directory Proxy Server Console

If you're not already viewing the Directory Proxy Server Console, log in to the Sun Java System Server Console (see Logging In to the Sun Java System Server Console).

In the "Servers and Applications" tab, expand the hostname and then the Server Group that contains the Directory Proxy Server instance you want to restart.
Sun ONE Console showing all servers and applications available inculding Directory Proxy Server.

Sun ONE Console showing all servers and applications available inculding Directory Proxy Server.

Select the Directory Proxy Server instance you want to start or stop and click Open. The Directory Proxy Server Console opens.
Directory Proxy Server Tasks tab.

In the Tasks tab, click Reload Directory Proxy Server Configuration to reload the server.

Checking Directory Proxy Server System Status

You can check whether a particular instance of Directory Proxy Server is started or stopped in two ways:

Checking Directory Proxy Server Status From Sun Java System Server Console

You can use the Sun Java System Server Console to find out whether a particular Directory Proxy Server instance is running.

To Check Directory Proxy Server Status From Sun Java System Server Console

In the Servers and Applications tab, select the Directory Proxy Server instance you want to check.
Sun ONE Console showing all servers and applications available inculding Directory Proxy Server.

On the right hand side, check the Server Status field.

If the selected instance of Directory Proxy Server is running, the status is Started. Otherwise it is Alert, Stopped, or Unknown. Server status of stopped instances is also indicated when the SIE name is in italics.

Checking Directory Proxy Server Status From Command Line

To Determine Directory Proxy Server Status From The Command Line

Starting and Stopping Directory Proxy Server From the Command Line

Directory Proxy Server program runs as a UNIX daemon process or an NT service normally started during system boot time.

Directory Proxy Server will produce only a core image in case of a crash if its effective user ID is same as its real user ID. Therefore, if you want Directory Proxy Server to produce a core, then you must set the ids-proxy-con-userid attribute in object class ids-proxy-sch-GlobalConfiguration to the same user who starts the Directory Proxy Server process. By default, if Directory Proxy Server is run by root, it changes its userid to nobody.

Supported Flags

Table 5-1 Flags Supported By the Start and Stop Scripts
Flag	Description
-d	When this flag is present, Directory Proxy Server will handle only a single incoming connection at a time, and will send more detailed internal tracing information to the log file. This flag should not be used during normal operation, because it will prevent the Directory Proxy Server daemon from detaching from the controlling terminal.
-D	This flag tells Directory Proxy Server to send more detailed tracing information to the log file. Directory Proxy Server will still handle multiple client connections and run as a daemon. The -d and -D flags should be treated as mutually exclusive.
-t <startup configuration file>	This option can be used to specify an alternate startup configuration file. You must specify the absolute path to the configuration file.
-s	This option tells Directory Proxy Server to send the initial log messages to the syslogd using the LOG_DAEMON facility. This is the default if the environment variable dps_ROOT is not defined.
-M	If this flag is specified, Directory Proxy Server will spawn another process to monitor itself. In the case where Directory Proxy Server exits ungracefully, the monitor process restarts Directory Proxy Server after waiting for 30 seconds.
-r	This flag is used to append a value is joined to the tail of a hard coded registry path. The resulting registry path points a Directory Proxy Server service to its configuration information such as the root or instance root name.
-v	This flag prints the version information for Directory Proxy Server.

Restarting Directory Proxy Server

On UNIX platforms, Directory Proxy Server can be sent a SIGHUP signal to make it re-read its configuration. If the configuration is re-read successfully, Directory Proxy Server will use this new configuration for future connections. Client connections that are already established will continue to use the old configuration until the clients disconnect.

To signal Directory Proxy Server to re-read its configuration, use the hup-dps command found at <server-root>/dps-<hostname>.

Some attribute values cannot be changed using the HUP signal facility. For changes to the following configuration parameters, Directory Proxy Server will have to be shut down and started again. These attributes include:

   ids-proxy-con-listen-port
   ids-proxy-con-listen-host
   ids-proxy-con-ldaps-port
   ids-proxy-con-foreground
   ids-proxy-con-listen-backlog
   ids-proxy-con-ssl-cert
   ids-proxy-con-ssl-key

Also, the logging properties ids-proxy-sch-LogProperty cannot be changed using this facility.

On all platforms, a restart-dps command is found at <server-root>/dps-<hostname>. The restart command simply invokes the stop-dps and start-dps commands found in the aforementioned directory.

Previous Contents Index Next
Sun Java(TM) System Directory Proxy Server 5.2 2005Q1 Administration Guide