openstack
/
manila
Code Issues Proposed changes

Merge "Manila VMAX docs - improve pre-configurations on VMAX section" into stable/rocky

This commit is contained in:
Zuul 2019-03-15 18:45:52 +00:00 committed by Gerrit Code Review
parent ab4914a8ee 21d5f1ecaa
commit c90c42d985
1 changed files with 82 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

117
doc/source/configuration/shared-file-systems/drivers/dell-emc-vmax-driver.rst
View File

@ -66,37 +66,45 @@ using the Data Movers on the array.
Pre-configurations on VMAX Pre-configurations on VMAX
~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~
#. Enable Unicode on Data Mover. #. Configure a storage pool
The VMAX driver requires that the Unicode is enabled on Data Mover. There is a one to one relationship between a storage pool in embedded NAS
to a storage group on the VMAX. The best way to provision
storage for file is from the Unisphere for VMAX UI rather than eNAS UI.
Go to :menuselection:`{array} > SYSTEM > FIle` and under
:menuselection:`Actions` click :menuselection:`PROVISION STORAGE FOR FILE`
.. warning:: .. note::
After enabling Unicode, you cannot disable it. If there are some When creating a new storage group you have the ability to assign a
file systems created before Unicode is enabled on the VMAX, service level e.g. Diamond and disable compression/deduplication
consult the storage administrator before enabling Unicode. which is enabled by default.
To check the Unicode status on Data Mover, use the following VMAX eNAS File To pick up the newly created storage pool in the eNAS UI,
commands on the VMAX control station: go to :menuselection:`{Control Station} > Storage > Storage Configuration > Storage Pools`
and under :menuselection:`File Storage` click :menuselection:`Rescan Storage Systems`
or on the command line:
.. code-block:: console .. code-block:: console
server_cifs <MOVER_NAME> | head $ nas_diskmark -mark -all -discovery y -monitor y
# MOVER_NAME = <name of the Data Mover>
Check the value of I18N mode field. UNICODE mode is shown as The new storage pool should now appear in the eNAS UI
``I18N mode = UNICODE``.
To enable the Unicode for Data Mover, use the following command: #. Make sure you have the appropriate licenses
.. code-block:: console .. code-block:: console
uc_config -on -mover <MOVER_NAME> $ nas_license -l
# MOVER_NAME = <name of the Data Mover> key status value
site_key online xx xx xx xx
nfs online
cifs online
snapsure online
replicatorV2 online
filelevelretention online
Refer to the document Using International Character Sets on VMAX for
File on `EMC support site <http://support.emc.com>`_ for more
information.
#. Enable CIFS service on Data Mover. #. Enable CIFS service on Data Mover.
@ -107,9 +115,9 @@ Pre-configurations on VMAX
.. code-block:: console .. code-block:: console
server_setup <MOVER_NAME> -Protocol cifs -option start [=<n>] $ server_setup <movername> -Protocol cifs -option start [=<n>]
# MOVER_NAME = <name of the Data Mover> # movername = name of the Data Mover
# n = <number of threads for CIFS users> # n = number of threads for CIFS users
.. note:: .. note::
@ -121,8 +129,8 @@ Pre-configurations on VMAX
.. code-block:: console .. code-block:: console
server_cifs <MOVER_NAME> | head $ server_cifs <movername> | head
# MOVER_NAME = <name of the Data Mover> # movername = name of the Data Mover
The command output will show the number of CIFS threads started. The command output will show the number of CIFS threads started.
@ -137,7 +145,19 @@ Pre-configurations on VMAX
a share with this security service. There is a limitation that the a share with this security service. There is a limitation that the
time of the domains used by security-services, even for different time of the domains used by security-services, even for different
tenants and different share networks, should be in sync. Time tenants and different share networks, should be in sync. Time
difference should be less than 10 minutes. difference should be less than 5 minutes.
.. note::
If there is a clock skew then you may see the following error
"The local machine and the remote machine are not synchronized.
Kerberos protocol requires a synchronization of both participants
within the same 5 minutes". To fix this error you must make sure
the times of the eNas controller host and the Domain Controller
or within 5 minutes of each other. You must be root to change the
date of the eNas control station. Check also that your time zones
coincide.
We recommend setting the NTP server to the same public NTP We recommend setting the NTP server to the same public NTP
server on both the Data Mover and domains used in security services server on both the Data Mover and domains used in security services
@ -147,16 +167,16 @@ Pre-configurations on VMAX
.. code-block:: console .. code-block:: console
server_date <MOVER_NAME> $ server_date <movername>
# MOVER_NAME = <name of the Data Mover> # movername = name of the Data Mover
Set the NTP server for Data Mover with the following command: Set the NTP server for Data Mover with the following command:
.. code-block:: console .. code-block:: console
server_date <MOVER_NAME> timesvc start ntp <host> [<host> ...] $ server_date <movername> timesvc start ntp <host> [<host> ...]
# MOVER_NAME = <name of the Data Mover> # movername = name of the Data Mover
# host = <IP address of the time server host> # host = IP address of the time server host
.. note:: .. note::
@ -174,16 +194,16 @@ Pre-configurations on VMAX
.. code-block:: console .. code-block:: console
server_usermapper <movername> $ server_usermapper <movername>
# movername = <name of the Data Mover> # movername = name of the Data Mover
If usermapper does not start, use the following command If usermapper does not start, use the following command
to start the usermapper: to start the usermapper:
.. code-block:: console .. code-block:: console
server_usermapper <movername> -enable $ server_usermapper <movername> -enable
# movername = <name of the Data Mover> # movername = name of the Data Mover
For a multiple protocol environment, refer to Configuring VMAX eNAS User For a multiple protocol environment, refer to Configuring VMAX eNAS User
Mapping on `EMC support site <http://support.emc.com>`_ for Mapping on `EMC support site <http://support.emc.com>`_ for
@ -194,8 +214,35 @@ Pre-configurations on VMAX
Find the network devices (physical port on NIC) of the Data Mover that Find the network devices (physical port on NIC) of the Data Mover that
has access to the share network. has access to the share network.
To check the device list, go To check the device list on the eNAS UI go
to :menuselection:`Unisphere > Settings > Network > Device`. to :menuselection:`{Control Station} > Settings > Network > Devices`.
or on the command line:
.. code-block:: console
$ server_sysconfig server_2 -pci
server_2 : PCI DEVICES:
On Board:
VendorID=0x1120 DeviceID=0x1B00 Controller
0: scsi-0 IRQ: 32
0: scsi-16 IRQ: 33
0: scsi-32 IRQ: 34
0: scsi-48 IRQ: 35
Broadcom 10 Gigabit Ethernet Controller
0: fxg-3-0 IRQ: 36
speed=10000 duplex=full txflowctl=disable rxflowctl=disable
Link: Up
0: fxg-3-1 IRQ: 38
speed=10000 duplex=full txflowctl=disable rxflowctl=disable
Link: Down
Back-end configurations Back-end configurations
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~