• Configure import using the CLI

    PDF

    Configure import using the CLI

    Create mobility interfaces

    Create a mobility interface.

    Format
    /net/if create [-async] [-vlanId <value>] -type {iscsi | replication} -port <value> -addr <value> [-netmask <value>] [-gateway <value>]
    Action qualifier
    Qualifier
    Description
    -async
    Run the creation operation in asynchronous mode.
    -type
    Specify the interface type. Value is one of the following:
    • iscsi—Interface for iSCSI storage.
    • replication—Interface for replication-related data or management traffic.
      The replication type is also used to create the mobility interface which is used during a file import session.
    -port
    Specify the ID of the SP port or link aggregation that will use the interface.
    For systems with two SPs, a file interface is created on a pair of symmetric Ethernet ports rather than on a single specified port. Its current port is defined by NAS server SP and may differ from the specified port. For example, if the user specifies port spa_eth2, but the NAS server is on SP B, the interface is created on port spb_eth2.
    -vlanId
    Specify the virtual LAN (VLAN) ID for the interface. The interface uses the ID to accept packets that have VLAN tags. The value range is 1–4095.
    If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details about VLANs.
    -addr
    Specify the IP address for the interface. The prefix length should be appended to the IPv6 address and, if omitted, will default to 64. For IPv4 addresses, the default length is 24. The IPv4 netmask may be specified in address attribute after slash.
    -netmask
    Specify the subnet mask for the interface.
    This qualifier is not required if the prefix length is specified in the -addr attribute.
    -gateway
    Specify the gateway for the interface.
    This qualifier configures the default gateway for the specified port’s SP.
    Example

    The following command creates a replication interface. The interface receives the ID IF_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/if create -type replication -port eth1_spb -addr 10.0.0.1 -netmask 255.255.255.0 -gateway 10.0.0.1
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = IF_1
    Operation completed successfully.
                        

    Create remote system configurations

    Configures a remote system configuration for the local system to access.

    For a source VNX system with two control stations, the home directory of a user with the Administrator role, which is used in configuring the import connection, must exist on the primary control station of the VNX. See VNX system with two Control Stations .
    Format
    /remote/sys create -addr <value> [-type VNX] -srcUsername <value> {-srcPassword <value> | -srcPasswordSecure} -dstUsername <value> {-dstPassword <value> | -dstPasswordSecure} [-connectionType {sync | async | both}]
    Action qualifiers
    Qualifier
    Description
    -addr
    Specify the network name or IP address of the remote system.
    -type
    Specify the remote system type. Valid values are:
    • VNX
    -srcUsername
    For systems that are the source in a replication, type the username that is used to access the system.
    -srcPassword
    For systems that are the source in a replication, type the user password that is used to access the system.
    -srcPasswordSecure
    Specify the password in secure mode. Once you run the command with this qualifier, you will be asked to type the password separately.
    -dstUsername
    For systems that are the destination in a replication session or VNX in an import session, specify the username that is used to access the system.
    -dstPassword
    For systems that are the destination in a replication session or VNX in an import session, specify the user password that is used to access the system.
    -dstPasswordSecure
    Specify the password in secure mode. Once you run the command with this qualifier, you will be asked to type the password separately.
    -connectionType
    Specify this qualifier to indicate the type of replication connection. Valid values are async, sync, or both.
    Example

    The following command creates a remote system configuration with these settings:

    • Network address is 10.64.75.10.
    • Includes access credentials for when the system is the source or destination.

    The configure remote system receives the ID RS_65536:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys create –addr 10.64.75.10 –type VNX -dstUsername admin1 -dstPassword Password789!
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = RS_65536
    Operation completed successfully.
                        

    View import sessions

    View details about existing import sessions for both file and block. You can filter on the session ID.

    Format
    /import/session [-id <value> | -active | -completed | -cancelled] [-type {block | nas}] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -active
    Show only active sessions (sessions that are not completed or cancelled).
    -completed
    Show only completed sessions.
    -cancelled
    Show only cancelled sessions.
    -type
    Specifies what type of sessions to show. Valid values are :
    • block
    • nas
    Example

    The following command displays all existing import sessions on the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session show -detail
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:    ID                                   = import_1
          Name                                 = import_sess_vdm1_BB0050562C7D2A_FCNCH0972C330D
          Session type                         = nas
          Health state                         = OK (5)
          Health details                       = "The component is 
    operating normally. No action is required."
          State                                = Initialized
          Progress                             = empty
          Source system                        = RS_65535
          Source resource                      = vdm1
          Target resource                      = nas_1
    
    
    2:    ID                                   = import_2
          Name                                 = VNX LUN Group 1 import
          Session type                         = block
          Health state                         = OK (5)
          Health details                       = "The component is  
    operating normally. No action is required."
          State                                = Initial copy
          Progress                             = 
          Source system                        = RS_65535
          Source resource                      = LUNGroup1
          Target resource                      = res_1
                        

    Create a NAS import session

    Create a NAS import session.

    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 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.
    If name is not specified, it will be generated in the pattern
    import_sess_<srcRes>_<srcSysSerialNumber>_<targetSysSerialNum ber>[_<index>]
    -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.
    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.
    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.
    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 need to exist. The create process only takes existing source file system IDs and skips non-existent 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 need to exist.
    -defaultProductionPort
    Specifies the target port where NAS server production interfaces will be created by default.
    -srcDhsmUsername
    Specifies the user name for authentication to DHSM service on the source Data Mover.
    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 user name 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.
    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:
    • directMatch - Import source unixDirectoryService to target without any change.
    • local - Use Local files (passwd, group, hosts, netgroup) for querying identity information for Unix.
    • nis - Use NIS for querying identity information for Unix.
    • ldap - Use LDAP for querying identity information for Unix.
    • localThinNis - Use Local files and then NIS for querying identity information for Unix.
    • localThinLdap - Use Local files and then LDAP for querying identity information for Unix.
    • none - Do not use any of Unix directory services.
    -srcLocalCifsAdminUsername
    (Optional) Specifies the user name 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.
    The user is prompted to input the password and the password confirmation.
    -srcFsImportedAsVMWareDatastore
    (Optional) Specifies what 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 need to exist. The create process only takes existing source file system IDs and skips non-existent 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 need to exist.
    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 need to exist. The create logic only takes existing source file system IDs and skips non-existent 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 need to 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 need to exist. The create logic only takes existing source file system IDs and skips non-existent 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 need to 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 allows the creation to proceed.
    Skipping the server parameters check could lead to disruptive cutover during import.
    Example

    The following command creates an import session with these settings:

    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.
    • Skip the server parameters check.
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! import/session/nas create -name MyName1 -srcSys RS_1 -srcRes src_vdm_to_migrate -targetResPool pool_1 -targetImportIf if_3 -productionIfPortPairs source_interface_1:spa_iom_0_eth1,source_interface_2:spa_iom_0_eth0 -fsPoolPairs 100~200:pool_2,255:pool_3 -defaultProductionPort spa_iom_0_eth0 -unixDirectoryService directMatch -srcFsImportedAsVMWareDatastore 13,20~25,30 -skipServerParamCheck
                          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:

    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.
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! / import/session/nas create -name MyName -srcSys RS_1 -srcRes src_vdm_to_migrate -targetResPool pool_1 -targetImportIf if_3 -productionIfPortPairs source_interface_1:spa_iom_0_eth1,source_interface_2:spa_iom_0_eth0 -fsPoolPairs 100~200:pool_2,255:pool_3 -defaultProductionPort spa_iom_0_eth0 -unixDirectoryService directMatch -srcFsImportedAsVMwareDatastore 13,20~25,30 -srcFsImportedAsThin 14,22,25~30 -srcFsImportedWithDataReductionEnabled 31,40~45 -skipServerParamCheck
                          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:

    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 user name 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.
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! import/session/nas create -name MyName1 -srcSys RS_1 -srcRes src_vdm_to_migrate -targetResPool pool_1 -targetImportIf if_3 -productionIfPortPairs source_interface_1:spa_iom_0_eth1,source_interface_2:spa_iom_0_eth0 -fsPoolPairs 100~200:pool_2,255:pool_3 -defaultProductionPort spa_iom_0_eth0 -srcFsImportedAsVMWareDatastore 13,20~25,30 -srcLocalCifsAdminUsername cifsadmin1 -srcLocalCifsAdminPasswd cifspassword1 -skipServerParamCheck
                          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.
                        

    View import sessions for file

    View details about import sessions for file. You can filter on the session ID.

    Format
    /import/session/nas [{-id <value> | -active | -completed | -cancelled}] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -active
    Show only active sessions (sessions that are not completed or cancelled).
    -completed
    Show only completed sessions.
    -cancelled
    Show only cancelled sessions.
    Example

    The following command displays file import sessions on the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/nas show -detail
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:    ID                                                               = import_1
          Protocol                                                         = NFS
          Name                                                             = import_sess_vdm1_BB0050562C7D2A_FCNCH0972C330D
          Health state                                                     = OK (5)
          Health details                                                   = "The component is operating normally. No action is required."
          State                                                            = Initialized
          Progress                                                         = 
          Source system                                                    = RS_1
          Source resource                                                  = vdm1
          Source import interface                                          = nas_migration_1
          Source file systems imported as VMware datastore                 = 13,20~25,30
          Source file systems imported with Data Reduction enabled         = 31,40~45
          Source file systems imported with advanced deduplication enabled = 31,40~45
          Target resource                                                  = 
          Target resource pool                                             = pool_1
          Target file system to pool mapping                               = 13~14:pool_1
          Target import interface                                          = if_3
          Target default production port                                   = spa_iom_0_eth0
          Target production interface to port mapping                      = filesim8129dm2:spa_iom_0_eth0
          Target production interface to vlan mapping                      = filesim8129dm2:1
          CIFS local administrator username                                = admin
          Source DHSM user                                                 = dhsm_admin
                        

    Change import session settings for file

    Change the settings for a NAS import session.

    Format
    /import/session/nas –id <value> set [-async] [-paused {yes | no}] -name <value>] [-targetResPool <value>] [-fsPoolPairs <value>] [-targetImportIf <value>] [-productionIfPortPairs <value>] [-productionIfVlanPairs <value>] [-srcLocalCifsAdminUsername <value> {-srcLocalCifsAdminPasswd <value> | srcLocalCifsAdminPasswdSecure}] [-srcFsImportedAsVMwareDatastore <value>] [-srcFsImportedWithDataReductionEnabled <value>] [-srcFsImportedWithAdvancedDedupEnabled <value>]}
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    Action qualifiers
    Qualifier
    Description
    -async
    Run action in asynchronous mode.
    -name
    Specifies the new name of the import session.
    -paused
    Specifies whether to pause the session. Valid values are:
    • yes
    • no
    no starts or resumes the import session.
    -targetResPool
    Specifies the new pool for the target resource. Applicable only when the session status is Initialized or the target NAS server provision fails.
    -fsPoolPairs
    Specifies the source file system IDs and target pool pairs. Applicable only when the session status is Initialized or the target file system provision fails.
    -targetImportIf
    Specifies the new target migration interface. Applicable only when the session status is Initialized or the target NAS server provision fails.
    -productionIfPortPairs
    Specifies the source VDM production interface and target port pairs. Applicable only when the session status is Initialized or the target production interface creation fails.
    -productionIfVlanPairs
    Specifies the source VDM production interface and the target VLAN pairs. Applicable only when the session status is Initialized or the target production interface creation fails.
    -srcLocalCifsAdminUsername
    Specifies the user name for authentication to the CIFS server on the source VDM.
    -srcLocalCifsAdminPasswd
    Specifies the password for authentication to the CIFS server on the source VDM.
    -srcLocalCifsAdminPasswdSecure
    Specifies the password in secure mode.
    The user is prompted to input the password and the password confirmation.
    -srcFsImportedAsVMWareDatastore
    Specifies what source file systems are imported as VMware datastore file systems. Only applies to file import when the session is initialized.
    If a VNX file system is specified by this option, it should not contain any tree quotas or user quotas.
    -srcFsImportedWithDataReductionEnabled
    Specifies which source file systems are imported with data reduction enabled. Only applies to file import when the session is initialized.
    -srcFsImportedWithAdvancedDedupEnabled
    Specifies which source file systems are imported with advanced deduplication enabled. Only applies to file import when the session is initialized.
    Example

    The following command changes the NAS import session settings:

    This command only makes changes to the import session configuration. To resume (start) the import session through the UEMCLI, you must run the /import/session/nas set command and specify no for the action qualifier -paused.
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/nas –id import_1 set -name newName -targetResPool pool_2 -targetImportIf if_3 -productionIfPortPairs source_interface_1:spa_iom_0_eth1,source_interface_2:spa_iom_0_eth0 -fsPoolPairs 100~200:pool_2,255:pool_3 -srcFsImportedAsVMWareDatastore 17~20 -srcFsImportedWithDataReductionEnabled 31,40~45
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        
    Start or resume an import session

    Once an import session is created and optionally modified, it remains in the initialized state until it is started (or resumed). The following command starts (or resumes) the example NAS import session:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/nas –id import_1 set -paused no
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        

    Cutover import session for file

    Cut over an existing NAS import session. Cutting over a session switches the active host IOs to the target side and initiates the incremental data synchronization from the source to the target.

    Format
    /import/session/nas -id <value> cutover [-async] [-netbiosName <value>] [-cifsServerName <value> -domainUsername <value> {-domainPasswd <value> | -domainPasswdSecure}]
    Object qualifier
    Qualifier
    Description
    -id
    Specifies the ID of the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the action in asynchronous mode.
    -netbiosName
    Specifies new NetBIOS name for source the CIFS server.
    -cifsServerName
    Specifies the new name for the source CIFS server after the cutover. SMB (CIFS) server name must be unique on the network.
    If not specified, the default name for renaming the source CIFS server is the original CIFS server name prefixed with an underscore (_).
    -domainUsername
    Specifies the domain administrator name. This name is required for renaming the source CIFS server and joining it to the Active Directory. (Used for AD-joined CIFS server migration only)
    -domainPasswd
    Specifies the domain user password.
    -domainPasswdSecure
    Specifies the password in secure mode.
    The user is prompted to input the password and the password confirmation.
    Example 1

    The following command cuts the NFS import session, import_1, over to the target system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/nas -id import_1 cutover
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        
    Example 2

    The following command cuts the SMB import session, import_1, over to the target system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/nas -id import_1 cutover -cifsServerName cifs1 -domainUsername user1 -domainPasswd password1
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        

    Commit import session for file

    Commit an existing NAS import session. Committing a session completes the import process.

    Format
    /import/session/nas -id <value> commit [-async]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the action in asynchronous mode.
    Example

    The following command commits the import session, import_1.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/nas -id import_1 commit
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        

    Cancel a NAS import session

    Cancel an existing NAS import session.

    Format
    /import/session/nas -id <value> cancel [-async] [-domainUsername <value> {-domainPasswd <value> | -domainPasswdSecure}] [-skipSourceRestore]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the action in asynchronous mode.
    -domainUsername
    Specifies the domain user with administrative rights to update the AD (not necessary for standalone CIFS server).
    -domainPasswd
    Specifies the domain user password (not necessary for standalone CIFS server).
    -domainPasswdSecure
    Specifies the password in secure mode (not necessary for standalone CIFS server).
    The user is prompted to input the password and the password confirmation.
    -skipSourceRestore
    Skip source VDM restore. When specified, the source VDM restore operations are skipped. Normally, the cancel action stops the import transport, deletes the corresponding destination resources, and restores the source VDM (turns up the source interfaces attached to the VDM if they are turned down during cutover and deletes internal export options created by the import for import transport).
    Example

    The following command cancels the NAS import session, import_1.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/nas -id import_1 cancel
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        

    Create a block import session

    Prerequisites

    Before creating a block import session, complete the following configuration tasks:

    • Create interfaces on both source and target for data transfer.
    • Create an import connection to a Unity-based target system.
    • Create a block import target (LUN or LUN Group) on the target system.
    Format
    /import/session/block create [-async] [-name <value>] [-throttle {yes | no}] -srcSys <value> -srcRes <value> -lunPoolPairs <value> [-cutoverThreshold <value>] [-hosts <value>] [-importAsVMwareDatastore {yes | no}]
    Action qualifiers
    Qualifier
    Description
    -async
    Run action in asynchronous mode.
    -name
    Specifies the name of the import session.
    If name is not specified, it will be generated in the pattern
    import_sess_<srcRes>_<srcSysSerialNumber>_<targetSysSerialNum ber>[_<index>]
    -throttle
    Specifies whether to throttle the import transfer. Throttle impacts the import speed and host latency for the related LUNs and file systems that are in use on the source and target storage systems. Valid values are:
    • yes
    • no
    Default is to throttle the import transfer, which means that it is throttled at less than the full speed.
    -srcSys
    Specifies the source system.
    -srcRes
    Specifies the source resource.
    -lunPoolPairs
    Specifies the LUN pool pairs. A comma separated list of mappings between the source LUN and the target storage configuration.
    Use the format srcLUN1:tgtPool1,…,…. Target LUNs will have the same properties as those of the source LUN, such as name, isThin, SP, and size.
    -cutoverThreshold
    The percentage threshold below which the import session becomes ready to be cutover.
    -hosts
    Specifies the hosts. A comma separated list of friendly IDs of hosts to give access to target elements.
    -importAsVMwareDatastore
    Specifies whether the source LUN is to be imported as a VMware datastore (VMFS). This option is only valid for a LUN session and is not valid for a CG session. Valid values are:
    • yes
    • no
    Example

    The following command creates an import session with these settings:

    • Import session name is lun_17_import.
    • Source storage system is RS_1.
    • Source storage resource is 17.
    • LUN pool pair is 17:pool_1.
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! import/session/block create -name lun_17_import -srcSys RS_65596 -srcRes 17 -lunPoolPairs 17:pool_1 -importAsVMwareDatastore yes
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = import_1
    Operation completed successfully.
                        

    View import sessions for block

    View details about import sessions for block. You can filter on the session ID.

    Format
    /import/session/block [{-id <value> | -active | -completed | -cancelled}] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -active
    Show only active sessions (sessions that are not completed or cancelled).
    -completed
    Show only completed sessions.
    -cancelled
    Show only cancelled sessions.
    Example

    The following command displays block import sessions on the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/block show -detail
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:    ID                                   = import_2
          Name                                 = VNX LUN Group 1 import
          Session type                         = block
          Health state                         = OK (5)
          Health details                       = "This import session 
    is operating normally. No action is required."
          State                                = Syncing
          Progress                             = 0%
          Source system                        = RS_65535
          Source resource                      = LUNGroup1
          Target resource                      = res_1
          Estimated remaining bytes            = 47185920 (45 M)   
          Percent remaining for import         = 6
          Cutover threshold percent            = 5
          Throttle                             = no
                        

    Change import session settings for block

    Change the settings for a block import session.

    Format
    /import/session/block –id <value> set [-async] [-name <value>] [-paused {yes | no} [-throttle {yes | no}] [-cutoverThreshold <value>]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    Action qualifiers
    Qualifier
    Description
    -async
    Run action in asynchronous mode.
    -name
    Specifies the new name of the import session.
    -throttle
    Specifies whether to throttle the import transfer. Throttle impacts the import speed and host latency for the related LUNs and file systems that are in use on the source and target storage systems. Valid values are:
    • yes
    • no
    Default is to throttle the import transfer, which means that it is throttled at less than the full speed.
    -paused
    Specifies whether to pause the import session. Valid values are:
    • yes
    • no
    no starts or resumes the import session.
    -cutoverThreshold
    Specifies the threshold percentage below which the import session is cutover-ready.
    Example

    The following command changes the block import session settings for name to newName, the commitThrottle level to 5, and to not apply the throttle:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/block –id import_1 set -name newName -throttle no -cutoverThreshold 5
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        

    Cut over import session for block

    Cut over and complete an existing block import session. Cutting over a block import session can be a long and disruptive process. To reduce the period of disruption, set the cutover threshold as small as possible. By decreasing the cutover threshold to a small value, a smaller number of changes will need to be transferred after the application is quiescent. The cutover threshold is a percentage of the LUN size and hence for larger LUNs it is recommended that the cutover threshold be set to a value smaller than the default value of 5 percent. Lastly, cut over an import session only when the session is in the Cutover Ready state. This action ensures that the cutover is performed when the least number of changes has to be transferred.

    After cutover completes successfully, host IOs are switched to the target side and the import process completes automatically.

    Format
    /import/session/block -id <value> cutover [-async]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the action in asynchronous mode.
    Example

    The following command cuts the import session, import_1, over to the target system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/block -id import_1 cutover
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        

    Cancel a block import session

    Cancel an existing block import session.

    Format
    /import/session/block -id <value> cancel [-async]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the action in asynchronous mode.
    Example

    The following command commits the block import session, import_1.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/block -id import_1 cancel
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                        

    View import session elements

    View details about import status for each element in the active import session, for example, each LUN in a consistency group (CG).

    Format
    /import/session/element -importId <value> show
    Object qualifier
    Qualifier
    Description
    -importId
    Type the ID of the import session.
    Example

    The following command displays import status for each element in the specified import session:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/element -importId import_2 show -detail
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:    Source system   = RS_1
          Source resource = lun1
          Target resource = sv_1
          Health state    = OK (5)
          Health details  = "The component is operating normally. No action is required."
          Stage           = Incremental Sync
          Iteration       = 4         
          Progress        = 10%
          Source system   = RS_1
          Source resource = lun4
          Target Resource = sv_2
          Health state    = OK (5)
          Health details  = "The component is operating normally. No action is required."
          Stage           = Incremental sync
          Iteration       = 4 
          Progress        = 0%