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>` ::
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` `<boolean>` ('default =' `no`)::
55 Assume the directory is an externally managed mountpoint. If nothing is mounted the storage will be considered offline.
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>` ::
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')
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` `<boolean>` ('default =' `no`)::
426 Assume the directory is an externally managed mountpoint. If nothing is mounted the storage will be considered offline.
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 `-nodes` `<string>` ::
442 List of cluster node names.
444 `-nowritecache` `<boolean>` ::
446 disable write caching on the target
448 `-options` `<string>` ::
450 NFS mount options (see 'man nfs')
452 `-pool` `<string>` ::
456 `-redundancy` `<integer> (1 - 16)` ('default =' `2`)::
458 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.
460 `-saferemove` `<boolean>` ::
462 Zero-out data when removing LVs.
464 `-saferemove_throughput` `<string>` ::
466 Wipe throughput (cstream -t parameter value).
468 `-server` `<string>` ::
470 Server IP or DNS name.
472 `-server2` `<string>` ::
474 Backup volfile server IP or DNS name.
476 NOTE: Requires option(s): `server`
478 `-shared` `<boolean>` ::
480 Mark storage as shared.
482 `-sparse` `<boolean>` ::
486 `-tagged_only` `<boolean>` ::
488 Only use logical volumes tagged with 'pve-vm-ID'.
490 `-transport` `<rdma | tcp | unix>` ::
492 Gluster transport: tcp or rdma
494 `-username` `<string>` ::
501 *pvesm status* `[OPTIONS]`
503 Get status for all datastores.
505 `-content` `<string>` ::
507 Only list stores which support this content type.
509 `-enabled` `<boolean>` ('default =' `0`)::
511 Only list stores which are enabled (not disabled in config).
513 `-storage` `<string>` ::
515 Only list status for specified storage
517 `-target` `<string>` ::
519 If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.
526 Scan zfs pool list on local node.