]>
Commit | Line | Data |
---|---|---|
0ddd42aa | 1 | [[storage_cifs]] |
de14ebff WL |
2 | CIFS Backend |
3 | ----------- | |
4 | ifdef::wiki[] | |
5 | :pve-toplevel: | |
6 | :title: Storage: CIFS | |
7 | endif::wiki[] | |
8 | ||
9 | Storage pool type: `cifs` | |
10 | ||
0ddd42aa TL |
11 | The CIFS backend extends the directory backend, so that no manual |
12 | setup of a CIFS mount is needed. Such a storage can be added directly | |
13 | through the {pve} API or the WebUI, with all our backend advantages, | |
14 | like server heartbeat check or comfortable selection of exported | |
15 | shares. | |
de14ebff WL |
16 | |
17 | Configuration | |
18 | ~~~~~~~~~~~~~ | |
19 | ||
20 | The backend supports all common storage properties, except the shared | |
0ddd42aa TL |
21 | flag, which is always set. Additionally, the following CIFS special |
22 | properties are available: | |
de14ebff WL |
23 | |
24 | server:: | |
25 | ||
0ddd42aa | 26 | Server IP or DNS name. Required. |
de14ebff | 27 | |
0ddd42aa TL |
28 | TIP: To avoid DNS lookup delays, it is usually preferable to use an IP |
29 | address instead of a DNS name - unless you have a very reliable DNS | |
30 | server, or list the server in the local `/etc/hosts` file. | |
de14ebff | 31 | |
0ddd42aa | 32 | share:: |
de14ebff | 33 | |
84f91027 TL |
34 | CIFS share to use (get available ones with `pvesm scan cifs <address>` or the |
35 | WebUI). Required. | |
de14ebff WL |
36 | |
37 | username:: | |
38 | ||
0ddd42aa | 39 | The username for the CIFS storage. Optional, defaults to `guest'. |
de14ebff WL |
40 | |
41 | password:: | |
42 | ||
0ddd42aa TL |
43 | The user password. Optional. |
44 | It will be saved in a file only readable by root | |
84f91027 | 45 | (`/etc/pve/priv/storage/<STORAGE-ID>.pw`). |
de14ebff WL |
46 | |
47 | domain:: | |
48 | ||
0ddd42aa | 49 | Sets the user domain (workgroup) for this storage. Optional. |
de14ebff WL |
50 | |
51 | smbversion:: | |
52 | ||
0ddd42aa | 53 | SMB protocol Version. Optional, default is `3`. |
de14ebff WL |
54 | SMB1 is not supported due to security issues. |
55 | ||
56 | path:: | |
57 | ||
0ddd42aa | 58 | The local mount point. Optional, defaults to `/mnt/pve/<STORAGE_ID>/`. |
de14ebff WL |
59 | |
60 | .Configuration Example (`/etc/pve/storage.cfg`) | |
61 | ---- | |
62 | cifs: backup | |
63 | path /mnt/pve/backup | |
64 | server 10.0.0.11 | |
65 | share VMData | |
66 | content backup | |
67 | username anna | |
68 | smbversion 3 | |
69 | ||
70 | ---- | |
71 | ||
72 | Storage Features | |
73 | ~~~~~~~~~~~~~~~~ | |
74 | ||
0ddd42aa TL |
75 | CIFS does not support snapshots on a storage level. But you may use |
76 | `qcow2` backing files if you still want to have snapshots and cloning | |
77 | features available. | |
de14ebff | 78 | |
0ddd42aa | 79 | .Storage features for backend `cifs` |
de14ebff WL |
80 | [width="100%",cols="m,m,3*d",options="header"] |
81 | |============================================================================== | |
c2c8eb89 DC |
82 | |Content types |Image formats |Shared |Snapshots |Clones |
83 | |images rootdir vztmpl iso backup snippets |raw qcow2 vmdk |yes |qcow2 |qcow2 | |
de14ebff WL |
84 | |============================================================================== |
85 | ||
86 | Examples | |
87 | ~~~~~~~~ | |
88 | ||
89 | You can get a list of exported CIFS shares with: | |
90 | ||
0ddd42aa | 91 | ---- |
84f91027 | 92 | # pvesm scan cifs <server> [--username <username>] [--password] |
0ddd42aa TL |
93 | ---- |
94 | ||
95 | Then you could add this share as a storage to the whole {pve} cluster | |
96 | with: | |
97 | ||
98 | ---- | |
99 | # pvesm add cifs <storagename> --server <server> --share <share> [--username <username>] [--password] | |
100 | ---- | |
de14ebff WL |
101 | |
102 | ifdef::wiki[] | |
103 | ||
104 | See Also | |
105 | ~~~~~~~~ | |
106 | ||
107 | * link:/wiki/Storage[Storage] | |
108 | ||
109 | endif::wiki[] |