Dell Unity™ Family VNX® Series Data Import to Unity All Flash or Hybrid, or UnityVSA™ System User Guide
Create a NAS import session
Create a NAS import session.
NOTE: This command only creates the import session. To start the import session through the UEMCLI, you must run the
/import/session/nas set command and specify
no for the action qualifier
-paused.
Prerequisites
Before creating a NAS import session, complete the following configuration tasks:
- Create interfaces on both the source and target systems for data transfer.
- Create an import connection from the source VNX to the current Unity-based target system.
- Create a target pool.
- If the source VNX system is configured with the code page 8859-1 or 8859-15 for the NFSv3 clients, ensure that the code page for the Unity system matches the code page being used on the VNX system. With Unity OE 4.3 and later, the code page of the Unity system can be changed through the svc_nas {<NAS_server_name> | all} -param -facility vdm -modify codepage -value <value> service command.
Format
/import/session/nas create [-async] [-name <value>] -srcSys <value> -srcRes <value> -targetResPool <value>< [-targetImportIf <value>] [-productionIfPortPairs <value>] [-productionIfVlanPairs <value>] –fsPoolPairs <value>] –defaultProductionPort <value> [-srcDhsmUsername <value>] [-srcDhsmPasswd <value>] [-srcDhsmPasswdSecure <value>][-unixDirectoryService {directMatch | local | nis | ldap |localThenNis | localThenLdap | none}] [-srcLocalCifsAdminUsername <value> {-srcLocalCifsAdminPasswd <value>|-srcLocalCifsAdminPasswdSecure}] [-srcFsImportedAsVMWareDatastore <value>] [-srcFsImportedWithDataReductionEnabled <value>] [-srcFsImportedWithAdvancedDedupEnabled <value>] [-skipServerParamCheck]Action qualifiers
| Qualifier | Description |
|---|---|
| -async | (Optional) Run operation in asynchronous mode. |
| -name | (Optional) Specifies the new name of the import session.
NOTE: If name is not specified, it is generated in the pattern
import_sess_<srcRes>_<srcSysSerialNumber>_<targetSysSerialNum |
| -srcSys | Specifies the source (remote) system. |
| -srcRes | Specifies the source resource. |
| -targetResPool | Specifies the default storage pool to store target NAS server configuration information and file systems. |
| -targetImportIf | (Optional) Specifies the target replication interface for the import session. |
| -productionIfPortPairs | (Optional) Specifies the source VDM production interfaces and target port pairs. Values are a comma-separated list of mappings between source VDM production interfaces and target ports.
NOTE: Use the following format:
source_interface_1:dest_port_1,source_interface_2:dest_port_2
|
| -productionIfVlanPairs | (Optional) Specifies the source VDM production interface and the target VLAN pairs. Values are a comma-separated list of mappings between source VDM production interfaces and target VLAN pairs.
NOTE: Use the following format:
source_interface_1:1,source_interface_2:2
|
| -fsPoolPairs | (Optional) Specifies the source file system IDs and target pool pairs. Values are a comma separate list of mappings between file system IDs and target pool pairs.
NOTE: Use the format
sourceFsId1:destination_pool_friendlyId (sourceFsid must be an existing supported source file system ID, otherwise validation fails), or
sourceFsId2~sourceFsId3:destination_pool_friendlyId (sourceFsId2 and sourceFsId3 must be existing supported source file system IDs, the other file system IDs between sourceFsId2 and sourceFsId3 do not necessarily must exist. The create process only takes existing source file system IDs and skips nonexistent file system IDs in the range.). For example, for the input
12:pool_1,15~20:pool_2, source file system IDs with 12, 15, and 20 must exist but source file systems with IDs starting from 16 to 19 do not must exist.
|
| -defaultProductionPort | Specifies the target port where NAS server production interfaces will be created by default. |
| -srcDhsmUsername | Specifies the username for authentication to DHSM service on the source Data Mover.
NOTE: When the source VDM has FLR-E/C file systems, file import needs to connect to the DHSM service on the source Data Mover. If the DHSM service is configured with basic or digest authentication, the username needs to be specified.
|
| -srcDhsmPasswd | Specifies the password for authentication to the DHSM service on the source Data Mover. |
| -srcDhsmPasswdSecure | Specifies the password for authentication to the DHSM service on the source Data Mover in secure mode.
NOTE: The user will be prompted to input the password and the password confirmation.
|
| -unixDirectoryService | (Optional) Specifies which UNIX directory service to import. Directory service is used for querying identity information for UNIX (such as UIDs, GIDs, net groups). Valid values are:
|
| -srcLocalCifsAdminUsername | (Optional) Specifies the username for authentication to the CIFS server on the source VDM. |
| -srcLocalCifsAdminPasswd | (Optional) Specifies the password for authentication to the CIFS server on the source VDM. |
| -srcLocalCifsAdminPasswd Secure | (Optional) Specifies the password in secure mode.
NOTE: The user is prompted to input the password and the password confirmation.
|
| -srcFsImportedAsVMWareDatastore | (Optional) Specifies which source file systems are imported as VMWare datastore file systems. Values are a comma-separated list of source file system IDs with comma-separated value of single file system ID or a range of file system IDs; for example,
sourceFsId1,sourceFsId2~sourceFsId3.
sourceFsId1,
sourceFsId2, and
sourceFsId3 must be existing supported source file system IDs. The source file systems with IDs between
sourceFsId2 and
sourceFsId3 do not necessarily must exist. The create process only takes existing source file system IDs and skips nonexistent file systems in the range. For example, for input 13,15~20,25, source file systems with ID 13, 15, 20 and 25 must exist; source file systems with IDs starting from 16 to 19 do not must exist.
NOTE: If a VNX file system is specified by this option, it should not contain any tree quotas or user quotas.
|
| -srcFsImportedWithDataReductionEnabled | (Optional) Specifies which source file systems are imported with data reduction enabled. Values are a comma-separated list of source file system IDs with comma-separated value of single file system ID or a range of file system IDs; for example, sourceFsId1,sourceFsId2~sourceFsId3. sourceFsId1, sourceFsId2, and sourceFsId3 must be existing supported source file system IDs. The source file systems with IDs between sourceFsId2 and sourceFsId3 do not necessarily must exist. The create logic only takes existing source file system IDs and skips nonexistent file systems in the range. For example, for input 13,15~20,25, source file systems with ID 13,15,20 and 25 must exist; source file systems with IDs starting from 16 to 19 do not must exist. |
| -srcFsImportedWithAdvancedDedupEnabled | (Optional) Specifies which source file systems are imported with advanced deduplication enabled. Values are a comma-separated list of source file system IDs with comma-separated value of single file system ID or a range of file system IDs; for example, sourceFsId1,sourceFsId2~sourceFsId3. sourceFsId1, sourceFsId2, and sourceFsId3 must be existing supported source file system IDs. The source file systems with IDs between sourceFsId2 and sourceFsId3 do not necessarily must exist. The create logic only takes existing source file system IDs and skips nonexistent file systems in the range. For example, for input 13,15~20,25, source file systems with ID 13,15,20 and 25 must exist; source file systems with IDs starting from 16 to 19 do not must exist. |
| -skipServerParamCheck | (Optional) Specifies whether to skip server parameters check (comparison). When selected, the server parameters check is skipped. In silent mode, the check is not skipped. Import session creation compares server parameters between VNX and Unity. When import session creation fails with a Server parameter error, this option enables the creation to proceed.
CAUTION: Skipping the server parameters check could lead to disruptive cutover during import.
|
Import session example
The following command creates an import session with these settings:
NOTE: The source VDM is an NFS-only VDM.
- Import session name is newName.
- Source storage system is RS_1.
- Source storage resource (VDM) is src_vdm_to_migrate.
- Target resource pool is pool_1.
- Target import interface is if_3.
- Source VDM production interface and target port pairs are source_interface_1:spa_iom_0_eth1 and source_interface_2:spa_iom_0_eth0.
- Source file system and target pool pairs are 100~200:pool_2 and 255:pool_3.
- Target port where NAS server production interfaces will be created is spa_iom_0_eth0.
- Migrate the direct match UNIX Directory Service.
- File systems 13, 20 through 25, and 30 are to be imported as VMWare datastore file systems.
- Skip the server parameters check.
Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Using '-skipServerParamCheck' option could lead to disruptive cutover during migration. Do you want to continue? yes / no: yes ID = import_1 Operation completed successfully.
The following command creates an import session with these settings:
NOTE: The source VDM is a NFS-only VDM.
- Import session name is newName.
- Source storage system is RS_1.
- Source storage resource (VDM) is src_vdm_to_migrate.
- Target resource pool is pool_1.
- Target import interface is if_3.
- Source VDM production interface and target port pairs are source_interface_1:spa_iom_0_eth1 and source_interface_2:spa_iom_0_eth0.
- Source file system and target pool pairs are 100~200:pool_2 and 255:pool_3.
- Target port where NAS server production interfaces will be created is spa_iom_0_eth0.
- Migrate the direct match UNIX Directory Service.
- File systems 13, 20 through 25, and 30 are to be imported as VMware datastore file systems.
- File systems 14, 22, 25 through 30 are imported as thin.
- File systems 31 and 40 through 45 are imported and have data reduction applied.
- Skip the server parameters check.
Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = import_1 Operation completed successfully.
The following command creates an import session with these settings:
NOTE: The source VDM is a CIFS-only VDM.
- Import session name is newName.
- Source storage system is RS_1.
- Source storage resource (VDM) is src_vdm_to_migrate.
- Target resource pool is pool_1.
- Target import interface is if_3.
- Source VDM production interface and target port pairs are source_interface_1:spa_iom_0_eth1 and source_interface_2:spa_iom_0_eth0.
- Source file system and target pool pairs are 100~200:pool_2 and 255:pool_3.
- Target port where NAS server production interfaces will be created is spa_iom_0_eth0.
- The username for authentication to the CIFS server on the source VDM is cifsadmin1
- The password for authentication to the CIFS server on the source VDM is cifspassword1
- File systems 13, 20 through 25, and 30 are to be imported as VMware datastore file systems.
- File systems 14, 22, 25 through 30 are imported as thin.
- File systems 31 and 40 through 45 are imported and have data reduction applied.
- Skip the server parameters check.
Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Using '-skipServerParamCheck' option could lead to disruptive cutover during migration. Do you want to continue? yes / no: yes ID = import_1 Operation completed successfully.
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please select whether the article was helpful or not.
Comments cannot contain these special characters: <>()\