.TH DSCREATE "8" "2024\-04\-15" "lib389 2.4.5" "Generated Python Manual"
.SH NAME
dscreate
.SH SYNOPSIS
.B dscreate
[-h] [-v] [-j] {from-file,interactive,create-template,ds-root} ...

.SH
POSITIONAL ARGUMENTS
.TP
\fBdscreate\fR \fI\,from\-file\/\fR
Create an instance of Directory Server from an inf answer file
.TP
\fBdscreate\fR \fI\,interactive\/\fR
Start interactive installer for Directory Server installation
.TP
\fBdscreate\fR \fI\,create\-template\/\fR
Display an example inf answer file, or provide a file name to write it to disk.
.TP
\fBdscreate\fR \fI\,ds\-root\/\fR
Prepare a root directory in which non root user can create, run and administer instances.

.SH COMMAND \fI\,'dscreate from\-file'\/\fR
usage: dscreate from\-file [\-h] [\-n] file

.TP
\fBfile\fR
Inf file to use with prepared answers. You can generate an example of this with 'dscreate create\-template'

.SH OPTIONS \fI\,'dscreate from\-file'\/\fR
.TP
\fB\-n\fR, \fB\-\-dryrun\fR
Validate system and configurations only. Do not alter the system.

.SH COMMAND \fI\,'dscreate interactive'\/\fR
usage: dscreate interactive [\-h]

.SH COMMAND \fI\,'dscreate create\-template'\/\fR
usage: dscreate create\-template [\-h] [\-\-advanced] [template_file]

.TP
\fBtemplate_file\fR
Write example template to this file

.SH OPTIONS \fI\,'dscreate create\-template'\/\fR
.TP
\fB\-\-advanced\fR
Add advanced options to the template \- changing the advanced options may make your instance install fail

.SH COMMAND \fI\,'dscreate ds\-root'\/\fR
usage: dscreate ds\-root [\-h] root_dir [bin_dir]

.TP
\fBroot_dir\fR
A directory that will be used as virtual root.

.TP
\fBbin_dir\fR
A directory in which administration wrappers are installed. (Should be in PATH)

.SH OPTIONS
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Display verbose operation tracing during command execution

.TP
\fB\-j\fR, \fB\-\-json\fR
Return the result as a json message

.SH COMMENTS
Example of install by a non root user:
    PATH=$HOME/bin:$PATH # Should be in .profile
    dscreate ds\-root $HOME/mydsroot $HOME/bin
    hash \-d dscreate # bash command to insure new dscreate wrapper will be used
    dscreate interactive
    # Note: Make sure to use non priviledged port number (i.e > 1000)

.SH AUTHOR
.nf
Red Hat, Inc., and William Brown <389-devel@lists.fedoraproject.org>
.fi

.SH DISTRIBUTION
The latest version of lib389 may be downloaded from
.UR http://www.port389.org/docs/389ds/FAQ/upstream\-test\-framework.html
.UE