1dsctl(8)                    System Manager's Manual                   dsctl(8)
2
3
4

NAME

6       dsctl
7

SYNOPSIS

9       dsctl  [-h]  [-v]  [-j]  [-l]  [--remove-all  [REMOVE_ALL]]  [instance]
10       {restart,start,stop,sta‐
11       tus,remove,db2index,db2bak,db2ldif,bak2db,ldif2db,backups,ldifs} ...
12

OPTIONS

14       instance
15              The name of the instance to act upon
16
17
18   Sub-commands
19       dsctl restart
20              Restart  an instance of Directory Server, if it is running: else
21              start it.
22
23       dsctl start
24              Start an instance of Directory Server, if it  is  not  currently
25              running
26
27       dsctl stop
28              Stop an instance of Directory Server, if it is currently running
29
30       dsctl status
31              Check running status of an instance of Directory Server
32
33       dsctl remove
34              Destroy an instance of Directory Server, and remove all data.
35
36       dsctl db2index
37              Initialise  a reindex of the server database. The server must be
38              stopped for this to proceed.
39
40       dsctl db2bak
41              Initialise a BDB backup of the  database.  The  server  must  be
42              stopped for this to proceed.
43
44       dsctl db2ldif
45              Initialise  an  LDIF  dump  of  the database. The server must be
46              stopped for this to proceed.
47
48       dsctl bak2db
49              Restore a BDB backup of the database. The server must be stopped
50              for this to proceed.
51
52       dsctl ldif2db
53              Restore an LDIF dump of the database. The server must be stopped
54              for this to proceed.
55
56       dsctl backups
57              List backup's found in the server's default backup directory
58
59       dsctl ldifs
60              List all the DLIF files located in the server's LDIF directory
61

OPTIONS 'dsctl restart'

63       usage: dsctl [instance] restart [-h]
64
65
66
67

OPTIONS 'dsctl start'

69       usage: dsctl [instance] start [-h]
70
71
72
73

OPTIONS 'dsctl stop'

75       usage: dsctl [instance] stop [-h]
76
77
78
79

OPTIONS 'dsctl status'

81       usage: dsctl [instance] status [-h]
82
83
84
85

OPTIONS 'dsctl remove'

87       usage: dsctl [instance] remove [-h] [--do-it]
88
89
90
91       --do-it
92              By default we do a dry run. This actually initiates the  removal
93              of the
94              instance.
95
96

OPTIONS 'dsctl db2index'

98       usage: dsctl [instance] db2index [-h] backend
99
100
101       backend
102              The backend to reindex. IE userRoot
103
104
105

OPTIONS 'dsctl db2bak'

107       usage: dsctl [instance] db2bak [-h] [archive]
108
109
110       archive
111              The destination for the archive. This will be created during the
112              db2bak
113              process.
114
115
116

OPTIONS 'dsctl db2ldif'

118       usage: dsctl [instance] db2ldif [-h] [--replication] [--encrypted]
119                                       backend [ldif]
120
121
122       backend
123              The backend to output as an LDIF. IE userRoot
124
125
126       ldif   The path to the ldif output location.
127
128
129       --replication
130              Export replication information, suitable for importing on a  new
131              consumer or
132              backups.
133
134
135       --encrypted
136              Export encrypted attributes
137
138

OPTIONS 'dsctl bak2db'

140       usage: dsctl [instance] bak2db [-h] archive
141
142
143       archive
144              The archive to restore. This will erase all current server data‐
145              bases.
146
147
148

OPTIONS 'dsctl ldif2db'

150       usage: dsctl [instance] ldif2db [-h] [--encrypted] backend ldif
151
152
153       backend
154              The backend to restore from an LDIF. IE userRoot
155
156
157       ldif   The path to the ldif to import
158
159
160       --encrypted
161              Import encrypted attributes
162
163

OPTIONS 'dsctl backups'

165       usage: dsctl [instance] backups [-h] [--delete DELETE]
166
167
168
169       --delete DELETE
170              Delete backup directory
171
172

OPTIONS 'dsctl ldifs'

174       usage: dsctl [instance] ldifs [-h] [--delete DELETE]
175
176
177
178       --delete DELETE
179              Delete LDIF file
180
181
182       -v, --verbose
183              Display verbose operation tracing during command execution
184
185
186       -j, --json
187              Return result in JSON object
188
189
190       -l, --list
191              List available Directory Server instances
192
193
194       --remove-all [REMOVE_ALL]
195              Remove all instances of Directory Server (you can  also  provide
196              an optional
197              directory prefix for this argument)
198
199

AUTHORS

201       lib389 was written by Red Hat Inc. <389-devel@lists.fedoraproject.org>.
202

DISTRIBUTION

204       The    latest    version    of    lib389   may   be   downloaded   from
205http://www.port389.org/docs/389ds/FAQ/upstream-test-framework.html
206
207
208
209                                    Manual                            dsctl(8)
Impressum