1dsctl(8) System Manager's Manual dsctl(8)
2
3
4
6 dsctl
7
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
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
63 usage: dsctl [instance] restart [-h]
64
65
66
67
69 usage: dsctl [instance] start [-h]
70
71
72
73
75 usage: dsctl [instance] stop [-h]
76
77
78
79
81 usage: dsctl [instance] status [-h]
82
83
84
85
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
98 usage: dsctl [instance] db2index [-h] backend
99
100
101 backend
102 The backend to reindex. IE userRoot
103
104
105
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
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
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
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
165 usage: dsctl [instance] backups [-h] [--delete DELETE]
166
167
168
169 --delete DELETE
170 Delete backup directory
171
172
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
201 lib389 was written by Red Hat Inc. <389-devel@lists.fedoraproject.org>.
202
204 The latest version of lib389 may be downloaded from
205 ⟨http://www.port389.org/docs/389ds/FAQ/upstream-test-framework.html⟩
206
207
208
209 Manual dsctl(8)