NAME

       setup-ds-admin.pl - Set up an instance of Directory Server and Admin Server

SYNOPSIS

       setup-ds-admin.pl [--options] -- [args]

DESCRIPTION

       Set up a Directory Server and Admin Server.  Creates the configuration files for an instance of Directory
       Server based on a few parameters like the hostname,  port  number,  and  directory  manager  information.
       Creates  the configuration files for the Admin Server.  Starts up the servers.  This command does the set
       up necessary for the use of the Console and the Admin Express web interface.

       If the Admin Server has already been set up, this command will create a new instance of Directory  Server
       and register it with the Admin Server so that it can be managed with the Console.

       Use  this  command  with the --update option after an upgrade to refresh the server information (version,
       build number, etc.) in the Console.

       Can be run in interactive mode with different levels of verbosity, or  in  silent  mode  with  parameters
       supplied in a .inf format file or on the command line.

OPTIONS

       A summary of options is included below:

       --help This message

       --version
              Print the version and exit

       --debug
              Turn on debugging

       --silent
              Use silent setup - no user input

       --file=name
              Use the file 'name' in .inf format to supply the default answers

       --keepcache
              Do not delete the temporary .inf file generated by this program

       --logfile
              Log setup messages to this file - otherwise, a temp file will be used

       --update
              Refresh  the  information  used by the Console for all servers on this machine.  Use this after an
              upgrade to make sure the Console reports the correct information.

       For all options, you can also use the short name e.g. -h, -d, etc.  For the -d  argument,  specifying  it
       more than once will increase the debug level e.g. -ddddd

       args: You can supply default .inf data in this format:

              section.param=value

       e.g.

              General.FullMachineName=foo.example.com

       or

              "slapd.Suffix=dc=example, dc=com"

       Values passed in this manner will override values in an .inf file given with the -f argument.

AUTHOR

       setup-ds-admin.pl was written by the 389 Project.

REPORTING BUGS

       Report bugs to http://bugzilla.redhat.com.

COPYRIGHT

       Copyright © 2008 Red Hat, Inc.
       This manual page was written by Michele Baldessari <michele@pupazzo.org>, for the Debian project (but may
       be used by others).
       This is free software.  You may redistribute copies of it under the terms of the Directory Server license
       found  in  the  LICENSE  file of this software distribution.  This license is essentially the GNU General
       Public License version 2 with an exception for plug-in distribution.

                                                  May 18, 2008                              SETUP-DS-ADMIN.PL(8)