setup-ds-admin.pl man page

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.

Info

May 18, 2008