'\" t
.\"     Title: start-ds
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: April, 2013
.\"    Manual: Tools Reference
.\"    Source: OpenDJ 2.5.0
.\"  Language: English
.\"
.TH "START\-DS" "1M" "April, 2013" "OpenDJ 2.5.0" "Tools Reference"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
start-ds \- start OpenDJ directory server
.SH "SYNOPSIS"
.ad l
.hy 0
.HP \w'\fBstart\-ds\fR\ 'u
\fBstart\-ds\fR [\-L] [\-Q] [\-s] [\-N | \-t\ \fIseconds\fR] [\-V] [\-H]
.ad
.hy
.SH "DESCRIPTION"
.PP
This utility can be used to start the directory server manually, as well as to obtain the server version and other forms of general server information\&.
.PP
However, on Solaris 10 and better the preferred method to start the server is to enable the related SMF service (default: svc:/network/ldap/opendj25:default), which automatically starts and monitors the related OpenDJ instance\&. So you can take advantage of
\fBsmf\fR(5)
features and as well as getting notified, if something goes wrong\&.
.PP
In turn, if you really need to start the server manually, you need to disable the corresponding SMF service first using
\fBsvcadm\fR(1M)
to shutdown a the possibly running server instance first\&.
.SH "OPTIONS"
.PP
The following options are supported\&.
.PP
\%\fB\-L, \-\-useLastKnownGoodConfig\fR
.RS 4
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\&.
.RE
.PP
\%\fB\-N, \-\-nodetach\fR
.RS 4
Do not detach from the terminal and continue running in the foreground\&. This option cannot be used with the \-t, \-\-timeout option\&.
.sp
Furthermore it should never be used as an argument for the
\%\fBstart\-ds\&.java\-args\fR
or
\%\fBdefault\&.java\-args\fR
of the
\%config/java\&.properties
file\&. Otherwise this would prevent the SMF service to [re]start the corresponding OpenDJ instance successfully\&. Similar it should also not be used as an argument in the
config/server_start_args
property of the related OpenDJ SMF service, because this would have the same negative effect\&.
.RE
.PP
\%\fB\-Q, \-\-quiet\fR
.RS 4
Use quiet mode\&.
.RE
.PP
\%\fB\-s, \-\-systemInfo\fR
.RS 4
Display general system information\&.
.RE
.PP
\%\fB\-t, \-\-timeout\fR \%\fIseconds\fR
.RS 4
Maximum time (in seconds) to wait 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 (Default: 200)\&. This option cannot be used with the \-N, \-\-nodetach option\&.
.RE
.SS "General Options"
.PP
\%\fB\-V, \-\-version\fR
.RS 4
Display version information\&.
.RE
.PP
\%\fB\-H, \-\-help\fR
.RS 4
Display usage information\&.
.RE
.SH "EXAMPLES"
.PP
The following command enables the service for the default OpenDJ instance and after that, it is checked, whether the service is running (as long as there is no other OpenDJ service configured, one can even ommit the trailing
:default):
.sp
.if n \{\
.RS 4
.\}
.nf
$ \%\fBsvcadm enable opendj25:default\fR
$ \%\fBsvcs \-l opendj25:default\fR
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
fmri         svc:/network/ldap/opendj25:default
name         OpenDJ LDAP directory server
enabled      true
state        online
next_state   none
state_time   Wed Apr 17 08:27:25 2013
logfile      /var/svc/log/network\-ldap\-opendj25:default\&.log
restarter    svc:/system/svc/restarter:default
contract_id  2237 
manifest     /lib/svc/manifest/network/ldap/opendj25\&.xml
dependency   require_all/none svc:/system/filesystem/local (online)
dependency   optional_all/refresh svc:/system/identity:domain (online)
dependency   require_all/none svc:/network/service (online)
.fi
.if n \{\
.RE
.\}
.PP
The following example shows the current
config/*
properties of the default OpenDJ SMF service (note, that no server start or stop args are set, which is the default):
.sp
.if n \{\
.RS 4
.\}
.nf
$ \%\fBsvcprop \-p config opendj25:default\fR
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
config/stability astring Evolving
config/datadir astring /var/share/ldap/opendj
config/server_start_args astring 
config/server_stop_args astring 
.fi
.if n \{\
.RE
.\}
.PP
The following command starts the server manually without displaying information about the startup process\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ \%\fBstart\-ds \-Q\fR
.fi
.if n \{\
.RE
.\}
.SH "ENVIRONMENT VARIABLES"
.PP
See
\fBopendj\fR(5)\&.
.SH "EXIT STATUS"
.PP
\%\fB0\fR
.RS 4
The command completed successfully\&.
.RE
.PP
\%\fB> 0\fR
.RS 4
An error occurred\&.
.RE
.SH "SEE ALSO"
.PP

\fBstop-ds\fR(1M),
\fBdsjavaproperties\fR(1M),
\fBopendj\fR(5),
\fBsvcadm\fR(1M),
\fBsvcs\fR(1),
\fBsvcprop\fR(1),
\fBsvccfg\fR(1M)\&.