X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-storage-cifs.adoc;h=bb4b90228fd3b9fb2b30b9c6402b8771022f10b8;hp=bc49fa3e86a614b93729dada656eeecb6db5a48d;hb=HEAD;hpb=0ddd42aa6372fc5798ccda83ecd710f279d6216e diff --git a/pve-storage-cifs.adoc b/pve-storage-cifs.adoc index bc49fa3..d5d54e7 100644 --- a/pve-storage-cifs.adoc +++ b/pve-storage-cifs.adoc @@ -10,7 +10,7 @@ Storage pool type: `cifs` The CIFS backend extends the directory backend, so that no manual setup of a CIFS mount is needed. Such a storage can be added directly -through the {pve} API or the WebUI, with all our backend advantages, +through the {pve} API or the web UI, with all our backend advantages, like server heartbeat check or comfortable selection of exported shares. @@ -31,8 +31,8 @@ server, or list the server in the local `/etc/hosts` file. share:: -CIFS share to use (get available ones with `pvesm cifsscan` or the WebUI). -Required. +CIFS share to use (get available ones with `pvesm scan cifs
` or the +web UI). Required. username:: @@ -42,7 +42,7 @@ password:: The user password. Optional. It will be saved in a file only readable by root -(`/etc/pve/priv/.cred`). +(`/etc/pve/priv/storage/.pw`). domain:: @@ -57,6 +57,22 @@ path:: The local mount point. Optional, defaults to `/mnt/pve//`. +content-dirs:: + +Overrides for the default directory layout. Optional. + +options:: + +Additional CIFS mount options (see `man mount.cifs`). Some options are set +automatically and shouldn't be set here. {pve} will always set the option +`soft`. Depending on the configuration, these options are set automatically: +`username`, `credentials`, `guest`, `domain`, `vers`. + +subdir:: + +The subdirectory of the share to mount. Optional, defaults to the root directory +of the share. + .Configuration Example (`/etc/pve/storage.cfg`) ---- cifs: backup @@ -64,8 +80,10 @@ cifs: backup server 10.0.0.11 share VMData content backup + options noserverino,echo_interval=30 username anna smbversion 3 + subdir /data ---- @@ -79,8 +97,8 @@ features available. .Storage features for backend `cifs` [width="100%",cols="m,m,3*d",options="header"] |============================================================================== -|Content types |Image formats |Shared |Snapshots |Clones -|images rootdir vztmpl iso backup |raw qcow2 vmdk |yes |qcow2 |qcow2 +|Content types |Image formats |Shared |Snapshots |Clones +|images rootdir vztmpl iso backup snippets |raw qcow2 vmdk |yes |qcow2 |qcow2 |============================================================================== Examples @@ -89,7 +107,7 @@ Examples You can get a list of exported CIFS shares with: ---- -# pvesm cifsscan [--username ] [--password] +# pvesm scan cifs [--username ] [--password] ---- Then you could add this share as a storage to the whole {pve} cluster