X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=pvesm.1-synopsis.adoc;h=5b1df70c5c620ee60de6e0f62e3fed8f5111c18a;hb=cfd48f55a05104f391ccdf2dcd4627fa2593fb76;hp=9c7b5c6ef67d263d1cf02afe8900b58a8417be1f;hpb=2c0dde619dc203c365be8b15284530099d159682;p=pve-docs.git diff --git a/pvesm.1-synopsis.adoc b/pvesm.1-synopsis.adoc index 9c7b5c6..5b1df70 100644 --- a/pvesm.1-synopsis.adoc +++ b/pvesm.1-synopsis.adoc @@ -4,466 +4,558 @@ Create a new storage. -`` `(dir | drbd | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | rbd | sheepdog | zfs | zfspool)` :: +``: `` :: Storage type. -`` `string` :: +``: `` :: The storage identifier. -`-authsupported` `string` :: +`--authsupported` `` :: Authsupported. -`-base` `string` :: +`--base` `` :: Base volume. This volume is automatically activated. -`-blocksize` `string` :: +`--blocksize` `` :: block size -`-comstar_hg` `string` :: +`--bwlimit` `[clone=] [,default=] [,migration=] [,move=] [,restore=]` :: + +Set bandwidth/io limits various operations. + +`--comstar_hg` `` :: host group for comstar views -`-comstar_tg` `string` :: +`--comstar_tg` `` :: target group for comstar views -`-content` `string` :: +`--content` `` :: Allowed content types. + NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs. -`-disable` `boolean` :: +`--disable` `` :: Flag to disable the storage. -`-export` `string` :: +`--domain` `` :: + +CIFS domain. + +`--export` `` :: NFS export path. -`-format` `string` :: +`--format` `` :: Default image format. -`-is_mountpoint` `boolean` (default=`no`):: +`--fuse` `` :: -Assume the directory is an externally managed mountpoint. If nothing is mounted the storage will be considered offline. +Mount CephFS through FUSE. -`-iscsiprovider` `string` :: +`--is_mountpoint` `` ('default =' `no`):: + +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. + +`--iscsiprovider` `` :: iscsi provider -`-krbd` `boolean` :: +`--krbd` `` :: Access rbd through krbd kernel module. -`-maxfiles` `integer (0 - N)` :: +`--maxfiles` ` (0 - N)` :: Maximal number of backup files per VM. Use '0' for unlimted. -`-mkdir` `boolean` (default=`yes`):: +`--mkdir` `` ('default =' `yes`):: Create the directory if it doesn't exist. -`-monhost` `string` :: +`--monhost` `` :: -Monitors daemon ips. +IP addresses of monitors (for external clusters). -`-nodes` `string` :: +`--nodes` `` :: List of cluster node names. -`-nowritecache` `boolean` :: +`--nowritecache` `` :: disable write caching on the target -`-options` `string` :: +`--options` `` :: NFS mount options (see 'man nfs') -`-path` `string` :: +`--password` `` :: + +Password for CIFS share. + +`--path` `` :: File system path. -`-pool` `string` :: +`--pool` `` :: Pool. -`-portal` `string` :: +`--portal` `` :: iSCSI portal (IP or DNS name with optional port). -`-redundancy` `integer (1 - 16)` (default=`2`):: +`--redundancy` ` (1 - 16)` ('default =' `2`):: 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. -`-saferemove` `boolean` :: +`--saferemove` `` :: Zero-out data when removing LVs. -`-saferemove_throughput` `string` :: +`--saferemove_throughput` `` :: Wipe throughput (cstream -t parameter value). -`-server` `string` :: +`--server` `` :: Server IP or DNS name. -`-server2` `string` :: +`--server2` `` :: Backup volfile server IP or DNS name. + NOTE: Requires option(s): `server` -`-shared` `boolean` :: +`--share` `` :: + +CIFS share. + +`--shared` `` :: Mark storage as shared. -`-sparse` `boolean` :: +`--smbversion` `<2.0 | 2.1 | 3.0>` :: + +SMB protocol version + +`--sparse` `` :: use sparse volumes -`-tagged_only` `boolean` :: +`--subdir` `` :: + +Subdir to mount. + +`--tagged_only` `` :: Only use logical volumes tagged with 'pve-vm-ID'. -`-target` `string` :: +`--target` `` :: iSCSI target. -`-thinpool` `string` :: +`--thinpool` `` :: LVM thin pool LV name. -`-transport` `(rdma | tcp | unix)` :: +`--transport` `` :: Gluster transport: tcp or rdma -`-username` `string` :: +`--username` `` :: RBD Id. -`-vgname` `string` :: +`--vgname` `` :: Volume group name. -`-volume` `string` :: +`--volume` `` :: Glusterfs Volume. - - - *pvesm alloc* ` ` `[OPTIONS]` Allocate disk images. -`` `string` :: +``: `` :: The storage identifier. -`` `integer (1 - N)` :: +``: ` (1 - N)` :: Specify owner VM -`` `string` :: +``: `` :: The name of the file to create. -`` `\d+[MG]?` :: +``: `\d+[MG]?` :: Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M) -`-format` `(qcow2 | raw | subvol)` :: +`--format` `` :: no description available + NOTE: Requires option(s): `size` +*pvesm cifsscan* `` `[OPTIONS]` +Scan remote CIFS server. +``: `` :: -*pvesm extractconfig* `` +no description available -Extract configuration from vzdump backup archive. +`--domain` `` :: + +no description available + +`--password` `` :: + +no description available -`` `string` :: +`--username` `` :: + +no description available + +*pvesm export* ` ` `[OPTIONS]` + +Export a volume. + +``: `` :: Volume identifier +``: `` :: +Export stream format +``: `` :: -*pvesm free* `` `[OPTIONS]` +Destination file name -Delete volume +`--base` `(?^:[a-z0-9_\-]{1,40})` :: -`` `string` :: +Snapshot to start an incremental stream from + +`--snapshot` `(?^:[a-z0-9_\-]{1,40})` :: + +Snapshot to export + +`--with-snapshots` `` ('default =' `0`):: + +Whether to include intermediate snapshots in the stream + +*pvesm extractconfig* `` + +Extract configuration from vzdump backup archive. + +``: `` :: Volume identifier -`-storage` `string` :: +*pvesm free* `` `[OPTIONS]` -The storage identifier. +Delete volume +``: `` :: +Volume identifier + +`--storage` `` :: +The storage identifier. *pvesm glusterfsscan* `` Scan remote GlusterFS server. -`` `string` :: +``: `` :: no description available +*pvesm help* `[OPTIONS]` +Get help about specified command. +`--extra-args` `` :: -*pvesm help* `[]` `[OPTIONS]` +Shows help for a specific command -Get help about specified command. +`--verbose` `` :: + +Verbose output format. -`` `string` :: +*pvesm import* ` ` `[OPTIONS]` -Command name +Import a volume. -`-verbose` `boolean` :: +``: `` :: -Verbose output format. +Volume identifier +``: `` :: +Import stream format +``: `` :: -*pvesm iscsiscan* `-portal ` `[OPTIONS]` +Source file name -Scan remote iSCSI server. +`--base` `(?^:[a-z0-9_\-]{1,40})` :: -`-portal` `string` :: +Base snapshot of an incremental stream -no description available +`--delete-snapshot` `(?^:[a-z0-9_\-]{1,80})` :: + +A snapshot to delete on success +`--with-snapshots` `` ('default =' `0`):: +Whether the stream includes intermediate snapshots +*pvesm iscsiscan* `--portal ` `[OPTIONS]` + +Scan remote iSCSI server. + +`--portal` `` :: + +no description available *pvesm list* `` `[OPTIONS]` List storage content. -`` `string` :: +``: `` :: The storage identifier. -`-content` `string` :: +`--content` `` :: Only list content of this type. -`-vmid` `integer (1 - N)` :: +`--vmid` ` (1 - N)` :: Only list images for this VM - - - *pvesm lvmscan* List local LVM volume groups. - - *pvesm lvmthinscan* `` List local LVM Thin Pools. -`` `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` :: +``: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` :: no description available - - *pvesm nfsscan* `` Scan remote NFS server. -`` `string` :: +``: `` :: no description available - - - *pvesm path* `` Get filesystem path for specified volume -`` `string` :: +``: `` :: Volume identifier - - - *pvesm remove* `` Delete storage configuration. -`` `string` :: +``: `` :: The storage identifier. - - *pvesm set* `` `[OPTIONS]` Update storage configuration. -`` `string` :: +``: `` :: The storage identifier. -`-blocksize` `string` :: +`--blocksize` `` :: block size -`-comstar_hg` `string` :: +`--bwlimit` `[clone=] [,default=] [,migration=] [,move=] [,restore=]` :: + +Set bandwidth/io limits various operations. + +`--comstar_hg` `` :: host group for comstar views -`-comstar_tg` `string` :: +`--comstar_tg` `` :: target group for comstar views -`-content` `string` :: +`--content` `` :: Allowed content types. + NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs. -`-delete` `string` :: +`--delete` `` :: A list of settings you want to delete. -`-digest` `string` :: +`--digest` `` :: Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications. -`-disable` `boolean` :: +`--disable` `` :: Flag to disable the storage. -`-format` `string` :: +`--domain` `` :: + +CIFS domain. + +`--format` `` :: Default image format. -`-is_mountpoint` `boolean` (default=`no`):: +`--fuse` `` :: + +Mount CephFS through FUSE. + +`--is_mountpoint` `` ('default =' `no`):: -Assume the directory is an externally managed mountpoint. If nothing is mounted the storage will be considered offline. +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. -`-krbd` `boolean` :: +`--krbd` `` :: Access rbd through krbd kernel module. -`-maxfiles` `integer (0 - N)` :: +`--maxfiles` ` (0 - N)` :: Maximal number of backup files per VM. Use '0' for unlimted. -`-mkdir` `boolean` (default=`yes`):: +`--mkdir` `` ('default =' `yes`):: Create the directory if it doesn't exist. -`-nodes` `string` :: +`--monhost` `` :: + +IP addresses of monitors (for external clusters). + +`--nodes` `` :: List of cluster node names. -`-nowritecache` `boolean` :: +`--nowritecache` `` :: disable write caching on the target -`-options` `string` :: +`--options` `` :: NFS mount options (see 'man nfs') -`-pool` `string` :: +`--password` `` :: + +Password for CIFS share. + +`--pool` `` :: Pool. -`-redundancy` `integer (1 - 16)` (default=`2`):: +`--redundancy` ` (1 - 16)` ('default =' `2`):: 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. -`-saferemove` `boolean` :: +`--saferemove` `` :: Zero-out data when removing LVs. -`-saferemove_throughput` `string` :: +`--saferemove_throughput` `` :: Wipe throughput (cstream -t parameter value). -`-server` `string` :: +`--server` `` :: Server IP or DNS name. -`-server2` `string` :: +`--server2` `` :: Backup volfile server IP or DNS name. + NOTE: Requires option(s): `server` -`-shared` `boolean` :: +`--shared` `` :: Mark storage as shared. -`-sparse` `boolean` :: +`--smbversion` `<2.0 | 2.1 | 3.0>` :: + +SMB protocol version + +`--sparse` `` :: use sparse volumes -`-tagged_only` `boolean` :: +`--subdir` `` :: + +Subdir to mount. + +`--tagged_only` `` :: Only use logical volumes tagged with 'pve-vm-ID'. -`-transport` `(rdma | tcp | unix)` :: +`--transport` `` :: Gluster transport: tcp or rdma -`-username` `string` :: +`--username` `` :: RBD Id. - - - *pvesm status* `[OPTIONS]` Get status for all datastores. -`-content` `string` :: +`--content` `` :: Only list stores which support this content type. -`-enabled` `boolean` (default=`0`):: +`--enabled` `` ('default =' `0`):: Only list stores which are enabled (not disabled in config). -`-storage` `string` :: - -Only list status for specified storage +`--format` `` ('default =' `0`):: -`-target` `string` :: +Include information about formats -If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node. +`--storage` `` :: +Only list status for specified storage +`--target` `` :: +If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node. *pvesm zfsscan* Scan zfs pool list on local node. - -