]> git.proxmox.com Git - pve-docs.git/blame - pvesm.1-synopsis.adoc
pvecm: fix wrong quorum numbers
[pve-docs.git] / pvesm.1-synopsis.adoc
CommitLineData
1f554f76
DM
1*pvesm* `<COMMAND> [ARGS] [OPTIONS]`
2
3*pvesm add* `<type> <storage>` `[OPTIONS]`
4
5Create a new storage.
6
e2d681b3 7`<type>`: `<cephfs | cifs | dir | drbd | fake | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | rbd | sheepdog | zfs | zfspool>` ::
1f554f76
DM
8
9Storage type.
10
013dc89f 11`<storage>`: `<string>` ::
1f554f76
DM
12
13The storage identifier.
14
2489d6df 15`--authsupported` `<string>` ::
1f554f76
DM
16
17Authsupported.
18
2489d6df 19`--base` `<string>` ::
1f554f76
DM
20
21Base volume. This volume is automatically activated.
22
2489d6df 23`--blocksize` `<string>` ::
1f554f76
DM
24
25block size
26
27a7acb2
DM
27`--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
28
29Set bandwidth/io limits various operations.
30
2489d6df 31`--comstar_hg` `<string>` ::
1f554f76
DM
32
33host group for comstar views
34
2489d6df 35`--comstar_tg` `<string>` ::
1f554f76
DM
36
37target group for comstar views
38
2489d6df 39`--content` `<string>` ::
1f554f76 40
04ce4dfa
DM
41Allowed content types.
42+
c2993fe5 43NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
1f554f76 44
2489d6df 45`--disable` `<boolean>` ::
1f554f76
DM
46
47Flag to disable the storage.
48
27a7acb2
DM
49`--domain` `<string>` ::
50
51CIFS domain.
52
2489d6df 53`--export` `<string>` ::
1f554f76
DM
54
55NFS export path.
56
2489d6df 57`--format` `<string>` ::
1f554f76 58
04ce4dfa 59Default image format.
1f554f76 60
5da3d723
TL
61`--fuse` `<boolean>` ::
62
63Mount CephFS through FUSE.
64
2489d6df 65`--is_mountpoint` `<string>` ('default =' `no`)::
2c0dde61 66
2489d6df 67Assume the given path is an externally managed mountpoint and consider the storage offline if it is not mounted. Using a boolean (yes/no) value serves as a shortcut to using the target path in this field.
2c0dde61 68
2489d6df 69`--iscsiprovider` `<string>` ::
1f554f76
DM
70
71iscsi provider
72
2489d6df 73`--krbd` `<boolean>` ::
1f554f76 74
e2d681b3 75Always access rbd through krbd kernel module.
1f554f76 76
4d47f125
TL
77`--lio_tpg` `<string>` ::
78
79target portal group for Linux LIO targets
80
2489d6df 81`--maxfiles` `<integer> (0 - N)` ::
1f554f76
DM
82
83Maximal number of backup files per VM. Use '0' for unlimted.
84
2489d6df 85`--mkdir` `<boolean>` ('default =' `yes`)::
2c0dde61
DM
86
87Create the directory if it doesn't exist.
88
2489d6df 89`--monhost` `<string>` ::
1f554f76 90
2489d6df 91IP addresses of monitors (for external clusters).
1f554f76 92
2489d6df 93`--nodes` `<string>` ::
1f554f76
DM
94
95List of cluster node names.
96
2489d6df 97`--nowritecache` `<boolean>` ::
1f554f76
DM
98
99disable write caching on the target
100
2489d6df 101`--options` `<string>` ::
1f554f76
DM
102
103NFS mount options (see 'man nfs')
104
5da3d723 105`--password` `<password>` ::
27a7acb2
DM
106
107Password for CIFS share.
108
2489d6df 109`--path` `<string>` ::
1f554f76
DM
110
111File system path.
112
2489d6df 113`--pool` `<string>` ::
1f554f76
DM
114
115Pool.
116
2489d6df 117`--portal` `<string>` ::
1f554f76
DM
118
119iSCSI portal (IP or DNS name with optional port).
120
2489d6df 121`--redundancy` `<integer> (1 - 16)` ('default =' `2`)::
1f554f76 122
c2993fe5 123The redundancy count specifies the number of nodes to which the resource should be deployed. It must be at least 1 and at most the number of nodes in the cluster.
1f554f76 124
2489d6df 125`--saferemove` `<boolean>` ::
1f554f76
DM
126
127Zero-out data when removing LVs.
128
2489d6df 129`--saferemove_throughput` `<string>` ::
1f554f76
DM
130
131Wipe throughput (cstream -t parameter value).
132
2489d6df 133`--server` `<string>` ::
1f554f76
DM
134
135Server IP or DNS name.
136
2489d6df 137`--server2` `<string>` ::
1f554f76
DM
138
139Backup volfile server IP or DNS name.
140+
141NOTE: Requires option(s): `server`
142
27a7acb2
DM
143`--share` `<string>` ::
144
145CIFS share.
146
2489d6df 147`--shared` `<boolean>` ::
1f554f76
DM
148
149Mark storage as shared.
150
5da3d723 151`--smbversion` `<2.0 | 2.1 | 3.0>` ::
27a7acb2 152
5da3d723 153SMB protocol version
27a7acb2 154
2489d6df 155`--sparse` `<boolean>` ::
1f554f76
DM
156
157use sparse volumes
158
5da3d723
TL
159`--subdir` `<string>` ::
160
161Subdir to mount.
162
2489d6df 163`--tagged_only` `<boolean>` ::
2c0dde61
DM
164
165Only use logical volumes tagged with 'pve-vm-ID'.
166
2489d6df 167`--target` `<string>` ::
1f554f76
DM
168
169iSCSI target.
170
2489d6df 171`--thinpool` `<string>` ::
1f554f76
DM
172
173LVM thin pool LV name.
174
2489d6df 175`--transport` `<rdma | tcp | unix>` ::
1f554f76
DM
176
177Gluster transport: tcp or rdma
178
2489d6df 179`--username` `<string>` ::
1f554f76
DM
180
181RBD Id.
182
2489d6df 183`--vgname` `<string>` ::
1f554f76
DM
184
185Volume group name.
186
2489d6df 187`--volume` `<string>` ::
1f554f76
DM
188
189Glusterfs Volume.
190
1f554f76
DM
191*pvesm alloc* `<storage> <vmid> <filename> <size>` `[OPTIONS]`
192
193Allocate disk images.
194
013dc89f 195`<storage>`: `<string>` ::
1f554f76
DM
196
197The storage identifier.
198
013dc89f 199`<vmid>`: `<integer> (1 - N)` ::
1f554f76
DM
200
201Specify owner VM
202
013dc89f 203`<filename>`: `<string>` ::
1f554f76
DM
204
205The name of the file to create.
206
013dc89f 207`<size>`: `\d+[MG]?` ::
1f554f76 208
c2993fe5 209Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M)
1f554f76 210
2489d6df 211`--format` `<qcow2 | raw | subvol>` ::
1f554f76
DM
212
213no description available
214+
215NOTE: Requires option(s): `size`
216
e2d681b3 217*pvesm cifsscan*
27a7acb2 218
e2d681b3 219An alias for 'pvesm scan cifs'.
27a7acb2 220
5d9c884c
DM
221*pvesm export* `<volume> <format> <filename>` `[OPTIONS]`
222
223Export a volume.
224
225`<volume>`: `<string>` ::
226
227Volume identifier
228
229`<format>`: `<qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
230
231Export stream format
232
233`<filename>`: `<string>` ::
234
235Destination file name
236
2489d6df 237`--base` `(?^:[a-z0-9_\-]{1,40})` ::
5d9c884c
DM
238
239Snapshot to start an incremental stream from
240
2489d6df 241`--snapshot` `(?^:[a-z0-9_\-]{1,40})` ::
5d9c884c
DM
242
243Snapshot to export
244
2489d6df 245`--with-snapshots` `<boolean>` ('default =' `0`)::
5d9c884c
DM
246
247Whether to include intermediate snapshots in the stream
248
2c0dde61
DM
249*pvesm extractconfig* `<volume>`
250
251Extract configuration from vzdump backup archive.
252
013dc89f 253`<volume>`: `<string>` ::
2c0dde61
DM
254
255Volume identifier
256
1f554f76
DM
257*pvesm free* `<volume>` `[OPTIONS]`
258
259Delete volume
260
013dc89f 261`<volume>`: `<string>` ::
1f554f76
DM
262
263Volume identifier
264
2489d6df 265`--storage` `<string>` ::
1f554f76
DM
266
267The storage identifier.
268
e2d681b3 269*pvesm glusterfsscan*
1f554f76 270
e2d681b3 271An alias for 'pvesm scan glusterfs'.
1f554f76 272
35a75dd3 273*pvesm help* `[OPTIONS]`
1f554f76
DM
274
275Get help about specified command.
276
35a75dd3 277`--extra-args` `<array>` ::
1f554f76 278
35a75dd3 279Shows help for a specific command
1f554f76 280
2489d6df 281`--verbose` `<boolean>` ::
1f554f76
DM
282
283Verbose output format.
284
5d9c884c
DM
285*pvesm import* `<volume> <format> <filename>` `[OPTIONS]`
286
287Import a volume.
288
289`<volume>`: `<string>` ::
290
291Volume identifier
292
293`<format>`: `<qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
294
295Import stream format
296
297`<filename>`: `<string>` ::
298
299Source file name
300
2489d6df 301`--base` `(?^:[a-z0-9_\-]{1,40})` ::
5d9c884c
DM
302
303Base snapshot of an incremental stream
304
2489d6df 305`--delete-snapshot` `(?^:[a-z0-9_\-]{1,80})` ::
5d9c884c
DM
306
307A snapshot to delete on success
308
2489d6df 309`--with-snapshots` `<boolean>` ('default =' `0`)::
5d9c884c
DM
310
311Whether the stream includes intermediate snapshots
312
e2d681b3 313*pvesm iscsiscan*
1f554f76 314
e2d681b3 315An alias for 'pvesm scan iscsi'.
1f554f76 316
1f554f76
DM
317*pvesm list* `<storage>` `[OPTIONS]`
318
319List storage content.
320
013dc89f 321`<storage>`: `<string>` ::
1f554f76
DM
322
323The storage identifier.
324
2489d6df 325`--content` `<string>` ::
1f554f76
DM
326
327Only list content of this type.
328
2489d6df 329`--vmid` `<integer> (1 - N)` ::
1f554f76
DM
330
331Only list images for this VM
332
1f554f76
DM
333*pvesm lvmscan*
334
e2d681b3 335An alias for 'pvesm scan lvm'.
9b3e4991 336
e2d681b3 337*pvesm lvmthinscan*
9b3e4991 338
e2d681b3 339An alias for 'pvesm scan lvmthin'.
9b3e4991 340
e2d681b3 341*pvesm nfsscan*
1f554f76 342
e2d681b3 343An alias for 'pvesm scan nfs'.
1f554f76 344
1f554f76
DM
345*pvesm path* `<volume>`
346
347Get filesystem path for specified volume
348
013dc89f 349`<volume>`: `<string>` ::
1f554f76
DM
350
351Volume identifier
352
1f554f76
DM
353*pvesm remove* `<storage>`
354
355Delete storage configuration.
356
013dc89f 357`<storage>`: `<string>` ::
1f554f76
DM
358
359The storage identifier.
360
e2d681b3
TL
361*pvesm scan cifs* `<server>` `[OPTIONS]`
362
363Scan remote CIFS server.
364
365`<server>`: `<string>` ::
366
367The server address (name or IP).
368
369`--domain` `<string>` ::
370
371SMB domain (Workgroup).
372
373`--password` `<password>` ::
374
375User password.
376
377`--username` `<string>` ::
378
379User name.
380
381*pvesm scan glusterfs* `<server>`
382
383Scan remote GlusterFS server.
384
385`<server>`: `<string>` ::
386
387The server address (name or IP).
388
389*pvesm scan iscsi* `<portal>`
390
391Scan remote iSCSI server.
392
393`<portal>`: `<string>` ::
394
395The iSCSI portal (IP or DNS name with optional port).
396
397*pvesm scan lvm*
398
399List local LVM volume groups.
400
401*pvesm scan lvmthin* `<vg>`
402
403List local LVM Thin Pools.
404
405`<vg>`: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` ::
406
407no description available
408
409*pvesm scan nfs* `<server>`
410
411Scan remote NFS server.
412
413`<server>`: `<string>` ::
414
415The server address (name or IP).
416
417*pvesm scan zfs*
418
419Scan zfs pool list on local node.
420
1f554f76
DM
421*pvesm set* `<storage>` `[OPTIONS]`
422
423Update storage configuration.
424
013dc89f 425`<storage>`: `<string>` ::
1f554f76
DM
426
427The storage identifier.
428
2489d6df 429`--blocksize` `<string>` ::
1f554f76
DM
430
431block size
432
27a7acb2
DM
433`--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
434
435Set bandwidth/io limits various operations.
436
2489d6df 437`--comstar_hg` `<string>` ::
1f554f76
DM
438
439host group for comstar views
440
2489d6df 441`--comstar_tg` `<string>` ::
1f554f76
DM
442
443target group for comstar views
444
2489d6df 445`--content` `<string>` ::
1f554f76 446
04ce4dfa
DM
447Allowed content types.
448+
c2993fe5 449NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
1f554f76 450
2489d6df 451`--delete` `<string>` ::
1f554f76
DM
452
453A list of settings you want to delete.
454
2489d6df 455`--digest` `<string>` ::
1f554f76 456
c2993fe5 457Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
1f554f76 458
2489d6df 459`--disable` `<boolean>` ::
1f554f76
DM
460
461Flag to disable the storage.
462
27a7acb2
DM
463`--domain` `<string>` ::
464
465CIFS domain.
466
2489d6df 467`--format` `<string>` ::
1f554f76 468
04ce4dfa 469Default image format.
1f554f76 470
5da3d723
TL
471`--fuse` `<boolean>` ::
472
473Mount CephFS through FUSE.
474
2489d6df 475`--is_mountpoint` `<string>` ('default =' `no`)::
2c0dde61 476
2489d6df 477Assume the given path is an externally managed mountpoint and consider the storage offline if it is not mounted. Using a boolean (yes/no) value serves as a shortcut to using the target path in this field.
2c0dde61 478
2489d6df 479`--krbd` `<boolean>` ::
1f554f76 480
e2d681b3 481Always access rbd through krbd kernel module.
1f554f76 482
4d47f125
TL
483`--lio_tpg` `<string>` ::
484
485target portal group for Linux LIO targets
486
2489d6df 487`--maxfiles` `<integer> (0 - N)` ::
1f554f76
DM
488
489Maximal number of backup files per VM. Use '0' for unlimted.
490
2489d6df 491`--mkdir` `<boolean>` ('default =' `yes`)::
2c0dde61
DM
492
493Create the directory if it doesn't exist.
494
2489d6df
WB
495`--monhost` `<string>` ::
496
497IP addresses of monitors (for external clusters).
498
499`--nodes` `<string>` ::
1f554f76
DM
500
501List of cluster node names.
502
2489d6df 503`--nowritecache` `<boolean>` ::
1f554f76
DM
504
505disable write caching on the target
506
2489d6df 507`--options` `<string>` ::
1f554f76
DM
508
509NFS mount options (see 'man nfs')
510
5da3d723 511`--password` `<string>` ::
27a7acb2
DM
512
513Password for CIFS share.
514
2489d6df 515`--pool` `<string>` ::
1f554f76
DM
516
517Pool.
518
2489d6df 519`--redundancy` `<integer> (1 - 16)` ('default =' `2`)::
1f554f76 520
c2993fe5 521The redundancy count specifies the number of nodes to which the resource should be deployed. It must be at least 1 and at most the number of nodes in the cluster.
1f554f76 522
2489d6df 523`--saferemove` `<boolean>` ::
1f554f76
DM
524
525Zero-out data when removing LVs.
526
2489d6df 527`--saferemove_throughput` `<string>` ::
1f554f76
DM
528
529Wipe throughput (cstream -t parameter value).
530
2489d6df 531`--server` `<string>` ::
1f554f76
DM
532
533Server IP or DNS name.
534
2489d6df 535`--server2` `<string>` ::
1f554f76
DM
536
537Backup volfile server IP or DNS name.
538+
539NOTE: Requires option(s): `server`
540
2489d6df 541`--shared` `<boolean>` ::
1f554f76
DM
542
543Mark storage as shared.
544
5da3d723 545`--smbversion` `<2.0 | 2.1 | 3.0>` ::
27a7acb2 546
5da3d723 547SMB protocol version
27a7acb2 548
2489d6df 549`--sparse` `<boolean>` ::
1f554f76
DM
550
551use sparse volumes
552
5da3d723
TL
553`--subdir` `<string>` ::
554
555Subdir to mount.
556
2489d6df 557`--tagged_only` `<boolean>` ::
2c0dde61
DM
558
559Only use logical volumes tagged with 'pve-vm-ID'.
560
2489d6df 561`--transport` `<rdma | tcp | unix>` ::
1f554f76
DM
562
563Gluster transport: tcp or rdma
564
2489d6df 565`--username` `<string>` ::
1f554f76
DM
566
567RBD Id.
568
1f554f76
DM
569*pvesm status* `[OPTIONS]`
570
571Get status for all datastores.
572
2489d6df 573`--content` `<string>` ::
1f554f76
DM
574
575Only list stores which support this content type.
576
2489d6df 577`--enabled` `<boolean>` ('default =' `0`)::
1f554f76
DM
578
579Only list stores which are enabled (not disabled in config).
580
35a75dd3
DM
581`--format` `<boolean>` ('default =' `0`)::
582
583Include information about formats
584
2489d6df 585`--storage` `<string>` ::
1f554f76
DM
586
587Only list status for specified storage
588
2489d6df 589`--target` `<string>` ::
1f554f76 590
c2993fe5 591If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.
1f554f76 592
1f554f76
DM
593*pvesm zfsscan*
594
e2d681b3 595An alias for 'pvesm scan zfs'.
1f554f76
DM
596
597