1 *pvesm* `<COMMAND> [ARGS] [OPTIONS]`
3 *pvesm add* `<type> <storage>` `[OPTIONS]`
7 `<type>`: `<cephfs | cifs | dir | drbd | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | pbs | rbd | zfs | zfspool>` ::
11 `<storage>`: `<string>` ::
13 The storage identifier.
15 `--authsupported` `<string>` ::
19 `--base` `<string>` ::
21 Base volume. This volume is automatically activated.
23 `--blocksize` `<string>` ::
27 `--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
29 Set bandwidth/io limits various operations.
31 `--comstar_hg` `<string>` ::
33 host group for comstar views
35 `--comstar_tg` `<string>` ::
37 target group for comstar views
39 `--content` `<string>` ::
41 Allowed content types.
43 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
45 `--datastore` `<string>` ::
47 Proxmox backup server datastore name.
49 `--disable` `<boolean>` ::
51 Flag to disable the storage.
53 `--domain` `<string>` ::
57 `--export` `<string>` ::
61 `--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
63 Certificate SHA 256 fingerprint.
65 `--format` `<string>` ::
69 `--fuse` `<boolean>` ::
71 Mount CephFS through FUSE.
73 `--is_mountpoint` `<string>` ('default =' `no`)::
75 Assume 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.
77 `--iscsiprovider` `<string>` ::
81 `--krbd` `<boolean>` ::
83 Always access rbd through krbd kernel module.
85 `--lio_tpg` `<string>` ::
87 target portal group for Linux LIO targets
89 `--maxfiles` `<integer> (0 - N)` ::
91 Maximal number of backup files per VM. Use '0' for unlimted.
93 `--mkdir` `<boolean>` ('default =' `yes`)::
95 Create the directory if it doesn't exist.
97 `--monhost` `<string>` ::
99 IP addresses of monitors (for external clusters).
101 `--mountpoint` `<string>` ::
105 `--nodes` `<string>` ::
107 List of cluster node names.
109 `--nowritecache` `<boolean>` ::
111 disable write caching on the target
113 `--options` `<string>` ::
115 NFS mount options (see 'man nfs')
117 `--password` `<password>` ::
119 Password for CIFS share.
121 `--path` `<string>` ::
125 `--pool` `<string>` ::
129 `--portal` `<string>` ::
131 iSCSI portal (IP or DNS name with optional port).
133 `--redundancy` `<integer> (1 - 16)` ('default =' `2`)::
135 The 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.
137 `--saferemove` `<boolean>` ::
139 Zero-out data when removing LVs.
141 `--saferemove_throughput` `<string>` ::
143 Wipe throughput (cstream -t parameter value).
145 `--server` `<string>` ::
147 Server IP or DNS name.
149 `--server2` `<string>` ::
151 Backup volfile server IP or DNS name.
153 NOTE: Requires option(s): `server`
155 `--share` `<string>` ::
159 `--shared` `<boolean>` ::
161 Mark storage as shared.
163 `--smbversion` `<2.0 | 2.1 | 3.0>` ::
167 `--sparse` `<boolean>` ::
171 `--subdir` `<string>` ::
175 `--tagged_only` `<boolean>` ::
177 Only use logical volumes tagged with 'pve-vm-ID'.
179 `--target` `<string>` ::
183 `--thinpool` `<string>` ::
185 LVM thin pool LV name.
187 `--transport` `<rdma | tcp | unix>` ::
189 Gluster transport: tcp or rdma
191 `--username` `<string>` ::
195 `--vgname` `<string>` ::
199 `--volume` `<string>` ::
203 *pvesm alloc* `<storage> <vmid> <filename> <size>` `[OPTIONS]`
205 Allocate disk images.
207 `<storage>`: `<string>` ::
209 The storage identifier.
211 `<vmid>`: `<integer> (1 - N)` ::
215 `<filename>`: `<string>` ::
217 The name of the file to create.
219 `<size>`: `\d+[MG]?` ::
221 Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M)
223 `--format` `<qcow2 | raw | subvol>` ::
225 no description available
227 NOTE: Requires option(s): `size`
231 Returns APIVER and APIAGE.
235 An alias for 'pvesm scan cifs'.
237 *pvesm export* `<volume> <format> <filename>` `[OPTIONS]`
241 `<volume>`: `<string>` ::
245 `<format>`: `<qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
249 `<filename>`: `<string>` ::
251 Destination file name
253 `--base` `(?^:[a-z0-9_\-]{1,40})` ::
255 Snapshot to start an incremental stream from
257 `--snapshot` `(?^:[a-z0-9_\-]{1,40})` ::
261 `--with-snapshots` `<boolean>` ('default =' `0`)::
263 Whether to include intermediate snapshots in the stream
265 *pvesm extractconfig* `<volume>`
267 Extract configuration from vzdump backup archive.
269 `<volume>`: `<string>` ::
273 *pvesm free* `<volume>` `[OPTIONS]`
277 `<volume>`: `<string>` ::
281 `--delay` `<integer> (1 - 30)` ::
283 Time to wait for the task to finish. We return 'null' if the task finish within that time.
285 `--storage` `<string>` ::
287 The storage identifier.
289 *pvesm glusterfsscan*
291 An alias for 'pvesm scan glusterfs'.
293 *pvesm help* `[OPTIONS]`
295 Get help about specified command.
297 `--extra-args` `<array>` ::
299 Shows help for a specific command
301 `--verbose` `<boolean>` ::
303 Verbose output format.
305 *pvesm import* `<volume> <format> <filename>` `[OPTIONS]`
309 `<volume>`: `<string>` ::
313 `<format>`: `<qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
317 `<filename>`: `<string>` ::
319 Source file name. For '-' stdin is used, the tcp://<IP-or-CIDR> format allows to use a TCP connection as input. Else, the file is treated as common file.
321 `--allow-rename` `<boolean>` ('default =' `0`)::
323 Choose a new volume ID if the requested volume ID already exists, instead of throwing an error.
325 `--base` `(?^:[a-z0-9_\-]{1,40})` ::
327 Base snapshot of an incremental stream
329 `--delete-snapshot` `(?^:[a-z0-9_\-]{1,80})` ::
331 A snapshot to delete on success
333 `--with-snapshots` `<boolean>` ('default =' `0`)::
335 Whether the stream includes intermediate snapshots
339 An alias for 'pvesm scan iscsi'.
341 *pvesm list* `<storage>` `[OPTIONS]`
343 List storage content.
345 `<storage>`: `<string>` ::
347 The storage identifier.
349 `--content` `<string>` ::
351 Only list content of this type.
353 `--vmid` `<integer> (1 - N)` ::
355 Only list images for this VM
359 An alias for 'pvesm scan lvm'.
363 An alias for 'pvesm scan lvmthin'.
367 An alias for 'pvesm scan nfs'.
369 *pvesm path* `<volume>`
371 Get filesystem path for specified volume
373 `<volume>`: `<string>` ::
377 *pvesm remove* `<storage>`
379 Delete storage configuration.
381 `<storage>`: `<string>` ::
383 The storage identifier.
385 *pvesm scan cifs* `<server>` `[OPTIONS]`
387 Scan remote CIFS server.
389 `<server>`: `<string>` ::
391 The server address (name or IP).
393 `--domain` `<string>` ::
395 SMB domain (Workgroup).
397 `--password` `<password>` ::
401 `--username` `<string>` ::
405 *pvesm scan glusterfs* `<server>`
407 Scan remote GlusterFS server.
409 `<server>`: `<string>` ::
411 The server address (name or IP).
413 *pvesm scan iscsi* `<portal>`
415 Scan remote iSCSI server.
417 `<portal>`: `<string>` ::
419 The iSCSI portal (IP or DNS name with optional port).
423 List local LVM volume groups.
425 *pvesm scan lvmthin* `<vg>`
427 List local LVM Thin Pools.
429 `<vg>`: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` ::
431 no description available
433 *pvesm scan nfs* `<server>`
435 Scan remote NFS server.
437 `<server>`: `<string>` ::
439 The server address (name or IP).
443 Scan zfs pool list on local node.
445 *pvesm set* `<storage>` `[OPTIONS]`
447 Update storage configuration.
449 `<storage>`: `<string>` ::
451 The storage identifier.
453 `--blocksize` `<string>` ::
457 `--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
459 Set bandwidth/io limits various operations.
461 `--comstar_hg` `<string>` ::
463 host group for comstar views
465 `--comstar_tg` `<string>` ::
467 target group for comstar views
469 `--content` `<string>` ::
471 Allowed content types.
473 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
475 `--delete` `<string>` ::
477 A list of settings you want to delete.
479 `--digest` `<string>` ::
481 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
483 `--disable` `<boolean>` ::
485 Flag to disable the storage.
487 `--domain` `<string>` ::
491 `--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
493 Certificate SHA 256 fingerprint.
495 `--format` `<string>` ::
497 Default image format.
499 `--fuse` `<boolean>` ::
501 Mount CephFS through FUSE.
503 `--is_mountpoint` `<string>` ('default =' `no`)::
505 Assume 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.
507 `--krbd` `<boolean>` ::
509 Always access rbd through krbd kernel module.
511 `--lio_tpg` `<string>` ::
513 target portal group for Linux LIO targets
515 `--maxfiles` `<integer> (0 - N)` ::
517 Maximal number of backup files per VM. Use '0' for unlimted.
519 `--mkdir` `<boolean>` ('default =' `yes`)::
521 Create the directory if it doesn't exist.
523 `--monhost` `<string>` ::
525 IP addresses of monitors (for external clusters).
527 `--mountpoint` `<string>` ::
531 `--nodes` `<string>` ::
533 List of cluster node names.
535 `--nowritecache` `<boolean>` ::
537 disable write caching on the target
539 `--options` `<string>` ::
541 NFS mount options (see 'man nfs')
543 `--password` `<string>` ::
545 Password for CIFS share.
547 `--pool` `<string>` ::
551 `--redundancy` `<integer> (1 - 16)` ('default =' `2`)::
553 The 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.
555 `--saferemove` `<boolean>` ::
557 Zero-out data when removing LVs.
559 `--saferemove_throughput` `<string>` ::
561 Wipe throughput (cstream -t parameter value).
563 `--server` `<string>` ::
565 Server IP or DNS name.
567 `--server2` `<string>` ::
569 Backup volfile server IP or DNS name.
571 NOTE: Requires option(s): `server`
573 `--shared` `<boolean>` ::
575 Mark storage as shared.
577 `--smbversion` `<2.0 | 2.1 | 3.0>` ::
581 `--sparse` `<boolean>` ::
585 `--subdir` `<string>` ::
589 `--tagged_only` `<boolean>` ::
591 Only use logical volumes tagged with 'pve-vm-ID'.
593 `--transport` `<rdma | tcp | unix>` ::
595 Gluster transport: tcp or rdma
597 `--username` `<string>` ::
601 *pvesm status* `[OPTIONS]`
603 Get status for all datastores.
605 `--content` `<string>` ::
607 Only list stores which support this content type.
609 `--enabled` `<boolean>` ('default =' `0`)::
611 Only list stores which are enabled (not disabled in config).
613 `--format` `<boolean>` ('default =' `0`)::
615 Include information about formats
617 `--storage` `<string>` ::
619 Only list status for specified storage
621 `--target` `<string>` ::
623 If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.
627 An alias for 'pvesm scan zfs'.