NAME

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

SYNOPSIS

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

DESCRIPTION

       Set  up  a  Directory Server instance.  Creates the configuration files for an instance of
       Directory Server based on a few parameters like the hostname, port number,  and  directory
       manager  information.   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
              Update existing installations - add/update schema files, add/change  configuration,
              add  new  instance  scripts,  etc. You must run setup-ds.pl -u after upgrading your
              packages.  You will usually have to restart your servers in order for  all  of  the
              changes  to  take  effect (e.g. adding/changing plug-in configuration), so schedule
              this when you can afford a little downtime.

       --continue
              (Update only) Keep going even if errors occur.  You will usually not  need  to  use
              this  option  unless your installation is broken and you need to force it to update
              in order to fix it.

       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.

UPDATES

       The update process (setup-ds.pl -u) can work in one of two modes:

       Online: Configuration changes are made to the running directory servers using  LDAP.   The
       operations  must  be  performed  as an administrative user.  You must provide the name and
       password, for each instance if there is more than one instance of directory  server.  Some
       changes (e.g. plug-ins) may require a directory server restart to take effect.  The update
       script will notify you if a restart is required.

       Offline: The changes are made to the server configuration files.  The servers  MUST  FIRST
       BE  SHUTDOWN BY YOU.  The script will not shutdown the servers for you.  You MUST shutdown
       the servers in order to use this mode.  A username and password are not  required  to  use
       Offline mode.  If the servers are not shutdown, CHANGES WILL BE LOST.

       To summarize:

       Online - servers remain running - you must provide admin name and password for each server
       - servers may need to be restarted

       Offline - servers must be shutdown - no username or password required

AUTHOR

       setup-ds.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.PL(8)