1 *pvesm* `<COMMAND> [ARGS] [OPTIONS]`
3 *pvesm add* `<type> <storage>` `[OPTIONS]`
7 `<type>`: `<dir | drbd | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | rbd | sheepdog | 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 `--comstar_hg` `<string>` ::
29 host group for comstar views
31 `--comstar_tg` `<string>` ::
33 target group for comstar views
35 `--content` `<string>` ::
37 Allowed content types.
39 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
41 `--disable` `<boolean>` ::
43 Flag to disable the storage.
45 `--export` `<string>` ::
49 `--format` `<string>` ::
53 `--is_mountpoint` `<string>` ('default =' `no`)::
55 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.
57 `--iscsiprovider` `<string>` ::
61 `--krbd` `<boolean>` ::
63 Access rbd through krbd kernel module.
65 `--maxfiles` `<integer> (0 - N)` ::
67 Maximal number of backup files per VM. Use '0' for unlimted.
69 `--mkdir` `<boolean>` ('default =' `yes`)::
71 Create the directory if it doesn't exist.
73 `--monhost` `<string>` ::
75 IP addresses of monitors (for external clusters).
77 `--nodes` `<string>` ::
79 List of cluster node names.
81 `--nowritecache` `<boolean>` ::
83 disable write caching on the target
85 `--options` `<string>` ::
87 NFS mount options (see 'man nfs')
89 `--path` `<string>` ::
93 `--pool` `<string>` ::
97 `--portal` `<string>` ::
99 iSCSI portal (IP or DNS name with optional port).
101 `--redundancy` `<integer> (1 - 16)` ('default =' `2`)::
103 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.
105 `--saferemove` `<boolean>` ::
107 Zero-out data when removing LVs.
109 `--saferemove_throughput` `<string>` ::
111 Wipe throughput (cstream -t parameter value).
113 `--server` `<string>` ::
115 Server IP or DNS name.
117 `--server2` `<string>` ::
119 Backup volfile server IP or DNS name.
121 NOTE: Requires option(s): `server`
123 `--shared` `<boolean>` ::
125 Mark storage as shared.
127 `--sparse` `<boolean>` ::
131 `--tagged_only` `<boolean>` ::
133 Only use logical volumes tagged with 'pve-vm-ID'.
135 `--target` `<string>` ::
139 `--thinpool` `<string>` ::
141 LVM thin pool LV name.
143 `--transport` `<rdma | tcp | unix>` ::
145 Gluster transport: tcp or rdma
147 `--username` `<string>` ::
151 `--vgname` `<string>` ::
155 `--volume` `<string>` ::
162 *pvesm alloc* `<storage> <vmid> <filename> <size>` `[OPTIONS]`
164 Allocate disk images.
166 `<storage>`: `<string>` ::
168 The storage identifier.
170 `<vmid>`: `<integer> (1 - N)` ::
174 `<filename>`: `<string>` ::
176 The name of the file to create.
178 `<size>`: `\d+[MG]?` ::
180 Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M)
182 `--format` `<qcow2 | raw | subvol>` ::
184 no description available
186 NOTE: Requires option(s): `size`
191 *pvesm export* `<volume> <format> <filename>` `[OPTIONS]`
195 `<volume>`: `<string>` ::
199 `<format>`: `<qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
203 `<filename>`: `<string>` ::
205 Destination file name
207 `--base` `(?^:[a-z0-9_\-]{1,40})` ::
209 Snapshot to start an incremental stream from
211 `--snapshot` `(?^:[a-z0-9_\-]{1,40})` ::
215 `--with-snapshots` `<boolean>` ('default =' `0`)::
217 Whether to include intermediate snapshots in the stream
221 *pvesm extractconfig* `<volume>`
223 Extract configuration from vzdump backup archive.
225 `<volume>`: `<string>` ::
232 *pvesm free* `<volume>` `[OPTIONS]`
236 `<volume>`: `<string>` ::
240 `--storage` `<string>` ::
242 The storage identifier.
247 *pvesm glusterfsscan* `<server>`
249 Scan remote GlusterFS server.
251 `<server>`: `<string>` ::
253 no description available
258 *pvesm help* `[<cmd>]` `[OPTIONS]`
260 Get help about specified command.
262 `<cmd>`: `<string>` ::
266 `--verbose` `<boolean>` ::
268 Verbose output format.
273 *pvesm import* `<volume> <format> <filename>` `[OPTIONS]`
277 `<volume>`: `<string>` ::
281 `<format>`: `<qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
285 `<filename>`: `<string>` ::
289 `--base` `(?^:[a-z0-9_\-]{1,40})` ::
291 Base snapshot of an incremental stream
293 `--delete-snapshot` `(?^:[a-z0-9_\-]{1,80})` ::
295 A snapshot to delete on success
297 `--with-snapshots` `<boolean>` ('default =' `0`)::
299 Whether the stream includes intermediate snapshots
304 *pvesm iscsiscan* `--portal <string>` `[OPTIONS]`
306 Scan remote iSCSI server.
308 `--portal` `<string>` ::
310 no description available
315 *pvesm list* `<storage>` `[OPTIONS]`
317 List storage content.
319 `<storage>`: `<string>` ::
321 The storage identifier.
323 `--content` `<string>` ::
325 Only list content of this type.
327 `--vmid` `<integer> (1 - N)` ::
329 Only list images for this VM
336 List local LVM volume groups.
340 *pvesm lvmthinscan* `<vg>`
342 List local LVM Thin Pools.
344 `<vg>`: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` ::
346 no description available
350 *pvesm nfsscan* `<server>`
352 Scan remote NFS server.
354 `<server>`: `<string>` ::
356 no description available
361 *pvesm path* `<volume>`
363 Get filesystem path for specified volume
365 `<volume>`: `<string>` ::
372 *pvesm remove* `<storage>`
374 Delete storage configuration.
376 `<storage>`: `<string>` ::
378 The storage identifier.
382 *pvesm set* `<storage>` `[OPTIONS]`
384 Update storage configuration.
386 `<storage>`: `<string>` ::
388 The storage identifier.
390 `--blocksize` `<string>` ::
394 `--comstar_hg` `<string>` ::
396 host group for comstar views
398 `--comstar_tg` `<string>` ::
400 target group for comstar views
402 `--content` `<string>` ::
404 Allowed content types.
406 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
408 `--delete` `<string>` ::
410 A list of settings you want to delete.
412 `--digest` `<string>` ::
414 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
416 `--disable` `<boolean>` ::
418 Flag to disable the storage.
420 `--format` `<string>` ::
422 Default image format.
424 `--is_mountpoint` `<string>` ('default =' `no`)::
426 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.
428 `--krbd` `<boolean>` ::
430 Access rbd through krbd kernel module.
432 `--maxfiles` `<integer> (0 - N)` ::
434 Maximal number of backup files per VM. Use '0' for unlimted.
436 `--mkdir` `<boolean>` ('default =' `yes`)::
438 Create the directory if it doesn't exist.
440 `--monhost` `<string>` ::
442 IP addresses of monitors (for external clusters).
444 `--nodes` `<string>` ::
446 List of cluster node names.
448 `--nowritecache` `<boolean>` ::
450 disable write caching on the target
452 `--options` `<string>` ::
454 NFS mount options (see 'man nfs')
456 `--pool` `<string>` ::
460 `--redundancy` `<integer> (1 - 16)` ('default =' `2`)::
462 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.
464 `--saferemove` `<boolean>` ::
466 Zero-out data when removing LVs.
468 `--saferemove_throughput` `<string>` ::
470 Wipe throughput (cstream -t parameter value).
472 `--server` `<string>` ::
474 Server IP or DNS name.
476 `--server2` `<string>` ::
478 Backup volfile server IP or DNS name.
480 NOTE: Requires option(s): `server`
482 `--shared` `<boolean>` ::
484 Mark storage as shared.
486 `--sparse` `<boolean>` ::
490 `--tagged_only` `<boolean>` ::
492 Only use logical volumes tagged with 'pve-vm-ID'.
494 `--transport` `<rdma | tcp | unix>` ::
496 Gluster transport: tcp or rdma
498 `--username` `<string>` ::
505 *pvesm status* `[OPTIONS]`
507 Get status for all datastores.
509 `--content` `<string>` ::
511 Only list stores which support this content type.
513 `--enabled` `<boolean>` ('default =' `0`)::
515 Only list stores which are enabled (not disabled in config).
517 `--storage` `<string>` ::
519 Only list status for specified storage
521 `--target` `<string>` ::
523 If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.
530 Scan zfs pool list on local node.