summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZuul <zuul@review.openstack.org>2019-03-15 18:45:52 +0000
committerGerrit Code Review <review@openstack.org>2019-03-15 18:45:52 +0000
commitc90c42d9851223f33d389e823c8818c6a2c7a6a2 (patch)
treeb62612e2346517f1b003c8d0bca5497f3f4dac91
parentab4914a8eefce764acd10ac10b3605187c09f629 (diff)
parent21d5f1ecaa83f0da30d0a844567489765896246b (diff)
Merge "Manila VMAX docs - improve pre-configurations on VMAX section" into stable/rocky
-rw-r--r--doc/source/configuration/shared-file-systems/drivers/dell-emc-vmax-driver.rst117
1 files changed, 82 insertions, 35 deletions
diff --git a/doc/source/configuration/shared-file-systems/drivers/dell-emc-vmax-driver.rst b/doc/source/configuration/shared-file-systems/drivers/dell-emc-vmax-driver.rst
index 3127da4..90fceac 100644
--- a/doc/source/configuration/shared-file-systems/drivers/dell-emc-vmax-driver.rst
+++ b/doc/source/configuration/shared-file-systems/drivers/dell-emc-vmax-driver.rst
@@ -66,37 +66,45 @@ using the Data Movers on the array.
66Pre-configurations on VMAX 66Pre-configurations on VMAX
67~~~~~~~~~~~~~~~~~~~~~~~~~~ 67~~~~~~~~~~~~~~~~~~~~~~~~~~
68 68
69#. Enable Unicode on Data Mover. 69#. Configure a storage pool
70 70
71 The VMAX driver requires that the Unicode is enabled on Data Mover. 71 There is a one to one relationship between a storage pool in embedded NAS
72 to a storage group on the VMAX. The best way to provision
73 storage for file is from the Unisphere for VMAX UI rather than eNAS UI.
74 Go to :menuselection:`{array} > SYSTEM > FIle` and under
75 :menuselection:`Actions` click :menuselection:`PROVISION STORAGE FOR FILE`
72 76
73 .. warning:: 77 .. note::
78
79 When creating a new storage group you have the ability to assign a
80 service level e.g. Diamond and disable compression/deduplication
81 which is enabled by default.
74 82
75 After enabling Unicode, you cannot disable it. If there are some 83 To pick up the newly created storage pool in the eNAS UI,
76 file systems created before Unicode is enabled on the VMAX, 84 go to :menuselection:`{Control Station} > Storage > Storage Configuration > Storage Pools`
77 consult the storage administrator before enabling Unicode. 85 and under :menuselection:`File Storage` click :menuselection:`Rescan Storage Systems`
78 86
79 To check the Unicode status on Data Mover, use the following VMAX eNAS File 87 or on the command line:
80 commands on the VMAX control station:
81 88
82 .. code-block:: console 89 .. code-block:: console
83 90
84 server_cifs <MOVER_NAME> | head 91 $ nas_diskmark -mark -all -discovery y -monitor y
85 # MOVER_NAME = <name of the Data Mover>
86 92
87 Check the value of I18N mode field. UNICODE mode is shown as 93 The new storage pool should now appear in the eNAS UI
88 ``I18N mode = UNICODE``.
89 94
90 To enable the Unicode for Data Mover, use the following command: 95#. Make sure you have the appropriate licenses
91 96
92 .. code-block:: console 97 .. code-block:: console
93 98
94 uc_config -on -mover <MOVER_NAME> 99 $ nas_license -l
95 # MOVER_NAME = <name of the Data Mover> 100 key status value
101 site_key online xx xx xx xx
102 nfs online
103 cifs online
104 snapsure online
105 replicatorV2 online
106 filelevelretention online
96 107
97 Refer to the document Using International Character Sets on VMAX for
98 File on `EMC support site <http://support.emc.com>`_ for more
99 information.
100 108
101#. Enable CIFS service on Data Mover. 109#. Enable CIFS service on Data Mover.
102 110
@@ -107,9 +115,9 @@ Pre-configurations on VMAX
107 115
108 .. code-block:: console 116 .. code-block:: console
109 117
110 server_setup <MOVER_NAME> -Protocol cifs -option start [=<n>] 118 $ server_setup <movername> -Protocol cifs -option start [=<n>]
111 # MOVER_NAME = <name of the Data Mover> 119 # movername = name of the Data Mover
112 # n = <number of threads for CIFS users> 120 # n = number of threads for CIFS users
113 121
114 .. note:: 122 .. note::
115 123
@@ -121,8 +129,8 @@ Pre-configurations on VMAX
121 129
122 .. code-block:: console 130 .. code-block:: console
123 131
124 server_cifs <MOVER_NAME> | head 132 $ server_cifs <movername> | head
125 # MOVER_NAME = <name of the Data Mover> 133 # movername = name of the Data Mover
126 134
127 The command output will show the number of CIFS threads started. 135 The command output will show the number of CIFS threads started.
128 136
@@ -137,7 +145,19 @@ Pre-configurations on VMAX
137 a share with this security service. There is a limitation that the 145 a share with this security service. There is a limitation that the
138 time of the domains used by security-services, even for different 146 time of the domains used by security-services, even for different
139 tenants and different share networks, should be in sync. Time 147 tenants and different share networks, should be in sync. Time
140 difference should be less than 10 minutes. 148 difference should be less than 5 minutes.
149
150 .. note::
151
152 If there is a clock skew then you may see the following error
153 "The local machine and the remote machine are not synchronized.
154 Kerberos protocol requires a synchronization of both participants
155 within the same 5 minutes". To fix this error you must make sure
156 the times of the eNas controller host and the Domain Controller
157 or within 5 minutes of each other. You must be root to change the
158 date of the eNas control station. Check also that your time zones
159 coincide.
160
141 161
142 We recommend setting the NTP server to the same public NTP 162 We recommend setting the NTP server to the same public NTP
143 server on both the Data Mover and domains used in security services 163 server on both the Data Mover and domains used in security services
@@ -147,16 +167,16 @@ Pre-configurations on VMAX
147 167
148 .. code-block:: console 168 .. code-block:: console
149 169
150 server_date <MOVER_NAME> 170 $ server_date <movername>
151 # MOVER_NAME = <name of the Data Mover> 171 # movername = name of the Data Mover
152 172
153 Set the NTP server for Data Mover with the following command: 173 Set the NTP server for Data Mover with the following command:
154 174
155 .. code-block:: console 175 .. code-block:: console
156 176
157 server_date <MOVER_NAME> timesvc start ntp <host> [<host> ...] 177 $ server_date <movername> timesvc start ntp <host> [<host> ...]
158 # MOVER_NAME = <name of the Data Mover> 178 # movername = name of the Data Mover
159 # host = <IP address of the time server host> 179 # host = IP address of the time server host
160 180
161 .. note:: 181 .. note::
162 182
@@ -174,16 +194,16 @@ Pre-configurations on VMAX
174 194
175 .. code-block:: console 195 .. code-block:: console
176 196
177 server_usermapper <movername> 197 $ server_usermapper <movername>
178 # movername = <name of the Data Mover> 198 # movername = name of the Data Mover
179 199
180 If usermapper does not start, use the following command 200 If usermapper does not start, use the following command
181 to start the usermapper: 201 to start the usermapper:
182 202
183 .. code-block:: console 203 .. code-block:: console
184 204
185 server_usermapper <movername> -enable 205 $ server_usermapper <movername> -enable
186 # movername = <name of the Data Mover> 206 # movername = name of the Data Mover
187 207
188 For a multiple protocol environment, refer to Configuring VMAX eNAS User 208 For a multiple protocol environment, refer to Configuring VMAX eNAS User
189 Mapping on `EMC support site <http://support.emc.com>`_ for 209 Mapping on `EMC support site <http://support.emc.com>`_ for
@@ -194,8 +214,35 @@ Pre-configurations on VMAX
194 Find the network devices (physical port on NIC) of the Data Mover that 214 Find the network devices (physical port on NIC) of the Data Mover that
195 has access to the share network. 215 has access to the share network.
196 216
197 To check the device list, go 217 To check the device list on the eNAS UI go
198 to :menuselection:`Unisphere > Settings > Network > Device`. 218 to :menuselection:`{Control Station} > Settings > Network > Devices`.
219
220 or on the command line:
221
222 .. code-block:: console
223
224 $ server_sysconfig server_2 -pci
225 server_2 : PCI DEVICES:
226
227 On Board:
228 VendorID=0x1120 DeviceID=0x1B00 Controller
229 0: scsi-0 IRQ: 32
230
231 0: scsi-16 IRQ: 33
232
233 0: scsi-32 IRQ: 34
234
235 0: scsi-48 IRQ: 35
236
237 Broadcom 10 Gigabit Ethernet Controller
238 0: fxg-3-0 IRQ: 36
239 speed=10000 duplex=full txflowctl=disable rxflowctl=disable
240 Link: Up
241
242 0: fxg-3-1 IRQ: 38
243 speed=10000 duplex=full txflowctl=disable rxflowctl=disable
244 Link: Down
245
199 246
200Back-end configurations 247Back-end configurations
201~~~~~~~~~~~~~~~~~~~~~~~ 248~~~~~~~~~~~~~~~~~~~~~~~