Sun Java(TM) System Directory Proxy Server 5.2 2005Q1 Administration Guide |
Chapter 5
Starting, Restarting, and Stopping Directory Proxy ServerThis chapter describes how to start, stop, and restart Directory Proxy Server and how to check its current status.
The chapter has the following sections:
- Starting and Stopping Directory Proxy Server From the Command Line
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 ServerOnce Directory Proxy Server is installed, it runs constantly, listening for and accepting requests; it runs as a UNIX daemon process.
You can start and stop Directory Proxy Server in the following ways:
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
- 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 start.
- Select a Directory Proxy Server instance and click Open. The Directory Proxy Server Console opens.
- In the Tasks tab, click Start Directory Proxy Server or Stop Directory Proxy Server to start or stop the 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:
Restarting Directory Proxy ServerWhenever 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.
You can restart Directory Proxy Server in the following ways:
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 PlatformsOn 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.
- Select the Directory Proxy Server instance you want to start or stop and click Open. The Directory Proxy Server Console opens.
- In the Tasks tab, click Reload Directory Proxy Server Configuration to reload the server.
Checking Directory Proxy Server System StatusYou 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
- 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, select the Directory Proxy Server instance you want to check.
- 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 LineDirectory Proxy Server program runs as a UNIX daemon process or an NT service normally started during system boot time.
On all platforms, Directory Proxy Server's start program resides at:
<server-root>/dps-<hostname>/start-dps
The startup configuration file resides at:
<server-root>/dps-<hostname>/etc/tailor.txt
Directory Proxy Server may be started and stopped via the scripts found at:
<server-root>/dps-<hostname>
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
The flags supported by the start and stop scripts are described in Table 5-1.
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-keyAlso, 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.