Sun Directory Server Enterprise Edition 7.0 Administration Guide

Starting, Stopping, and Restarting a Directory Server Instance

To start, stop or restart, the server from the command line, use the commands dsadm start, dsadm stop, and dsadm restart, respectively.


Note –

When you stop and restart a Directory Server instance with a large cache in memory configured to hold entries, the cache takes some time to refill. While the cache fills again, the instance responds more slowly.


These commands must be run by the same UID and GID that created the Directory Server, or run by root. For example, if Directory Server runs as user1 , you should run the start, stop, and restart utilities as user1.


Note –

On Solaris, role-based access control allows you to run Directory Server as a user other than root.


ProcedureTo Start, Stop, and Restart Directory Server

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help. However, this does not apply to the step for enabling and disabling service management. Enabling and disabling service management must be done at the command line when starting and stopping Directory Server.

For more information about dsadm subcommands and options used below, see dsadm(1M).

  1. To start, stop, or restart Directory Server, do one of the following:

    • To start the server, type:


      $ dsadm start instance-path
      

      For example, to start a server with the instance path /local/dsInst, use this command:


      $ dsadm start /local/dsInst

      If the start operation fails after a configuration change, use the --safe option as shown in the following command:


      $ dsadm start --safe /local/dsInst
    • To stop the server, type:


      $ dsadm stop [--force] instance-path 
      

      For example:


      $ dsadm stop --force /local/dsInst
    • To restart the server, type:


      $ dsadm restart instance-path
      

      For example:


      $ dsadm restart /local/dsInst

ProcedureTo List All the Running Instances

  1. List the running instances on a host using the following command:


    dsadm list-running-instances [--all]

    The –all option lists the running instances from any installation path.

ProcedureTo Stop the Running Instances

  1. Stop the running instances on a host using the following command:


    dsadm stop-running-instances [-i] [--force]