Exit Print View

Sun OpenDS Standard Edition 2.2 Command-Line Usage Guide

Get PDF Book Print View
 

Document Information

Before You Start

Server Administration Commands

control-panel

create-rc-script

dsconfig

dsreplication

gicadm

manage-tasks

setup

start-ds

status

stop-ds

uninstall

vdp-control-panel

vdp-setup

vdp-uninstall

windows-service

Data Administration Commands

LDAP Client Utilities Commands

Other Commands

General Tool Usage Information

start-ds

The start-ds command starts an installed server instance.

Synopsis

start-ds [options]

Description

The start-ds command is used to start the server and to provide general server information.

You can run start-ds without any options, which starts the server as a background process. In this case, the script will not exit until the server has either started successfully or has encountered an error that prevents it from starting.

On UNIX systems, the server will not start if it cannot log the process ID at install-dir/logs/server.pid. Ensure that the file is writable by the user account that the server uses.

Options

The start-ds command accepts an option in either its short form (for example, -N) or its long form equivalent (for example, --nodetach).

-L, --useLastKnownGoodConfig

Attempt to start using the configuration that was in place at the last successful startup (if it is available) rather than using the current active configuration.

-N, --nodetach

Start the server as a foreground process that does not detach from the terminal. When the server is running in this mode, it can be stopped by using the stop-ds command from another window, or by pressing Control+C in the terminal window in which the server is running.

-s, --systemInfo

Display general information about the system on which the server is installed, including the instance and installation paths, and then exit rather than attempting to start the server.

-t, --timeout seconds

Wait no longer than the maximum time (in seconds) before the command returns. (The server continues the startup process, regardless). A value of 0 indicates an infinite timeout, which means that the command returns only when the server startup is completed. The default value is 60 seconds. This option cannot be used with the -N, --nodetach option.

Command Input/Output Options
-Q, --quiet

Run in quiet mode. No output is generated unless a significant error occurs during the process.

General Options
-?, -H, --help

Display command-line usage information for the command and exit without making any attempt to stop or restart the server.

-V, --version

Display the version information for the server and exit rather than attempting to run this command.

Examples

The following examples show how to use the server commands. You can use the commands on any UNIX, Linux, or Windows system that has at least the Java SE 5 (at least Sun version 1.5.0_08, preferably the latest version of Java SE 6) runtime environment installed on its target system.

For more information, see Sun OpenDS Standard Edition System Requirements in Sun OpenDS Standard Edition 2.2 Installation Guide.

Example 28
Starting the Server

The following command starts the server:

$ start-ds
Example 29
Starting the Server as a Foreground Process

The following command starts the server as a foreground process. You can stop the server by running the stop-ds command from another window or by pressing Control+C in the terminal window in which the server is running.

$ start-ds -N

[25/Jul/2007:10:39:17 -0500] category=CORE severity=NOTICE msgID=458886
msg=OpenDS Directory Server 1.0.0
starting up
...
The Directory Server has started successfully.
Exit Codes
Exit Code
Description
0
Server started successfully.
1
Check error. Generated from incompatible options.
98
Server already started.
99
Server must start as a detached process.
100
Server must start as a non-detached process.
101
Server must start as a Windows service.
102
Server must start as a detached process and it is being called from a Windows service.
Location

The start-ds command is located at these paths:

Related Commands