The EMC Shared File Systems service driver framework (EMCShareDriver) utilizes the EMC storage products to provide the shared file systems to OpenStack. The EMC driver is a plug-in based driver which is designed to use different plug-ins to manage different EMC storage products.
The VNX plug-in is the plug-in which manages the VNX to provide shared filesystems. The EMC driver framework with the VNX plug-in is referred to as the VNX driver in this document.
This driver performs the operations on VNX by XMLAPI and the file command line. Each back end manages one Data Mover of VNX. Multiple Shared File Systems service back ends need to be configured to manage multiple Data Movers.
Enable unicode on Data Mover.
The VNX driver requires that the unicode is enabled on Data Mover.
Warning
After enabling Unicode, you cannot disable it. If there are some filesystems created before Unicode is enabled on the VNX, consult the storage administrator before enabling Unicode.
To check the Unicode status on Data Mover, use the following VNX File command on the VNX control station:
server_cifs <mover_name> | head
# mover_name = <name of the Data Mover>
Check the value of I18N mode field. UNICODE mode is shown as
I18N mode = UNICODE
.
To enable the Unicode for Data Mover:
uc_config -on -mover <mover_name>
# mover_name = <name of the Data Mover>
Refer to the document Using International Character Sets on VNX for File on EMC support site for more information.
Enable CIFS service on Data Mover.
Ensure the CIFS service is enabled on the Data Mover which is going to be managed by VNX driver.
To start the CIFS service, use the following command:
server_setup <mover_name> -Protocol cifs -option start [=<n>]
# mover_name = <name of the Data Mover>
# n = <number of threads for CIFS users>
Note
If there is 1 GB of memory on the Data Mover, the default is 96 threads; however, if there is over 1 GB of memory, the default number of threads is 256.
To check the CIFS service status, use this command:
server_cifs <mover_name> | head
# mover_name = <name of the Data Mover>
The command output will show the number of CIFS threads started.
NTP settings on Data Mover.
VNX driver only supports CIFS share creation with share network which has an Active Directory security-service associated.
Creating CIFS share requires that the time on the Data Mover is in sync with the Active Directory domain so that the CIFS server can join the domain. Otherwise, the domain join will fail when creating 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.
It is recommended to set the NTP server to the same public NTP server on both the Data Mover and domains used in security services to ensure the time is in sync everywhere.
Check the date and time on Data Mover:
server_date <mover_name>
# mover_name = <name of the Data Mover>
Set the NTP server for Data Mover:
server_date <mover_name> timesvc start ntp <host> [<host> ...]
# mover_name = <name of the Data Mover>
# host = <IP address of the time server host>
Note
The host must be running the NTP protocol. Only 4 host entries are allowed.
Configure User Mapping on the Data Mover.
Before creating CIFS share using VNX driver, you must select a method of mapping Windows SIDs to UIDs and GIDs. EMC recommends using usermapper in single protocol (CIFS) environment which is enabled on VNX by default.
To check usermapper status, use this command syntax:
server_usermapper <movername>
# movername = <name of the Data Mover>
If usermapper is not started, the following command can be used to start the usermapper:
server_usermapper <movername> -enable
# movername = <name of the Data Mover>
For a multiple protocol environment, refer to Configuring VNX User Mapping on EMC support site for additional information.
Network Connection.
Find the network devices (physical port on NIC) of Data Mover that has access to the share network.
Go to Unisphere to check the device list: .
The following parameters need to be configured in the
/etc/manila/manila.conf
file for the VNX driver:
emc_share_backend = vnx
emc_nas_server = <IP address>
emc_nas_password = <password>
emc_nas_login = <user>
vnx_server_container = <Data Mover name>
vnx_share_data_pools = <Comma separated pool names>
share_driver = manila.share.drivers.emc.driver.EMCShareDriver
vnx_ethernet_ports = <Comma separated ports list>
The plug-in name. Set it to vnx
for the VNX driver.
The control station IP address of the VNX system to be managed.
The fields that are used to provide credentials to the VNX system. Only local users of VNX File is supported.
Name of the Data Mover to serve the share service.
Comma separated list specifying the name of the pools to be used by this back end. Do not set this option if all storage pools on the system can be used. Wild card character is supported.
Examples: pool_1, pool_*, *
Comma separated list specifying the ports (devices) of Data Mover that can be used for share server interface. Do not set this option if all ports on the Data Mover can be used. Wild card character is supported.
Examples: spa_eth1, spa_*, *
Restart of the manila-share
service is needed for the configuration
changes to take effect.
The VNX driver has the following restrictions:
Active Directory
security service is the only supported
security service type and it is required to create CIFS shares.Configuration options specific to this driver:
Configuration option = Default value | Description |
---|---|
[DEFAULT] | |
vnx_ethernet_ports = None |
(List) Comma separated list of ports that can be used for share server interfaces. Members of the list can be Unix-style glob expressions. |
vnx_server_container = None |
(String) Data mover to host the NAS server. |
vnx_share_data_pools = None |
(List) Comma separated list of pools that can be used to persist share data. |
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.