X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pvesm.1-synopsis.adoc;h=5a71906311410773811026056d8fab464ad89d78;hp=56f697ada3294d05a327c0e388f87dc0895438cc;hb=7d6078845fa6a3bd308c7dc843273e56be33f315;hpb=013dc89ffce47b8c55412c016a508205768b4fd6 diff --git a/pvesm.1-synopsis.adoc b/pvesm.1-synopsis.adoc index 56f697a..5a71906 100644 --- a/pvesm.1-synopsis.adoc +++ b/pvesm.1-synopsis.adoc @@ -4,7 +4,7 @@ Create a new storage. -``: `` :: +``: `` :: Storage type. @@ -12,153 +12,182 @@ Storage type. The storage identifier. -`-authsupported` `` :: +`--authsupported` `` :: Authsupported. -`-base` `` :: +`--base` `` :: Base volume. This volume is automatically activated. -`-blocksize` `` :: +`--blocksize` `` :: block size -`-comstar_hg` `` :: +`--bwlimit` `[clone=] [,default=] [,migration=] [,move=] [,restore=]` :: + +Set bandwidth/io limits various operations. + +`--comstar_hg` `` :: host group for comstar views -`-comstar_tg` `` :: +`--comstar_tg` `` :: target group for comstar views -`-content` `` :: +`--content` `` :: Allowed content types. + NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs. -`-disable` `` :: +`--disable` `` :: Flag to disable the storage. -`-export` `` :: +`--domain` `` :: + +CIFS domain. + +`--export` `` :: NFS export path. -`-format` `` :: +`--format` `` :: Default image format. -`-is_mountpoint` `` ('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` `` :: +`--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` `` :: +`--krbd` `` :: + +Always access rbd through krbd kernel module. + +`--lio_tpg` `` :: -Access rbd through krbd kernel module. +target portal group for Linux LIO targets -`-maxfiles` ` (0 - N)` :: +`--maxfiles` ` (0 - N)` :: Maximal number of backup files per VM. Use '0' for unlimted. -`-mkdir` `` ('default =' `yes`):: +`--mkdir` `` ('default =' `yes`):: Create the directory if it doesn't exist. -`-monhost` `` :: +`--monhost` `` :: -Monitors daemon ips. +IP addresses of monitors (for external clusters). -`-nodes` `` :: +`--nodes` `` :: List of cluster node names. -`-nowritecache` `` :: +`--nowritecache` `` :: disable write caching on the target -`-options` `` :: +`--options` `` :: NFS mount options (see 'man nfs') -`-path` `` :: +`--password` `` :: + +Password for CIFS share. + +`--path` `` :: File system path. -`-pool` `` :: +`--pool` `` :: Pool. -`-portal` `` :: +`--portal` `` :: iSCSI portal (IP or DNS name with optional port). -`-redundancy` ` (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` `` :: +`--saferemove` `` :: Zero-out data when removing LVs. -`-saferemove_throughput` `` :: +`--saferemove_throughput` `` :: Wipe throughput (cstream -t parameter value). -`-server` `` :: +`--server` `` :: Server IP or DNS name. -`-server2` `` :: +`--server2` `` :: Backup volfile server IP or DNS name. + NOTE: Requires option(s): `server` -`-shared` `` :: +`--share` `` :: + +CIFS share. + +`--shared` `` :: Mark storage as shared. -`-sparse` `` :: +`--smbversion` `<2.0 | 2.1 | 3.0>` :: + +SMB protocol version + +`--sparse` `` :: use sparse volumes -`-tagged_only` `` :: +`--subdir` `` :: + +Subdir to mount. + +`--tagged_only` `` :: Only use logical volumes tagged with 'pve-vm-ID'. -`-target` `` :: +`--target` `` :: iSCSI target. -`-thinpool` `` :: +`--thinpool` `` :: LVM thin pool LV name. -`-transport` `` :: +`--transport` `` :: Gluster transport: tcp or rdma -`-username` `` :: +`--username` `` :: RBD Id. -`-vgname` `` :: +`--vgname` `` :: Volume group name. -`-volume` `` :: +`--volume` `` :: Glusterfs Volume. - - - *pvesm alloc* ` ` `[OPTIONS]` Allocate disk images. @@ -179,25 +208,51 @@ The name of the file to create. Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M) -`-format` `` :: +`--format` `` :: no description available + NOTE: Requires option(s): `size` +*pvesm cifsscan* +An alias for 'pvesm scan cifs'. +*pvesm export* ` ` `[OPTIONS]` -*pvesm extractconfig* `` - -Extract configuration from vzdump backup archive. +Export a volume. ``: `` :: Volume identifier +``: `` :: + +Export stream format + +``: `` :: + +Destination file name + +`--base` `(?^:[a-z0-9_\-]{1,40})` :: + +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 *pvesm free* `` `[OPTIONS]` @@ -207,49 +262,57 @@ Delete volume Volume identifier -`-storage` `` :: +`--storage` `` :: The storage identifier. +*pvesm glusterfsscan* +An alias for 'pvesm scan glusterfs'. +*pvesm help* `[OPTIONS]` -*pvesm glusterfsscan* `` - -Scan remote GlusterFS server. - -``: `` :: +Get help about specified command. -no description available +`--extra-args` `` :: +Shows help for a specific command +`--verbose` `` :: +Verbose output format. -*pvesm help* `[]` `[OPTIONS]` +*pvesm import* ` ` `[OPTIONS]` -Get help about specified command. +Import a volume. -``: `` :: +``: `` :: -Command name +Volume identifier -`-verbose` `` :: +``: `` :: -Verbose output format. +Import stream format +``: `` :: +Source file name +`--base` `(?^:[a-z0-9_\-]{1,40})` :: -*pvesm iscsiscan* `-portal ` `[OPTIONS]` +Base snapshot of an incremental stream -Scan remote iSCSI server. +`--delete-snapshot` `(?^:[a-z0-9_\-]{1,80})` :: -`-portal` `` :: +A snapshot to delete on success -no description available +`--with-snapshots` `` ('default =' `0`):: +Whether the stream includes intermediate snapshots +*pvesm iscsiscan* +An alias for 'pvesm scan iscsi'. *pvesm list* `` `[OPTIONS]` @@ -259,64 +322,101 @@ List storage content. The storage identifier. -`-content` `` :: +`--content` `` :: Only list content of this type. -`-vmid` ` (1 - N)` :: +`--vmid` ` (1 - N)` :: Only list images for this VM +*pvesm lvmscan* +An alias for 'pvesm scan lvm'. +*pvesm lvmthinscan* -*pvesm lvmscan* +An alias for 'pvesm scan lvmthin'. -List local LVM volume groups. +*pvesm nfsscan* +An alias for 'pvesm scan nfs'. +*pvesm path* `` -*pvesm lvmthinscan* `` +Get filesystem path for specified volume -List local LVM Thin Pools. +``: `` :: -``: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` :: +Volume identifier -no description available +*pvesm remove* `` + +Delete storage configuration. +``: `` :: +The storage identifier. -*pvesm nfsscan* `` +*pvesm scan cifs* `` `[OPTIONS]` -Scan remote NFS server. +Scan remote CIFS server. ``: `` :: -no description available +The server address (name or IP). +`--domain` `` :: +SMB domain (Workgroup). +`--password` `` :: -*pvesm path* `` +User password. -Get filesystem path for specified volume +`--username` `` :: -``: `` :: +User name. -Volume identifier +*pvesm scan glusterfs* `` +Scan remote GlusterFS server. +``: `` :: +The server address (name or IP). -*pvesm remove* `` +*pvesm scan iscsi* `` -Delete storage configuration. +Scan remote iSCSI server. -``: `` :: +``: `` :: -The storage identifier. +The iSCSI portal (IP or DNS name with optional port). + +*pvesm scan lvm* + +List local LVM volume groups. + +*pvesm scan lvmthin* `` + +List local LVM Thin Pools. + +``: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` :: + +no description available + +*pvesm scan nfs* `` + +Scan remote NFS server. +``: `` :: + +The server address (name or IP). +*pvesm scan zfs* + +Scan zfs pool list on local node. *pvesm set* `` `[OPTIONS]` @@ -326,144 +426,172 @@ Update storage configuration. The storage identifier. -`-blocksize` `` :: +`--blocksize` `` :: block size -`-comstar_hg` `` :: +`--bwlimit` `[clone=] [,default=] [,migration=] [,move=] [,restore=]` :: + +Set bandwidth/io limits various operations. + +`--comstar_hg` `` :: host group for comstar views -`-comstar_tg` `` :: +`--comstar_tg` `` :: target group for comstar views -`-content` `` :: +`--content` `` :: Allowed content types. + NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs. -`-delete` `` :: +`--delete` `` :: A list of settings you want to delete. -`-digest` `` :: +`--digest` `` :: Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications. -`-disable` `` :: +`--disable` `` :: Flag to disable the storage. -`-format` `` :: +`--domain` `` :: + +CIFS domain. + +`--format` `` :: Default image format. -`-is_mountpoint` `` ('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. -`-krbd` `` :: +`--is_mountpoint` `` ('default =' `no`):: -Access rbd through krbd kernel module. +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. -`-maxfiles` ` (0 - N)` :: +`--krbd` `` :: + +Always access rbd through krbd kernel module. + +`--lio_tpg` `` :: + +target portal group for Linux LIO targets + +`--maxfiles` ` (0 - N)` :: Maximal number of backup files per VM. Use '0' for unlimted. -`-mkdir` `` ('default =' `yes`):: +`--mkdir` `` ('default =' `yes`):: Create the directory if it doesn't exist. -`-nodes` `` :: +`--monhost` `` :: + +IP addresses of monitors (for external clusters). + +`--nodes` `` :: List of cluster node names. -`-nowritecache` `` :: +`--nowritecache` `` :: disable write caching on the target -`-options` `` :: +`--options` `` :: NFS mount options (see 'man nfs') -`-pool` `` :: +`--password` `` :: + +Password for CIFS share. + +`--pool` `` :: Pool. -`-redundancy` ` (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` `` :: +`--saferemove` `` :: Zero-out data when removing LVs. -`-saferemove_throughput` `` :: +`--saferemove_throughput` `` :: Wipe throughput (cstream -t parameter value). -`-server` `` :: +`--server` `` :: Server IP or DNS name. -`-server2` `` :: +`--server2` `` :: Backup volfile server IP or DNS name. + NOTE: Requires option(s): `server` -`-shared` `` :: +`--shared` `` :: Mark storage as shared. -`-sparse` `` :: +`--smbversion` `<2.0 | 2.1 | 3.0>` :: + +SMB protocol version + +`--sparse` `` :: use sparse volumes -`-tagged_only` `` :: +`--subdir` `` :: + +Subdir to mount. + +`--tagged_only` `` :: Only use logical volumes tagged with 'pve-vm-ID'. -`-transport` `` :: +`--transport` `` :: Gluster transport: tcp or rdma -`-username` `` :: +`--username` `` :: RBD Id. - - - *pvesm status* `[OPTIONS]` Get status for all datastores. -`-content` `` :: +`--content` `` :: Only list stores which support this content type. -`-enabled` `` ('default =' `0`):: +`--enabled` `` ('default =' `0`):: Only list stores which are enabled (not disabled in config). -`-storage` `` :: +`--format` `` ('default =' `0`):: -Only list status for specified storage +Include information about formats -`-target` `` :: - -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. - - +An alias for 'pvesm scan zfs'.