1 *pvesm* `<COMMAND> [ARGS] [OPTIONS]`
3 *pvesm add* `<type> <storage>` `[OPTIONS]`
7 `<type>`: `<btrfs | cephfs | cifs | dir | 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 `--data-pool` `<string>` ::
47 Data Pool (for erasure coding only)
49 `--datastore` `<string>` ::
51 Proxmox Backup Server datastore name.
53 `--disable` `<boolean>` ::
55 Flag to disable the storage.
57 `--domain` `<string>` ::
61 `--encryption-key` `a file containing an encryption key, or the special value "autogen"` ::
63 Encryption key. Use 'autogen' to generate one automatically without passphrase.
65 `--export` `<string>` ::
69 `--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
71 Certificate SHA 256 fingerprint.
73 `--format` `<string>` ::
77 `--fs-name` `<string>` ::
79 The Ceph filesystem name.
81 `--fuse` `<boolean>` ::
83 Mount CephFS through FUSE.
85 `--is_mountpoint` `<string>` ('default =' `no`)::
87 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.
89 `--iscsiprovider` `<string>` ::
93 `--keyring` `file containing the keyring to authenticate in the Ceph cluster` ::
95 Client keyring contents (for external clusters).
97 `--krbd` `<boolean>` ::
99 Always access rbd through krbd kernel module.
101 `--lio_tpg` `<string>` ::
103 target portal group for Linux LIO targets
105 `--master-pubkey` `a file containing a PEM-formatted master public key` ::
107 Base64-encoded, PEM-formatted public RSA key. Used to encrypt a copy of the encryption-key which will be added to each encrypted backup.
109 `--maxfiles` `<integer> (0 - N)` ::
111 Deprecated: use 'prune-backups' instead. Maximal number of backup files per VM. Use '0' for unlimited.
113 `--mkdir` `<boolean>` ('default =' `yes`)::
115 Create the directory if it doesn't exist.
117 `--monhost` `<string>` ::
119 IP addresses of monitors (for external clusters).
121 `--mountpoint` `<string>` ::
125 `--namespace` `<string>` ::
129 `--nocow` `<boolean>` ('default =' `0`)::
131 Set the NOCOW flag on files. Disables data checksumming and causes data errors to be unrecoverable from while allowing direct I/O. Only use this if data does not need to be any more safe than on a single ext4 formatted disk with no underlying raid system.
133 `--nodes` `<string>` ::
135 List of cluster node names.
137 `--nowritecache` `<boolean>` ::
139 disable write caching on the target
141 `--options` `<string>` ::
143 NFS mount options (see 'man nfs')
145 `--password` `<password>` ::
147 Password for accessing the share/datastore.
149 `--path` `<string>` ::
153 `--pool` `<string>` ::
157 `--port` `<integer> (1 - 65535)` ('default =' `8007`)::
159 For non default port.
161 `--portal` `<string>` ::
163 iSCSI portal (IP or DNS name with optional port).
165 `--preallocation` `<falloc | full | metadata | off>` ('default =' `metadata`)::
167 Preallocation mode for raw and qcow2 images. Using 'metadata' on raw images results in preallocation=off.
169 `--prune-backups` `[keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>]` ::
171 The retention options with shorter intervals are processed first with --keep-last being the very first one. Each option covers a specific period of time. We say that backups within this period are covered by this option. The next option does not take care of already covered backups and only considers older backups.
173 `--saferemove` `<boolean>` ::
175 Zero-out data when removing LVs.
177 `--saferemove_throughput` `<string>` ::
179 Wipe throughput (cstream -t parameter value).
181 `--server` `<string>` ::
183 Server IP or DNS name.
185 `--server2` `<string>` ::
187 Backup volfile server IP or DNS name.
189 NOTE: Requires option(s): `server`
191 `--share` `<string>` ::
195 `--shared` `<boolean>` ::
197 Mark storage as shared.
199 `--smbversion` `<2.0 | 2.1 | 3 | 3.0 | 3.11 | default>` ('default =' `default`)::
201 SMB protocol version. 'default' if not set, negotiates the highest SMB2+ version supported by both the client and server.
203 `--sparse` `<boolean>` ::
207 `--subdir` `<string>` ::
211 `--tagged_only` `<boolean>` ::
213 Only use logical volumes tagged with 'pve-vm-ID'.
215 `--target` `<string>` ::
219 `--thinpool` `<string>` ::
221 LVM thin pool LV name.
223 `--transport` `<rdma | tcp | unix>` ::
225 Gluster transport: tcp or rdma
227 `--username` `<string>` ::
231 `--vgname` `<string>` ::
235 `--volume` `<string>` ::
239 *pvesm alloc* `<storage> <vmid> <filename> <size>` `[OPTIONS]`
241 Allocate disk images.
243 `<storage>`: `<string>` ::
245 The storage identifier.
247 `<vmid>`: `<integer> (1 - N)` ::
251 `<filename>`: `<string>` ::
253 The name of the file to create.
255 `<size>`: `\d+[MG]?` ::
257 Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M)
259 `--format` `<qcow2 | raw | subvol>` ::
261 no description available
263 NOTE: Requires option(s): `size`
267 Returns APIVER and APIAGE.
271 An alias for 'pvesm scan cifs'.
273 *pvesm export* `<volume> <format> <filename>` `[OPTIONS]`
275 Used internally to export a volume.
277 `<volume>`: `<string>` ::
281 `<format>`: `<btrfs | qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
285 `<filename>`: `<string>` ::
287 Destination file name
289 `--base` `(?^i:[a-z0-9_\-]{1,40})` ::
291 Snapshot to start an incremental stream from
293 `--snapshot` `(?^i:[a-z0-9_\-]{1,40})` ::
297 `--snapshot-list` `<string>` ::
299 Ordered list of snapshots to transfer
301 `--with-snapshots` `<boolean>` ('default =' `0`)::
303 Whether to include intermediate snapshots in the stream
305 *pvesm extractconfig* `<volume>`
307 Extract configuration from vzdump backup archive.
309 `<volume>`: `<string>` ::
313 *pvesm free* `<volume>` `[OPTIONS]`
317 `<volume>`: `<string>` ::
321 `--delay` `<integer> (1 - 30)` ::
323 Time to wait for the task to finish. We return 'null' if the task finish within that time.
325 `--storage` `<string>` ::
327 The storage identifier.
329 *pvesm glusterfsscan*
331 An alias for 'pvesm scan glusterfs'.
333 *pvesm help* `[OPTIONS]`
335 Get help about specified command.
337 `--extra-args` `<array>` ::
339 Shows help for a specific command
341 `--verbose` `<boolean>` ::
343 Verbose output format.
345 *pvesm import* `<volume> <format> <filename>` `[OPTIONS]`
347 Used internally to import a volume.
349 `<volume>`: `<string>` ::
353 `<format>`: `<btrfs | qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
357 `<filename>`: `<string>` ::
359 Source file name. For '-' stdin is used, the tcp://<IP-or-CIDR> format allows to use a TCP connection, the unix://PATH-TO-SOCKET format a UNIX socket as input.Else, the file is treated as common file.
361 `--allow-rename` `<boolean>` ('default =' `0`)::
363 Choose a new volume ID if the requested volume ID already exists, instead of throwing an error.
365 `--base` `(?^i:[a-z0-9_\-]{1,40})` ::
367 Base snapshot of an incremental stream
369 `--delete-snapshot` `(?^i:[a-z0-9_\-]{1,80})` ::
371 A snapshot to delete on success
373 `--snapshot` `(?^i:[a-z0-9_\-]{1,40})` ::
375 The current-state snapshot if the stream contains snapshots
377 `--with-snapshots` `<boolean>` ('default =' `0`)::
379 Whether the stream includes intermediate snapshots
383 An alias for 'pvesm scan iscsi'.
385 *pvesm list* `<storage>` `[OPTIONS]`
387 List storage content.
389 `<storage>`: `<string>` ::
391 The storage identifier.
393 `--content` `<string>` ::
395 Only list content of this type.
397 `--vmid` `<integer> (1 - N)` ::
399 Only list images for this VM
403 An alias for 'pvesm scan lvm'.
407 An alias for 'pvesm scan lvmthin'.
411 An alias for 'pvesm scan nfs'.
413 *pvesm path* `<volume>`
415 Get filesystem path for specified volume
417 `<volume>`: `<string>` ::
421 *pvesm prune-backups* `<storage>` `[OPTIONS]`
423 Prune backups. Only those using the standard naming scheme are considered.
424 If no keep options are specified, those from the storage configuration are
427 `<storage>`: `<string>` ::
429 The storage identifier.
431 `--dry-run` `<boolean>` ::
433 Only show what would be pruned, don't delete anything.
435 `--keep-all` `<boolean>` ::
437 Keep all backups. Conflicts with the other options when true.
439 `--keep-daily` `<N>` ::
441 Keep backups for the last <N> different days. If there is morethan one backup for a single day, only the latest one is kept.
443 `--keep-hourly` `<N>` ::
445 Keep backups for the last <N> different hours. If there is morethan one backup for a single hour, only the latest one is kept.
447 `--keep-last` `<N>` ::
449 Keep the last <N> backups.
451 `--keep-monthly` `<N>` ::
453 Keep backups for the last <N> different months. If there is morethan one backup for a single month, only the latest one is kept.
455 `--keep-weekly` `<N>` ::
457 Keep backups for the last <N> different weeks. If there is morethan one backup for a single week, only the latest one is kept.
459 `--keep-yearly` `<N>` ::
461 Keep backups for the last <N> different years. If there is morethan one backup for a single year, only the latest one is kept.
463 `--type` `<lxc | qemu>` ::
465 Either 'qemu' or 'lxc'. Only consider backups for guests of this type.
467 `--vmid` `<integer> (1 - N)` ::
469 Only consider backups for this guest.
471 *pvesm remove* `<storage>`
473 Delete storage configuration.
475 `<storage>`: `<string>` ::
477 The storage identifier.
479 *pvesm scan cifs* `<server>` `[OPTIONS]`
481 Scan remote CIFS server.
483 `<server>`: `<string>` ::
485 The server address (name or IP).
487 `--domain` `<string>` ::
489 SMB domain (Workgroup).
491 `--password` `<password>` ::
495 `--username` `<string>` ::
499 *pvesm scan glusterfs* `<server>`
501 Scan remote GlusterFS server.
503 `<server>`: `<string>` ::
505 The server address (name or IP).
507 *pvesm scan iscsi* `<portal>`
509 Scan remote iSCSI server.
511 `<portal>`: `<string>` ::
513 The iSCSI portal (IP or DNS name with optional port).
517 List local LVM volume groups.
519 *pvesm scan lvmthin* `<vg>`
521 List local LVM Thin Pools.
523 `<vg>`: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` ::
525 no description available
527 *pvesm scan nfs* `<server>`
529 Scan remote NFS server.
531 `<server>`: `<string>` ::
533 The server address (name or IP).
535 *pvesm scan pbs* `<server> <username> --password <string>` `[OPTIONS]` `[FORMAT_OPTIONS]`
537 Scan remote Proxmox Backup Server.
539 `<server>`: `<string>` ::
541 The server address (name or IP).
543 `<username>`: `<string>` ::
545 User-name or API token-ID.
547 `--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
549 Certificate SHA 256 fingerprint.
551 `--password` `<string>` ::
553 User password or API token secret.
555 `--port` `<integer> (1 - 65535)` ('default =' `8007`)::
561 Scan zfs pool list on local node.
563 *pvesm set* `<storage>` `[OPTIONS]`
565 Update storage configuration.
567 `<storage>`: `<string>` ::
569 The storage identifier.
571 `--blocksize` `<string>` ::
575 `--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
577 Set bandwidth/io limits various operations.
579 `--comstar_hg` `<string>` ::
581 host group for comstar views
583 `--comstar_tg` `<string>` ::
585 target group for comstar views
587 `--content` `<string>` ::
589 Allowed content types.
591 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
593 `--data-pool` `<string>` ::
595 Data Pool (for erasure coding only)
597 `--delete` `<string>` ::
599 A list of settings you want to delete.
601 `--digest` `<string>` ::
603 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
605 `--disable` `<boolean>` ::
607 Flag to disable the storage.
609 `--domain` `<string>` ::
613 `--encryption-key` `a file containing an encryption key, or the special value "autogen"` ::
615 Encryption key. Use 'autogen' to generate one automatically without passphrase.
617 `--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
619 Certificate SHA 256 fingerprint.
621 `--format` `<string>` ::
623 Default image format.
625 `--fs-name` `<string>` ::
627 The Ceph filesystem name.
629 `--fuse` `<boolean>` ::
631 Mount CephFS through FUSE.
633 `--is_mountpoint` `<string>` ('default =' `no`)::
635 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.
637 `--keyring` `file containing the keyring to authenticate in the Ceph cluster` ::
639 Client keyring contents (for external clusters).
641 `--krbd` `<boolean>` ::
643 Always access rbd through krbd kernel module.
645 `--lio_tpg` `<string>` ::
647 target portal group for Linux LIO targets
649 `--master-pubkey` `a file containing a PEM-formatted master public key` ::
651 Base64-encoded, PEM-formatted public RSA key. Used to encrypt a copy of the encryption-key which will be added to each encrypted backup.
653 `--maxfiles` `<integer> (0 - N)` ::
655 Deprecated: use 'prune-backups' instead. Maximal number of backup files per VM. Use '0' for unlimited.
657 `--mkdir` `<boolean>` ('default =' `yes`)::
659 Create the directory if it doesn't exist.
661 `--monhost` `<string>` ::
663 IP addresses of monitors (for external clusters).
665 `--mountpoint` `<string>` ::
669 `--namespace` `<string>` ::
673 `--nocow` `<boolean>` ('default =' `0`)::
675 Set the NOCOW flag on files. Disables data checksumming and causes data errors to be unrecoverable from while allowing direct I/O. Only use this if data does not need to be any more safe than on a single ext4 formatted disk with no underlying raid system.
677 `--nodes` `<string>` ::
679 List of cluster node names.
681 `--nowritecache` `<boolean>` ::
683 disable write caching on the target
685 `--options` `<string>` ::
687 NFS mount options (see 'man nfs')
689 `--password` `<password>` ::
691 Password for accessing the share/datastore.
693 `--pool` `<string>` ::
697 `--port` `<integer> (1 - 65535)` ('default =' `8007`)::
699 For non default port.
701 `--preallocation` `<falloc | full | metadata | off>` ('default =' `metadata`)::
703 Preallocation mode for raw and qcow2 images. Using 'metadata' on raw images results in preallocation=off.
705 `--prune-backups` `[keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>]` ::
707 The retention options with shorter intervals are processed first with --keep-last being the very first one. Each option covers a specific period of time. We say that backups within this period are covered by this option. The next option does not take care of already covered backups and only considers older backups.
709 `--saferemove` `<boolean>` ::
711 Zero-out data when removing LVs.
713 `--saferemove_throughput` `<string>` ::
715 Wipe throughput (cstream -t parameter value).
717 `--server` `<string>` ::
719 Server IP or DNS name.
721 `--server2` `<string>` ::
723 Backup volfile server IP or DNS name.
725 NOTE: Requires option(s): `server`
727 `--shared` `<boolean>` ::
729 Mark storage as shared.
731 `--smbversion` `<2.0 | 2.1 | 3 | 3.0 | 3.11 | default>` ('default =' `default`)::
733 SMB protocol version. 'default' if not set, negotiates the highest SMB2+ version supported by both the client and server.
735 `--sparse` `<boolean>` ::
739 `--subdir` `<string>` ::
743 `--tagged_only` `<boolean>` ::
745 Only use logical volumes tagged with 'pve-vm-ID'.
747 `--transport` `<rdma | tcp | unix>` ::
749 Gluster transport: tcp or rdma
751 `--username` `<string>` ::
755 *pvesm status* `[OPTIONS]`
757 Get status for all datastores.
759 `--content` `<string>` ::
761 Only list stores which support this content type.
763 `--enabled` `<boolean>` ('default =' `0`)::
765 Only list stores which are enabled (not disabled in config).
767 `--format` `<boolean>` ('default =' `0`)::
769 Include information about formats
771 `--storage` `<string>` ::
773 Only list status for specified storage
775 `--target` `<string>` ::
777 If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.
781 An alias for 'pvesm scan zfs'.