]>
Commit | Line | Data |
---|---|---|
0840a663 DM |
1 | *pveceph* `<COMMAND> [ARGS] [OPTIONS]` |
2 | ||
e2d681b3 | 3 | *pveceph createmgr* |
0840a663 | 4 | |
e2d681b3 | 5 | An alias for 'pveceph mgr create'. |
2489d6df | 6 | |
e2d681b3 | 7 | *pveceph createmon* |
2489d6df | 8 | |
e2d681b3 | 9 | An alias for 'pveceph mon create'. |
2489d6df | 10 | |
e2d681b3 | 11 | *pveceph createosd* |
2489d6df | 12 | |
e2d681b3 | 13 | An alias for 'pveceph osd create'. |
2489d6df | 14 | |
e2d681b3 | 15 | *pveceph createpool* |
2489d6df | 16 | |
e2d681b3 | 17 | An alias for 'pveceph pool create'. |
2489d6df | 18 | |
e2d681b3 | 19 | *pveceph destroymgr* |
2489d6df | 20 | |
e2d681b3 | 21 | An alias for 'pveceph mgr destroy'. |
0840a663 | 22 | |
e2d681b3 | 23 | *pveceph destroymon* |
0840a663 | 24 | |
e2d681b3 | 25 | An alias for 'pveceph mon destroy'. |
0840a663 | 26 | |
e2d681b3 | 27 | *pveceph destroyosd* |
0840a663 | 28 | |
e2d681b3 | 29 | An alias for 'pveceph osd destroy'. |
0840a663 | 30 | |
e2d681b3 | 31 | *pveceph destroypool* |
0840a663 | 32 | |
e2d681b3 | 33 | An alias for 'pveceph pool destroy'. |
0840a663 | 34 | |
e2d681b3 | 35 | *pveceph fs create* `[OPTIONS]` |
5d9c884c | 36 | |
e2d681b3 | 37 | Create a Ceph filesystem |
5d9c884c | 38 | |
e2d681b3 | 39 | `--add-storage` `<boolean>` ('default =' `0`):: |
0840a663 | 40 | |
e2d681b3 | 41 | Configure the created CephFS as storage for this cluster. |
0840a663 | 42 | |
e2d681b3 | 43 | `--name` `<string>` ('default =' `cephfs`):: |
0840a663 | 44 | |
e2d681b3 | 45 | The ceph filesystem name. |
2489d6df | 46 | |
e2d681b3 | 47 | `--pg_num` `<integer> (8 - 32768)` ('default =' `128`):: |
2489d6df | 48 | |
e2d681b3 | 49 | Number of placement groups for the backing data pool. The metadata pool will use a quarter of this. |
0840a663 | 50 | |
5370fa8c TL |
51 | *pveceph fs destroy* `<name>` `[OPTIONS]` |
52 | ||
53 | Destroy a Ceph filesystem | |
54 | ||
55 | `<name>`: `<string>` :: | |
56 | ||
57 | The ceph filesystem name. | |
58 | ||
59 | `--remove-pools` `<boolean>` ('default =' `0`):: | |
60 | ||
61 | Remove data and metadata pools configured for this fs. | |
62 | ||
63 | `--remove-storages` `<boolean>` ('default =' `0`):: | |
64 | ||
65 | Remove all pveceph-managed storages configured for this fs. | |
66 | ||
e2d681b3 | 67 | *pveceph help* `[OPTIONS]` |
0840a663 | 68 | |
e2d681b3 | 69 | Get help about specified command. |
0840a663 | 70 | |
e2d681b3 | 71 | `--extra-args` `<array>` :: |
0840a663 | 72 | |
e2d681b3 | 73 | Shows help for a specific command |
0840a663 | 74 | |
e2d681b3 | 75 | `--verbose` `<boolean>` :: |
2489d6df | 76 | |
e2d681b3 | 77 | Verbose output format. |
0840a663 | 78 | |
e2d681b3 | 79 | *pveceph init* `[OPTIONS]` |
0840a663 | 80 | |
e2d681b3 | 81 | Create initial ceph default configuration and setup symlinks. |
2489d6df | 82 | |
e2d681b3 | 83 | `--cluster-network` `<string>` :: |
2489d6df | 84 | |
e2d681b3 TL |
85 | Declare a separate cluster network, OSDs will routeheartbeat, object replication and recovery traffic over it |
86 | + | |
87 | NOTE: Requires option(s): `network` | |
88 | ||
89 | `--disable_cephx` `<boolean>` ('default =' `0`):: | |
90 | ||
1e3f8156 | 91 | Disable cephx authentication. |
e2d681b3 TL |
92 | + |
93 | WARNING: cephx is a security feature protecting against man-in-the-middle attacks. Only consider disabling cephx if your network is private! | |
2489d6df WB |
94 | |
95 | `--min_size` `<integer> (1 - 7)` ('default =' `2`):: | |
0840a663 | 96 | |
e2d681b3 | 97 | Minimum number of available replicas per object to allow I/O |
0840a663 | 98 | |
e2d681b3 | 99 | `--network` `<string>` :: |
0840a663 | 100 | |
e2d681b3 TL |
101 | Use specific network for all ceph related traffic |
102 | ||
103 | `--pg_bits` `<integer> (6 - 14)` ('default =' `6`):: | |
104 | ||
105 | Placement group bits, used to specify the default number of placement groups. | |
106 | + | |
107 | NOTE: 'osd pool default pg num' does not work for default pools. | |
0840a663 | 108 | |
2489d6df | 109 | `--size` `<integer> (1 - 7)` ('default =' `3`):: |
0840a663 | 110 | |
e2d681b3 TL |
111 | Targeted number of replicas per object |
112 | ||
113 | *pveceph install* `[OPTIONS]` | |
114 | ||
115 | Install ceph related packages. | |
116 | ||
ac70d7d1 TL |
117 | `--allow-experimental` `<boolean>` ('default =' `0`):: |
118 | ||
119 | Allow experimental versions. Use with care! | |
120 | ||
4a407cfd | 121 | `--repository` `<enterprise | no-subscription | test>` ('default =' `enterprise`):: |
0695fdaf | 122 | |
4a407cfd | 123 | Ceph repository to use. |
0695fdaf | 124 | |
4a407cfd | 125 | `--version` `<quincy>` ('default =' `quincy`):: |
e2d681b3 | 126 | |
1e3f8156 | 127 | Ceph version to install. |
e2d681b3 TL |
128 | |
129 | *pveceph lspools* | |
130 | ||
131 | An alias for 'pveceph pool ls'. | |
0840a663 | 132 | |
e2d681b3 TL |
133 | *pveceph mds create* `[OPTIONS]` |
134 | ||
135 | Create Ceph Metadata Server (MDS) | |
136 | ||
137 | `--hotstandby` `<boolean>` ('default =' `0`):: | |
138 | ||
139 | Determines whether a ceph-mds daemon should poll and replay the log of an active MDS. Faster switch on MDS failure, but needs more idle resources. | |
140 | ||
141 | `--name` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ('default =' `nodename`):: | |
142 | ||
143 | The ID for the mds, when omitted the same as the nodename | |
144 | ||
145 | *pveceph mds destroy* `<name>` | |
146 | ||
147 | Destroy Ceph Metadata Server | |
148 | ||
149 | `<name>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` :: | |
150 | ||
151 | The name (ID) of the mds | |
152 | ||
153 | *pveceph mgr create* `[OPTIONS]` | |
154 | ||
155 | Create Ceph Manager | |
156 | ||
157 | `--id` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` :: | |
158 | ||
159 | The ID for the manager, when omitted the same as the nodename | |
160 | ||
161 | *pveceph mgr destroy* `<id>` | |
2489d6df WB |
162 | |
163 | Destroy Ceph Manager. | |
164 | ||
165 | `<id>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` :: | |
166 | ||
167 | The ID of the manager | |
168 | ||
e2d681b3 TL |
169 | *pveceph mon create* `[OPTIONS]` |
170 | ||
171 | Create Ceph Monitor and Manager | |
172 | ||
1e3f8156 | 173 | `--mon-address` `<string>` :: |
e2d681b3 | 174 | |
0695fdaf | 175 | Overwrites autodetected monitor IP address(es). Must be in the public network(s) of Ceph. |
e2d681b3 | 176 | |
1e3f8156 | 177 | `--monid` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` :: |
e2d681b3 TL |
178 | |
179 | The ID for the monitor, when omitted the same as the nodename | |
180 | ||
1e3f8156 | 181 | *pveceph mon destroy* `<monid>` |
2489d6df WB |
182 | |
183 | Destroy Ceph Monitor and Manager. | |
184 | ||
185 | `<monid>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` :: | |
0840a663 DM |
186 | |
187 | Monitor ID | |
188 | ||
e2d681b3 | 189 | *pveceph osd create* `<dev>` `[OPTIONS]` |
0840a663 | 190 | |
e2d681b3 | 191 | Create OSD |
0840a663 | 192 | |
e2d681b3 | 193 | `<dev>`: `<string>` :: |
0840a663 | 194 | |
e2d681b3 | 195 | Block device name. |
0840a663 | 196 | |
739d4d64 TL |
197 | `--crush-device-class` `<string>` :: |
198 | ||
199 | Set the device class of the OSD in crush. | |
200 | ||
1e3f8156 | 201 | `--db_dev` `<string>` :: |
0840a663 | 202 | |
1e3f8156 | 203 | Block device name for block.db. |
0840a663 | 204 | |
0695fdaf | 205 | `--db_dev_size` `<number> (1 - N)` ('default =' `bluestore_block_db_size or 10% of OSD size`):: |
0840a663 | 206 | |
1e3f8156 TL |
207 | Size in GiB for block.db. |
208 | + | |
209 | NOTE: Requires option(s): `db_dev` | |
0840a663 | 210 | |
1e3f8156 | 211 | `--encrypted` `<boolean>` ('default =' `0`):: |
0840a663 | 212 | |
1e3f8156 | 213 | Enables encryption of the OSD. |
0840a663 | 214 | |
e2d681b3 | 215 | `--wal_dev` `<string>` :: |
2c0dde61 | 216 | |
1e3f8156 TL |
217 | Block device name for block.wal. |
218 | ||
0695fdaf | 219 | `--wal_dev_size` `<number> (0.5 - N)` ('default =' `bluestore_block_wal_size or 1% of OSD size`):: |
1e3f8156 TL |
220 | |
221 | Size in GiB for block.wal. | |
222 | + | |
223 | NOTE: Requires option(s): `wal_dev` | |
2c0dde61 | 224 | |
e2d681b3 | 225 | *pveceph osd destroy* `<osdid>` `[OPTIONS]` |
2489d6df | 226 | |
e2d681b3 | 227 | Destroy OSD |
2489d6df | 228 | |
e2d681b3 | 229 | `<osdid>`: `<integer>` :: |
0840a663 | 230 | |
e2d681b3 | 231 | OSD ID |
0840a663 | 232 | |
e2d681b3 | 233 | `--cleanup` `<boolean>` ('default =' `0`):: |
0840a663 | 234 | |
e2d681b3 | 235 | If set, we remove partition table entries. |
0840a663 | 236 | |
159464a9 TL |
237 | *pveceph osd details* `<osdid>` `[OPTIONS]` `[FORMAT_OPTIONS]` |
238 | ||
239 | Get OSD details. | |
240 | ||
241 | `<osdid>`: `<string>` :: | |
242 | ||
243 | ID of the OSD | |
244 | ||
245 | `--verbose` `<boolean>` ('default =' `0`):: | |
246 | ||
247 | Print verbose information, same as json-pretty output format. | |
248 | ||
e2d681b3 | 249 | *pveceph pool create* `<name>` `[OPTIONS]` |
0840a663 | 250 | |
7af2edf9 | 251 | Create Ceph pool |
0840a663 | 252 | |
e2d681b3 | 253 | `<name>`: `<string>` :: |
0840a663 | 254 | |
e2d681b3 | 255 | The name of the pool. It must be unique. |
0840a663 | 256 | |
e6d66c2f | 257 | `--add_storages` `<boolean>` ('default =' `0; for erasure coded pools: 1`):: |
5d9c884c | 258 | |
e6d66c2f | 259 | Configure VM and CT storage using the new pool. |
5d9c884c | 260 | |
4772952b | 261 | `--application` `<cephfs | rbd | rgw>` ('default =' `rbd`):: |
5d9c884c | 262 | |
4772952b | 263 | The application of the pool. |
5d9c884c | 264 | |
e2d681b3 | 265 | `--crush_rule` `<string>` :: |
0840a663 | 266 | |
e2d681b3 | 267 | The rule to use for mapping object placement in the cluster. |
0840a663 | 268 | |
7af2edf9 TL |
269 | `--erasure-coding` `k=<integer> ,m=<integer> [,device-class=<class>] [,failure-domain=<domain>] [,profile=<profile>]` :: |
270 | ||
460359c5 | 271 | Create an erasure coded pool for RBD with an accompaning replicated pool for metadata storage. With EC, the common ceph options 'size', 'min_size' and 'crush_rule' parameters will be applied to the metadata pool. |
7af2edf9 | 272 | |
e2d681b3 | 273 | `--min_size` `<integer> (1 - 7)` ('default =' `2`):: |
0840a663 | 274 | |
e2d681b3 TL |
275 | Minimum number of replicas per object |
276 | ||
4772952b TL |
277 | `--pg_autoscale_mode` `<off | on | warn>` ('default =' `warn`):: |
278 | ||
279 | The automatic PG scaling mode of the pool. | |
280 | ||
d2656385 | 281 | `--pg_num` `<integer> (1 - 32768)` ('default =' `128`):: |
e2d681b3 TL |
282 | |
283 | Number of placement groups. | |
0840a663 | 284 | |
d2656385 TL |
285 | `--pg_num_min` `<integer> (-N - 32768)` :: |
286 | ||
287 | Minimal number of placement groups. | |
288 | ||
2489d6df | 289 | `--size` `<integer> (1 - 7)` ('default =' `3`):: |
0840a663 | 290 | |
e2d681b3 | 291 | Number of replicas per object |
0840a663 | 292 | |
d2656385 TL |
293 | `--target_size` `^(\d+(\.\d+)?)([KMGT])?$` :: |
294 | ||
295 | The estimated target size of the pool for the PG autoscaler. | |
296 | ||
297 | `--target_size_ratio` `<number>` :: | |
298 | ||
299 | The estimated target ratio of the pool for the PG autoscaler. | |
300 | ||
e2d681b3 | 301 | *pveceph pool destroy* `<name>` `[OPTIONS]` |
0840a663 | 302 | |
e2d681b3 | 303 | Destroy pool |
0840a663 | 304 | |
e2d681b3 | 305 | `<name>`: `<string>` :: |
0840a663 | 306 | |
e2d681b3 | 307 | The name of the pool. It must be unique. |
0840a663 | 308 | |
e2d681b3 TL |
309 | `--force` `<boolean>` ('default =' `0`):: |
310 | ||
311 | If true, destroys pool even if in use | |
312 | ||
7af2edf9 TL |
313 | `--remove_ecprofile` `<boolean>` ('default =' `1`):: |
314 | ||
315 | Remove the erasure code profile. Defaults to true, if applicable. | |
316 | ||
e2d681b3 TL |
317 | `--remove_storages` `<boolean>` ('default =' `0`):: |
318 | ||
319 | Remove all pveceph-managed storages configured for this pool | |
320 | ||
d2656385 TL |
321 | *pveceph pool get* `<name>` `[OPTIONS]` `[FORMAT_OPTIONS]` |
322 | ||
9d2e98ed | 323 | Show the current pool status. |
d2656385 TL |
324 | |
325 | `<name>`: `<string>` :: | |
326 | ||
327 | The name of the pool. It must be unique. | |
328 | ||
329 | `--verbose` `<boolean>` ('default =' `0`):: | |
330 | ||
331 | If enabled, will display additional data(eg. statistics). | |
332 | ||
ac70d7d1 | 333 | *pveceph pool ls* `[FORMAT_OPTIONS]` |
0840a663 | 334 | |
9d2e98ed TL |
335 | List all pools and their settings (which are settable by the POST/PUT |
336 | endpoints). | |
0840a663 | 337 | |
4772952b TL |
338 | *pveceph pool set* `<name>` `[OPTIONS]` |
339 | ||
340 | Change POOL settings | |
341 | ||
342 | `<name>`: `<string>` :: | |
343 | ||
344 | The name of the pool. It must be unique. | |
345 | ||
346 | `--application` `<cephfs | rbd | rgw>` :: | |
347 | ||
348 | The application of the pool. | |
349 | ||
350 | `--crush_rule` `<string>` :: | |
351 | ||
352 | The rule to use for mapping object placement in the cluster. | |
353 | ||
354 | `--min_size` `<integer> (1 - 7)` :: | |
355 | ||
356 | Minimum number of replicas per object | |
357 | ||
358 | `--pg_autoscale_mode` `<off | on | warn>` :: | |
359 | ||
360 | The automatic PG scaling mode of the pool. | |
361 | ||
d2656385 | 362 | `--pg_num` `<integer> (1 - 32768)` :: |
4772952b TL |
363 | |
364 | Number of placement groups. | |
365 | ||
d2656385 TL |
366 | `--pg_num_min` `<integer> (-N - 32768)` :: |
367 | ||
368 | Minimal number of placement groups. | |
369 | ||
4772952b TL |
370 | `--size` `<integer> (1 - 7)` :: |
371 | ||
372 | Number of replicas per object | |
373 | ||
d2656385 TL |
374 | `--target_size` `^(\d+(\.\d+)?)([KMGT])?$` :: |
375 | ||
376 | The estimated target size of the pool for the PG autoscaler. | |
377 | ||
378 | `--target_size_ratio` `<number>` :: | |
379 | ||
380 | The estimated target ratio of the pool for the PG autoscaler. | |
381 | ||
ac70d7d1 | 382 | *pveceph purge* `[OPTIONS]` |
0840a663 DM |
383 | |
384 | Destroy ceph related data and configuration files. | |
385 | ||
ac70d7d1 TL |
386 | `--crash` `<boolean>` :: |
387 | ||
388 | Additionally purge Ceph crash logs, /var/lib/ceph/crash. | |
389 | ||
390 | `--logs` `<boolean>` :: | |
391 | ||
392 | Additionally purge Ceph logs, /var/log/ceph. | |
393 | ||
c5aa7e14 | 394 | *pveceph start* `[OPTIONS]` |
0840a663 DM |
395 | |
396 | Start ceph services. | |
397 | ||
c5aa7e14 | 398 | `--service` `(ceph|mon|mds|osd|mgr)(\.[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?)?` ('default =' `ceph.target`):: |
0840a663 DM |
399 | |
400 | Ceph service name. | |
401 | ||
0840a663 DM |
402 | *pveceph status* |
403 | ||
d2656385 | 404 | Get Ceph Status. |
0840a663 | 405 | |
c5aa7e14 | 406 | *pveceph stop* `[OPTIONS]` |
0840a663 DM |
407 | |
408 | Stop ceph services. | |
409 | ||
c5aa7e14 | 410 | `--service` `(ceph|mon|mds|osd|mgr)(\.[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?)?` ('default =' `ceph.target`):: |
0840a663 DM |
411 | |
412 | Ceph service name. | |
413 | ||
414 |