1 *pveceph* `<COMMAND> [ARGS] [OPTIONS]`
5 An alias for 'pveceph mgr create'.
9 An alias for 'pveceph mon create'.
13 An alias for 'pveceph osd create'.
17 An alias for 'pveceph pool create'.
21 An alias for 'pveceph mgr destroy'.
25 An alias for 'pveceph mon destroy'.
29 An alias for 'pveceph osd destroy'.
33 An alias for 'pveceph pool destroy'.
35 *pveceph fs create* `[OPTIONS]`
37 Create a Ceph filesystem
39 `--add-storage` `<boolean>` ('default =' `0`)::
41 Configure the created CephFS as storage for this cluster.
43 `--name` `<string>` ('default =' `cephfs`)::
45 The ceph filesystem name.
47 `--pg_num` `<integer> (8 - 32768)` ('default =' `128`)::
49 Number of placement groups for the backing data pool. The metadata pool will use a quarter of this.
51 *pveceph fs destroy* `<name>` `[OPTIONS]`
53 Destroy a Ceph filesystem
55 `<name>`: `<string>` ::
57 The ceph filesystem name.
59 `--remove-pools` `<boolean>` ('default =' `0`)::
61 Remove data and metadata pools configured for this fs.
63 `--remove-storages` `<boolean>` ('default =' `0`)::
65 Remove all pveceph-managed storages configured for this fs.
67 *pveceph help* `[OPTIONS]`
69 Get help about specified command.
71 `--extra-args` `<array>` ::
73 Shows help for a specific command
75 `--verbose` `<boolean>` ::
77 Verbose output format.
79 *pveceph init* `[OPTIONS]`
81 Create initial ceph default configuration and setup symlinks.
83 `--cluster-network` `<string>` ::
85 Declare a separate cluster network, OSDs will routeheartbeat, object replication and recovery traffic over it
87 NOTE: Requires option(s): `network`
89 `--disable_cephx` `<boolean>` ('default =' `0`)::
91 Disable cephx authentication.
93 WARNING: cephx is a security feature protecting against man-in-the-middle attacks. Only consider disabling cephx if your network is private!
95 `--min_size` `<integer> (1 - 7)` ('default =' `2`)::
97 Minimum number of available replicas per object to allow I/O
99 `--network` `<string>` ::
101 Use specific network for all ceph related traffic
103 `--pg_bits` `<integer> (6 - 14)` ('default =' `6`)::
105 Placement group bits, used to specify the default number of placement groups.
107 Depreacted. This setting was deprecated in recent Ceph versions.
109 `--size` `<integer> (1 - 7)` ('default =' `3`)::
111 Targeted number of replicas per object
113 *pveceph install* `[OPTIONS]`
115 Install ceph related packages.
117 `--allow-experimental` `<boolean>` ('default =' `0`)::
119 Allow experimental versions. Use with care!
121 `--repository` `<enterprise | no-subscription | test>` ('default =' `enterprise`)::
123 Ceph repository to use.
125 `--version` `<quincy | reef>` ('default =' `quincy`)::
127 Ceph version to install.
131 An alias for 'pveceph pool ls'.
133 *pveceph mds create* `[OPTIONS]`
135 Create Ceph Metadata Server (MDS)
137 `--hotstandby` `<boolean>` ('default =' `0`)::
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.
141 `--name` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ('default =' `nodename`)::
143 The ID for the mds, when omitted the same as the nodename
145 *pveceph mds destroy* `<name>`
147 Destroy Ceph Metadata Server
149 `<name>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
151 The name (ID) of the mds
153 *pveceph mgr create* `[OPTIONS]`
157 `--id` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
159 The ID for the manager, when omitted the same as the nodename
161 *pveceph mgr destroy* `<id>`
163 Destroy Ceph Manager.
165 `<id>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
167 The ID of the manager
169 *pveceph mon create* `[OPTIONS]`
171 Create Ceph Monitor and Manager
173 `--mon-address` `<string>` ::
175 Overwrites autodetected monitor IP address(es). Must be in the public network(s) of Ceph.
177 `--monid` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
179 The ID for the monitor, when omitted the same as the nodename
181 *pveceph mon destroy* `<monid>`
183 Destroy Ceph Monitor and Manager.
185 `<monid>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
189 *pveceph osd create* `<dev>` `[OPTIONS]`
193 `<dev>`: `<string>` ::
197 `--crush-device-class` `<string>` ::
199 Set the device class of the OSD in crush.
201 `--db_dev` `<string>` ::
203 Block device name for block.db.
205 `--db_dev_size` `<number> (1 - N)` ('default =' `bluestore_block_db_size or 10% of OSD size`)::
207 Size in GiB for block.db.
209 NOTE: Requires option(s): `db_dev`
211 `--encrypted` `<boolean>` ('default =' `0`)::
213 Enables encryption of the OSD.
215 `--osds-per-device` `<integer> (1 - N)` ::
217 OSD services per physical device. Only useful for fast NVMe devices"
218 ." to utilize their performance better.
220 `--wal_dev` `<string>` ::
222 Block device name for block.wal.
224 `--wal_dev_size` `<number> (0.5 - N)` ('default =' `bluestore_block_wal_size or 1% of OSD size`)::
226 Size in GiB for block.wal.
228 NOTE: Requires option(s): `wal_dev`
230 *pveceph osd destroy* `<osdid>` `[OPTIONS]`
234 `<osdid>`: `<integer>` ::
238 `--cleanup` `<boolean>` ('default =' `0`)::
240 If set, we remove partition table entries.
242 *pveceph osd details* `<osdid>` `[OPTIONS]` `[FORMAT_OPTIONS]`
246 `<osdid>`: `<string>` ::
250 `--verbose` `<boolean>` ('default =' `0`)::
252 Print verbose information, same as json-pretty output format.
254 *pveceph pool create* `<name>` `[OPTIONS]`
258 `<name>`: `<string>` ::
260 The name of the pool. It must be unique.
262 `--add_storages` `<boolean>` ('default =' `0; for erasure coded pools: 1`)::
264 Configure VM and CT storage using the new pool.
266 `--application` `<cephfs | rbd | rgw>` ('default =' `rbd`)::
268 The application of the pool.
270 `--crush_rule` `<string>` ::
272 The rule to use for mapping object placement in the cluster.
274 `--erasure-coding` `k=<integer> ,m=<integer> [,device-class=<class>] [,failure-domain=<domain>] [,profile=<profile>]` ::
276 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.
278 `--min_size` `<integer> (1 - 7)` ('default =' `2`)::
280 Minimum number of replicas per object
282 `--pg_autoscale_mode` `<off | on | warn>` ('default =' `warn`)::
284 The automatic PG scaling mode of the pool.
286 `--pg_num` `<integer> (1 - 32768)` ('default =' `128`)::
288 Number of placement groups.
290 `--pg_num_min` `<integer> (-N - 32768)` ::
292 Minimal number of placement groups.
294 `--size` `<integer> (1 - 7)` ('default =' `3`)::
296 Number of replicas per object
298 `--target_size` `^(\d+(\.\d+)?)([KMGT])?$` ::
300 The estimated target size of the pool for the PG autoscaler.
302 `--target_size_ratio` `<number>` ::
304 The estimated target ratio of the pool for the PG autoscaler.
306 *pveceph pool destroy* `<name>` `[OPTIONS]`
310 `<name>`: `<string>` ::
312 The name of the pool. It must be unique.
314 `--force` `<boolean>` ('default =' `0`)::
316 If true, destroys pool even if in use
318 `--remove_ecprofile` `<boolean>` ('default =' `1`)::
320 Remove the erasure code profile. Defaults to true, if applicable.
322 `--remove_storages` `<boolean>` ('default =' `0`)::
324 Remove all pveceph-managed storages configured for this pool
326 *pveceph pool get* `<name>` `[OPTIONS]` `[FORMAT_OPTIONS]`
328 Show the current pool status.
330 `<name>`: `<string>` ::
332 The name of the pool. It must be unique.
334 `--verbose` `<boolean>` ('default =' `0`)::
336 If enabled, will display additional data(eg. statistics).
338 *pveceph pool ls* `[FORMAT_OPTIONS]`
340 List all pools and their settings (which are settable by the POST/PUT
343 *pveceph pool set* `<name>` `[OPTIONS]`
347 `<name>`: `<string>` ::
349 The name of the pool. It must be unique.
351 `--application` `<cephfs | rbd | rgw>` ::
353 The application of the pool.
355 `--crush_rule` `<string>` ::
357 The rule to use for mapping object placement in the cluster.
359 `--min_size` `<integer> (1 - 7)` ::
361 Minimum number of replicas per object
363 `--pg_autoscale_mode` `<off | on | warn>` ::
365 The automatic PG scaling mode of the pool.
367 `--pg_num` `<integer> (1 - 32768)` ::
369 Number of placement groups.
371 `--pg_num_min` `<integer> (-N - 32768)` ::
373 Minimal number of placement groups.
375 `--size` `<integer> (1 - 7)` ::
377 Number of replicas per object
379 `--target_size` `^(\d+(\.\d+)?)([KMGT])?$` ::
381 The estimated target size of the pool for the PG autoscaler.
383 `--target_size_ratio` `<number>` ::
385 The estimated target ratio of the pool for the PG autoscaler.
387 *pveceph purge* `[OPTIONS]`
389 Destroy ceph related data and configuration files.
391 `--crash` `<boolean>` ::
393 Additionally purge Ceph crash logs, /var/lib/ceph/crash.
395 `--logs` `<boolean>` ::
397 Additionally purge Ceph logs, /var/log/ceph.
399 *pveceph start* `[OPTIONS]`
403 `--service` `(ceph|mon|mds|osd|mgr)(\.[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?)?` ('default =' `ceph.target`)::
411 *pveceph stop* `[OPTIONS]`
415 `--service` `(ceph|mon|mds|osd|mgr)(\.[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?)?` ('default =' `ceph.target`)::