*pveceph* `<COMMAND> [ARGS] [OPTIONS]`
+*pveceph createmgr*
+
+An alias for 'pveceph mgr create'.
+
*pveceph createmon*
-Create Ceph Monitor
+An alias for 'pveceph mon create'.
+*pveceph createosd*
+An alias for 'pveceph osd create'.
+*pveceph createpool*
-*pveceph createosd* `<dev>` `[OPTIONS]`
+An alias for 'pveceph pool create'.
-Create OSD
+*pveceph destroymgr*
-`<dev>`: `<string>` ::
+An alias for 'pveceph mgr destroy'.
-Block device name.
+*pveceph destroymon*
-`-fstype` `<btrfs | ext4 | xfs>` ('default =' `xfs`)::
+An alias for 'pveceph mon destroy'.
-File system type.
+*pveceph destroyosd*
-`-journal_dev` `<string>` ::
+An alias for 'pveceph osd destroy'.
-Block device name for journal.
+*pveceph destroypool*
+An alias for 'pveceph pool destroy'.
+*pveceph fs create* `[OPTIONS]`
+Create a Ceph filesystem
-*pveceph createpool* `<name>` `[OPTIONS]`
+`--add-storage` `<boolean>` ('default =' `0`)::
-Create POOL
+Configure the created CephFS as storage for this cluster.
-`<name>`: `<string>` ::
+`--name` `<string>` ('default =' `cephfs`)::
-The name of the pool. It must be unique.
+The ceph filesystem name.
-`-crush_ruleset` `<integer> (0 - 32768)` ('default =' `0`)::
+`--pg_num` `<integer> (8 - 32768)` ('default =' `128`)::
-The ruleset to use for mapping object placement in the cluster.
+Number of placement groups for the backing data pool. The metadata pool will use a quarter of this.
-`-min_size` `<integer> (1 - 3)` ('default =' `1`)::
+*pveceph help* `[OPTIONS]`
-Minimum number of replicas per object
+Get help about specified command.
-`-pg_num` `<integer> (8 - 32768)` ('default =' `64`)::
+`--extra-args` `<array>` ::
-Number of placement groups.
+Shows help for a specific command
-`-size` `<integer> (1 - 3)` ('default =' `2`)::
+`--verbose` `<boolean>` ::
-Number of replicas per object
+Verbose output format.
+
+*pveceph init* `[OPTIONS]`
+Create initial ceph default configuration and setup symlinks.
+`--cluster-network` `<string>` ::
-*pveceph destroymon* `<monid>`
+Declare a separate cluster network, OSDs will routeheartbeat, object replication and recovery traffic over it
++
+NOTE: Requires option(s): `network`
-Destroy Ceph monitor.
+`--disable_cephx` `<boolean>` ('default =' `0`)::
-`<monid>`: `<integer>` ::
+Disable cephx authentification.
++
+WARNING: cephx is a security feature protecting against man-in-the-middle attacks. Only consider disabling cephx if your network is private!
-Monitor ID
+`--min_size` `<integer> (1 - 7)` ('default =' `2`)::
+Minimum number of available replicas per object to allow I/O
+`--network` `<string>` ::
+Use specific network for all ceph related traffic
-*pveceph destroyosd* `<osdid>` `[OPTIONS]`
+`--pg_bits` `<integer> (6 - 14)` ('default =' `6`)::
-Destroy OSD
+Placement group bits, used to specify the default number of placement groups.
++
+NOTE: 'osd pool default pg num' does not work for default pools.
-`<osdid>`: `<integer>` ::
+`--size` `<integer> (1 - 7)` ('default =' `3`)::
-OSD ID
+Targeted number of replicas per object
-`-cleanup` `<boolean>` ('default =' `0`)::
+*pveceph install* `[OPTIONS]`
-If set, we remove partition table entries.
+Install ceph related packages.
+`--version` `<luminous>` ::
+no description available
+*pveceph lspools*
-*pveceph destroypool* `<name>` `[OPTIONS]`
+An alias for 'pveceph pool ls'.
-Destroy pool
+*pveceph mds create* `[OPTIONS]`
-`<name>`: `<string>` ::
+Create Ceph Metadata Server (MDS)
-The name of the pool. It must be unique.
+`--hotstandby` `<boolean>` ('default =' `0`)::
-`-force` `<boolean>` ('default =' `0`)::
+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.
-If true, destroys pool even if in use
+`--name` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ('default =' `nodename`)::
+The ID for the mds, when omitted the same as the nodename
+*pveceph mds destroy* `<name>`
+Destroy Ceph Metadata Server
-*pveceph help* `[<cmd>]` `[OPTIONS]`
+`<name>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
-Get help about specified command.
+The name (ID) of the mds
-`<cmd>`: `<string>` ::
+*pveceph mgr create* `[OPTIONS]`
-Command name
+Create Ceph Manager
-`-verbose` `<boolean>` ::
+`--id` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
-Verbose output format.
+The ID for the manager, when omitted the same as the nodename
+*pveceph mgr destroy* `<id>`
+Destroy Ceph Manager.
+`<id>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
-*pveceph init* `[OPTIONS]`
+The ID of the manager
-Create initial ceph default configuration and setup symlinks.
+*pveceph mon create* `[OPTIONS]`
-`-network` `<string>` ::
+Create Ceph Monitor and Manager
-Use specific network for all ceph related traffic
+`--exclude-manager` `<boolean>` ('default =' `0`)::
-`-pg_bits` `<integer> (6 - 14)` ('default =' `6`)::
+When set, only a monitor will be created.
-Placement group bits, used to specify the default number of placement groups.
-+
-NOTE: 'osd pool default pg num' does not work for default pools.
+`--id` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
-`-size` `<integer> (1 - 3)` ('default =' `2`)::
+The ID for the monitor, when omitted the same as the nodename
-Number of replicas per object
+`--mon-address` `<string>` ::
+Overwrites autodetected monitor IP address. Must be in the public network of ceph.
+*pveceph mon destroy* `<monid>` `[OPTIONS]`
+Destroy Ceph Monitor and Manager.
-*pveceph install* `[OPTIONS]`
+`<monid>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
-Install ceph related packages.
+Monitor ID
-`-version` `<hammer | jewel>` ::
+`--exclude-manager` `<boolean>` ('default =' `0`)::
-no description available
+When set, removes only the monitor, not the manager
+*pveceph osd create* `<dev>` `[OPTIONS]`
+Create OSD
+`<dev>`: `<string>` ::
-*pveceph lspools*
+Block device name.
-List all pools.
+`--bluestore` `<boolean>` ('default =' `1`)::
+Use bluestore instead of filestore. This is the default.
+`--fstype` `<ext4 | xfs>` ('default =' `xfs`)::
+File system type (filestore only).
-*pveceph purge*
+`--journal_dev` `<string>` ::
-Destroy ceph related data and configuration files.
+Block device name for journal (filestore) or block.db (bluestore).
+`--wal_dev` `<string>` ::
+Block device name for block.wal (bluestore only).
+*pveceph osd destroy* `<osdid>` `[OPTIONS]`
+
+Destroy OSD
+
+`<osdid>`: `<integer>` ::
+
+OSD ID
+
+`--cleanup` `<boolean>` ('default =' `0`)::
+
+If set, we remove partition table entries.
+
+*pveceph pool create* `<name>` `[OPTIONS]`
+
+Create POOL
+
+`<name>`: `<string>` ::
+
+The name of the pool. It must be unique.
+
+`--add_storages` `<boolean>` ::
+
+Configure VM and CT storage using the new pool.
+
+`--application` `<cephfs | rbd | rgw>` ::
+
+The application of the pool, 'rbd' by default.
+
+`--crush_rule` `<string>` ::
+
+The rule to use for mapping object placement in the cluster.
+
+`--min_size` `<integer> (1 - 7)` ('default =' `2`)::
+
+Minimum number of replicas per object
+
+`--pg_num` `<integer> (8 - 32768)` ('default =' `128`)::
+
+Number of placement groups.
+
+`--size` `<integer> (1 - 7)` ('default =' `3`)::
+
+Number of replicas per object
+
+*pveceph pool destroy* `<name>` `[OPTIONS]`
+
+Destroy pool
+
+`<name>`: `<string>` ::
+
+The name of the pool. It must be unique.
+
+`--force` `<boolean>` ('default =' `0`)::
+
+If true, destroys pool even if in use
+
+`--remove_storages` `<boolean>` ('default =' `0`)::
+
+Remove all pveceph-managed storages configured for this pool
+
+*pveceph pool ls*
+
+List all pools.
+
+*pveceph purge*
+
+Destroy ceph related data and configuration files.
*pveceph start* `[<service>]`
Start ceph services.
-`<service>`: `(mon|mds|osd)\.[A-Za-z0-9]{1,32}` ::
+`<service>`: `(mon|mds|osd|mgr)\.[A-Za-z0-9\-]{1,32}` ('default =' `ceph.target`)::
Ceph service name.
-
-
*pveceph status*
Get ceph status.
-
-
*pveceph stop* `[<service>]`
Stop ceph services.
-`<service>`: `(mon|mds|osd)\.[A-Za-z0-9]{1,32}` ::
+`<service>`: `(mon|mds|osd|mgr)\.[A-Za-z0-9\-]{1,32}` ('default =' `ceph.target`)::
Ceph service name.
-
-