From 2528762a694d428bd037ec134d611ea86075bdfd Mon Sep 17 00:00:00 2001 From: Helen Walsh Date: Tue, 12 Mar 2019 16:38:42 +0000 Subject: [PATCH] Manila VMAX docs - improve pre-configurations on VMAX section Add storage pool and license configuration to the Pre-configurations on VMAX section. Change-Id: I9f598c6918455de7344d80d2663d9fd3a4cc3ed9 --- .../drivers/dell-emc-vmax-driver.rst | 117 ++++++++++++------ 1 file 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 3127da4492..90fceac1a6 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. 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 - file systems created before Unicode is enabled on the VMAX, - consult the storage administrator before enabling Unicode. + When creating a new storage group you have the ability to assign a + service level e.g. Diamond and disable compression/deduplication + which is enabled by default. - To check the Unicode status on Data Mover, use the following VMAX eNAS File - commands on the VMAX control station: + To pick up the newly created storage pool in the eNAS UI, + 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 - server_cifs | head - # MOVER_NAME = + $ nas_diskmark -mark -all -discovery y -monitor y - Check the value of I18N mode field. UNICODE mode is shown as - ``I18N mode = UNICODE``. + The new storage pool should now appear in the eNAS UI - To enable the Unicode for Data Mover, use the following command: +#. Make sure you have the appropriate licenses .. code-block:: console - uc_config -on -mover - # MOVER_NAME = + $ nas_license -l + 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 `_ for more - information. #. Enable CIFS service on Data Mover. @@ -107,9 +115,9 @@ Pre-configurations on VMAX .. code-block:: console - server_setup -Protocol cifs -option start [=] - # MOVER_NAME = - # n = + $ server_setup -Protocol cifs -option start [=] + # movername = name of the Data Mover + # n = number of threads for CIFS users .. note:: @@ -121,8 +129,8 @@ Pre-configurations on VMAX .. code-block:: console - server_cifs | head - # MOVER_NAME = + $ server_cifs | head + # movername = name of the Data Mover 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 time of the domains used by security-services, even for different 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 server on both the Data Mover and domains used in security services @@ -147,16 +167,16 @@ Pre-configurations on VMAX .. code-block:: console - server_date - # MOVER_NAME = + $ server_date + # movername = name of the Data Mover Set the NTP server for Data Mover with the following command: .. code-block:: console - server_date timesvc start ntp [ ...] - # MOVER_NAME = - # host = + $ server_date timesvc start ntp [ ...] + # movername = name of the Data Mover + # host = IP address of the time server host .. note:: @@ -174,16 +194,16 @@ Pre-configurations on VMAX .. code-block:: console - server_usermapper - # movername = + $ server_usermapper + # movername = name of the Data Mover If usermapper does not start, use the following command to start the usermapper: .. code-block:: console - server_usermapper -enable - # movername = + $ server_usermapper -enable + # movername = name of the Data Mover For a multiple protocol environment, refer to Configuring VMAX eNAS User Mapping on `EMC support site `_ for @@ -194,8 +214,35 @@ Pre-configurations on VMAX Find the network devices (physical port on NIC) of the Data Mover that has access to the share network. - To check the device list, go - to :menuselection:`Unisphere > Settings > Network > Device`. + To check the device list on the eNAS UI go + 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 ~~~~~~~~~~~~~~~~~~~~~~~