]> git.proxmox.com Git - pve-docs.git/blame - pveceph.1-synopsis.adoc
fix #1959: remove any information regarding 'auto'
[pve-docs.git] / pveceph.1-synopsis.adoc
CommitLineData
0840a663
DM
1*pveceph* `<COMMAND> [ARGS] [OPTIONS]`
2
2489d6df 3*pveceph createmgr* `[OPTIONS]`
0840a663 4
2489d6df
WB
5Create Ceph Manager
6
7`--id` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
8
9The ID for the manager, when omitted the same as the nodename
10
2489d6df
WB
11*pveceph createmon* `[OPTIONS]`
12
13Create Ceph Monitor and Manager
14
15`--exclude-manager` `<boolean>` ('default =' `0`)::
16
17When set, only a monitor will be created.
18
19`--id` `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
20
21The ID for the monitor, when omitted the same as the nodename
0840a663 22
35a75dd3 23`--mon-address` `<string>` ::
0840a663 24
35a75dd3 25Overwrites autodetected monitor IP address. Must be in the public network of ceph.
0840a663
DM
26
27*pveceph createosd* `<dev>` `[OPTIONS]`
28
29Create OSD
30
013dc89f 31`<dev>`: `<string>` ::
0840a663
DM
32
33Block device name.
34
35a75dd3 35`--bluestore` `<boolean>` ('default =' `1`)::
5d9c884c 36
35a75dd3 37Use bluestore instead of filestore. This is the default.
5d9c884c 38
4d47f125 39`--fstype` `<ext4 | xfs>` ('default =' `xfs`)::
0840a663 40
5d9c884c 41File system type (filestore only).
0840a663 42
2489d6df 43`--journal_dev` `<string>` ::
0840a663 44
2489d6df
WB
45Block device name for journal (filestore) or block.db (bluestore).
46
47`--wal_dev` `<string>` ::
48
49Block device name for block.wal (bluestore only).
0840a663 50
0840a663
DM
51*pveceph createpool* `<name>` `[OPTIONS]`
52
53Create POOL
54
013dc89f 55`<name>`: `<string>` ::
0840a663
DM
56
57The name of the pool. It must be unique.
58
2489d6df
WB
59`--add_storages` `<boolean>` ::
60
61Configure VM and CT storages using the new pool.
0840a663 62
2489d6df 63`--application` `<cephfs | rbd | rgw>` ::
0840a663 64
2489d6df
WB
65The application of the pool, 'rbd' by default.
66
67`--crush_rule` `<string>` ::
68
69The rule to use for mapping object placement in the cluster.
70
71`--min_size` `<integer> (1 - 7)` ('default =' `2`)::
0840a663
DM
72
73Minimum number of replicas per object
74
2489d6df 75`--pg_num` `<integer> (8 - 32768)` ('default =' `64`)::
0840a663
DM
76
77Number of placement groups.
78
2489d6df 79`--size` `<integer> (1 - 7)` ('default =' `3`)::
0840a663
DM
80
81Number of replicas per object
82
2489d6df
WB
83*pveceph destroymgr* `<id>`
84
85Destroy Ceph Manager.
86
87`<id>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
88
89The ID of the manager
90
2489d6df
WB
91*pveceph destroymon* `<monid>` `[OPTIONS]`
92
93Destroy Ceph Monitor and Manager.
94
95`<monid>`: `[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?` ::
0840a663
DM
96
97Monitor ID
98
2489d6df
WB
99`--exclude-manager` `<boolean>` ('default =' `0`)::
100
101When set, removes only the monitor, not the manager
102
0840a663
DM
103*pveceph destroyosd* `<osdid>` `[OPTIONS]`
104
105Destroy OSD
106
013dc89f 107`<osdid>`: `<integer>` ::
0840a663
DM
108
109OSD ID
110
2489d6df 111`--cleanup` `<boolean>` ('default =' `0`)::
0840a663
DM
112
113If set, we remove partition table entries.
114
2c0dde61 115*pveceph destroypool* `<name>` `[OPTIONS]`
0840a663
DM
116
117Destroy pool
118
013dc89f 119`<name>`: `<string>` ::
0840a663
DM
120
121The name of the pool. It must be unique.
122
2489d6df 123`--force` `<boolean>` ('default =' `0`)::
2c0dde61
DM
124
125If true, destroys pool even if in use
126
2489d6df
WB
127`--remove_storages` `<boolean>` ('default =' `0`)::
128
129Remove all pveceph-managed storages configured for this pool
130
35a75dd3 131*pveceph help* `[OPTIONS]`
0840a663
DM
132
133Get help about specified command.
134
35a75dd3 135`--extra-args` `<array>` ::
0840a663 136
35a75dd3 137Shows help for a specific command
0840a663 138
2489d6df 139`--verbose` `<boolean>` ::
0840a663
DM
140
141Verbose output format.
142
0840a663
DM
143*pveceph init* `[OPTIONS]`
144
145Create initial ceph default configuration and setup symlinks.
146
2489d6df 147`--disable_cephx` `<boolean>` ('default =' `0`)::
5d9c884c
DM
148
149Disable cephx authentification.
150+
151WARNING: cephx is a security feature protecting against man-in-the-middle attacks. Only consider disabling cephx if your network is private!
152
2489d6df 153`--min_size` `<integer> (1 - 7)` ('default =' `2`)::
5d9c884c
DM
154
155Minimum number of available replicas per object to allow I/O
156
2489d6df 157`--network` `<string>` ::
0840a663
DM
158
159Use specific network for all ceph related traffic
160
2489d6df 161`--pg_bits` `<integer> (6 - 14)` ('default =' `6`)::
0840a663 162
c2993fe5 163Placement group bits, used to specify the default number of placement groups.
04ce4dfa
DM
164+
165NOTE: 'osd pool default pg num' does not work for default pools.
0840a663 166
2489d6df 167`--size` `<integer> (1 - 7)` ('default =' `3`)::
0840a663 168
5d9c884c 169Targeted number of replicas per object
0840a663 170
0840a663
DM
171*pveceph install* `[OPTIONS]`
172
173Install ceph related packages.
174
2489d6df 175`--version` `<luminous>` ::
0840a663
DM
176
177no description available
178
0840a663
DM
179*pveceph lspools*
180
181List all pools.
182
0840a663
DM
183*pveceph purge*
184
185Destroy ceph related data and configuration files.
186
0840a663
DM
187*pveceph start* `[<service>]`
188
189Start ceph services.
190
2489d6df 191`<service>`: `(mon|mds|osd|mgr)\.[A-Za-z0-9\-]{1,32}` ::
0840a663
DM
192
193Ceph service name.
194
0840a663
DM
195*pveceph status*
196
197Get ceph status.
198
0840a663
DM
199*pveceph stop* `[<service>]`
200
201Stop ceph services.
202
2489d6df 203`<service>`: `(mon|mds|osd|mgr)\.[A-Za-z0-9\-]{1,32}` ::
0840a663
DM
204
205Ceph service name.
206
207