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 NOTE: 'osd pool default pg num' does not work for default pools.
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 `--test-repository` `<boolean>` ('default =' `0`)::
123 Use the test, not the main repository. Use with care!
125 `--version` `<octopus | pacific>` ('default =' `pacific`)::
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 `--wal_dev` `<string>` ::
217 Block device name for block.wal.
219 `--wal_dev_size` `<number> (0.5 - N)` ('default =' `bluestore_block_wal_size or 1% of OSD size`)::
221 Size in GiB for block.wal.
223 NOTE: Requires option(s): `wal_dev`
225 *pveceph osd destroy* `<osdid>` `[OPTIONS]`
229 `<osdid>`: `<integer>` ::
233 `--cleanup` `<boolean>` ('default =' `0`)::
235 If set, we remove partition table entries.
237 *pveceph pool create* `<name>` `[OPTIONS]`
241 `<name>`: `<string>` ::
243 The name of the pool. It must be unique.
245 `--add_storages` `<boolean>` ::
247 Configure VM and CT storage using the new pool.
249 `--application` `<cephfs | rbd | rgw>` ('default =' `rbd`)::
251 The application of the pool.
253 `--crush_rule` `<string>` ::
255 The rule to use for mapping object placement in the cluster.
257 `--min_size` `<integer> (1 - 7)` ('default =' `2`)::
259 Minimum number of replicas per object
261 `--pg_autoscale_mode` `<off | on | warn>` ('default =' `warn`)::
263 The automatic PG scaling mode of the pool.
265 `--pg_num` `<integer> (1 - 32768)` ('default =' `128`)::
267 Number of placement groups.
269 `--pg_num_min` `<integer> (-N - 32768)` ::
271 Minimal number of placement groups.
273 `--size` `<integer> (1 - 7)` ('default =' `3`)::
275 Number of replicas per object
277 `--target_size` `^(\d+(\.\d+)?)([KMGT])?$` ::
279 The estimated target size of the pool for the PG autoscaler.
281 `--target_size_ratio` `<number>` ::
283 The estimated target ratio of the pool for the PG autoscaler.
285 *pveceph pool destroy* `<name>` `[OPTIONS]`
289 `<name>`: `<string>` ::
291 The name of the pool. It must be unique.
293 `--force` `<boolean>` ('default =' `0`)::
295 If true, destroys pool even if in use
297 `--remove_storages` `<boolean>` ('default =' `0`)::
299 Remove all pveceph-managed storages configured for this pool
301 *pveceph pool get* `<name>` `[OPTIONS]` `[FORMAT_OPTIONS]`
305 `<name>`: `<string>` ::
307 The name of the pool. It must be unique.
309 `--verbose` `<boolean>` ('default =' `0`)::
311 If enabled, will display additional data(eg. statistics).
313 *pveceph pool ls* `[FORMAT_OPTIONS]`
317 *pveceph pool set* `<name>` `[OPTIONS]`
321 `<name>`: `<string>` ::
323 The name of the pool. It must be unique.
325 `--application` `<cephfs | rbd | rgw>` ::
327 The application of the pool.
329 `--crush_rule` `<string>` ::
331 The rule to use for mapping object placement in the cluster.
333 `--min_size` `<integer> (1 - 7)` ::
335 Minimum number of replicas per object
337 `--pg_autoscale_mode` `<off | on | warn>` ::
339 The automatic PG scaling mode of the pool.
341 `--pg_num` `<integer> (1 - 32768)` ::
343 Number of placement groups.
345 `--pg_num_min` `<integer> (-N - 32768)` ::
347 Minimal number of placement groups.
349 `--size` `<integer> (1 - 7)` ::
351 Number of replicas per object
353 `--target_size` `^(\d+(\.\d+)?)([KMGT])?$` ::
355 The estimated target size of the pool for the PG autoscaler.
357 `--target_size_ratio` `<number>` ::
359 The estimated target ratio of the pool for the PG autoscaler.
361 *pveceph purge* `[OPTIONS]`
363 Destroy ceph related data and configuration files.
365 `--crash` `<boolean>` ::
367 Additionally purge Ceph crash logs, /var/lib/ceph/crash.
369 `--logs` `<boolean>` ::
371 Additionally purge Ceph logs, /var/log/ceph.
373 *pveceph start* `[OPTIONS]`
377 `--service` `(ceph|mon|mds|osd|mgr)(\.[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?)?` ('default =' `ceph.target`)::
385 *pveceph stop* `[OPTIONS]`
389 `--service` `(ceph|mon|mds|osd|mgr)(\.[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?)?` ('default =' `ceph.target`)::