Search
  • Data Mobility

    PDF

    Data Mobility

    Manage VNX import sessions

    A VNX import (migration) session is used to import data from a VNX1 or VNX2 storage system (source) to a remote Unity storage system (target). Two types of VNX imports are available:

    • Virtual Data Mover (VDM) and its related file systems import
    • Block LUN or Consistency Group (CG) of LUNs import

    Each import session is identified by an ID. The Unisphere online help provides more details about storage import.

    NOTE:  At any given point in time, only one command is supported on an import session. Before running a new command, ensure that you wait for the existing action on the import session to complete.

    The following table lists the attributes for import sessions:

    Table 1. Import session attributes
    Attribute
    Description
    ID
    ID of the import session.
    Name
    Name of the import session.
    Session type
    Type of import session. Valid values are:
    • nas
    • block
    Health state
    Health state of the import session. Valid values are:
    • Unknown (0) — The remote system health cannot be determined.
    • OK (5) — Session is operating normally.
    • OK BUT (7) — Session is in one of the following states:
      • Session is initialized but paused.
      • Session is paused to migrate data in initial copy.
      • Session is paused to sync data in incremental copy.
    • Degraded/Warning (10) — The session failed for one of the following reasons:
      • Session failed to read some source files.
      • Session failed to copy file from source to destination.
    • Minor failure (15) — The session failed for one of the reasons listed in Reasons for import session Minor failures.
    • Non-recoverable failure (30) — An error has caused one or more of the following:
      • Session failed.
      • Session failed due to an unrecoverable failure in initial copy.
      • Session failed due to an unrecoverable failure in incremental copy.
    Health details
    Additional health information. See Appendix A, Reference, for details.
    State
    State of the import session. Valid values are:
    • Initialized
    • Initial copy
    • Ready to cutover
    • Paused
    • Cutting over
    • Incremental copy
    • Ready to commit
    • Committing
    • Completed
    • Cancelling
    • Cancelled
    • Pending
    • Syncing
    Progress
    Import session progress. Only supported for NAS import.
    Source system
    Remote system identifier for source system.
    Source resource
    Source resource identifier.
    Target resource
    Target resource identifier. Initialized status: empty. Other statuses: Target resource identifier.
    Table 2. Reasons for import session Minor failures
    Reasons
    Session failed to provision target resource.
    Session failed to migrate data in initial copy.
    Session failed and paused to migrate data in initial copy.
    Session failed to migrate data in initial copy due to connection failure.
    Session failed and paused to migrate data in initial copy due to connection failure.
    Session failed to migrate data in initial copy due to source IO failure.
    Session failed and paused to migrate data in initial copy due to source IO failure.
    Session failed to migrate data in initial copy due to target IO failure.
    Session failed and paused to migrate data in initial copy due to target IO failure.
    Session failed to sync data in incremental copy.
    Session failed and paused to sync data in incremental copy.
    Session failed to sync data in incremental copy due to connection failure.
    Session failed and paused to sync data in incremental copy due to connection failure.
    Session failed to sync data in incremental copy due to source IO failure.
    Session failed and paused to sync data in incremental copy due to source IO failure.
    Session failed to sync data in incremental copy due to target IO failure.
    Session failed and paused to sync data in incremental copy due to target IO failure.
    Session failed to commit.
    Session failed to cancel.
    Session syncing failed.
    Session syncing failed due to copy file from source to destination.
    Session failed to cutover.
    Session has configuration failure.
    Session failed due to data failure.
    Session failed due to connection failure.
    Session failed to start.

    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

    Manage VNX import sessions for block

    A block VNX import is the process in which block LUNs or LUN Groups are imported from a VNX1/VNX2 storage system (source) to a remote Unity storage system (target). Block VNX import makes use of the SANCopy feature which must be enabled and configured on the source system.

    Each block import session is identified by an ID. The Unisphere online help provides more details about import of block storage.

    NOTE:  At any given point in time, only one command is supported on a block import session. Before running a new command, ensure that you wait for the existing action on the block import session to complete.

    The following table lists the attributes related to block import sessions:

    Table 3. Block import session attributes
    Attribute
    Description
    ID
    ID of the block import session.
    Name
    Name of the block import session.
    Health state
    Health state of the block import session. Valid values are:
    • Unknown (0) — The remote system health cannot be determined.
    • OK (5) — Session is operating normally.
    • OK BUT (7) — Session is in one of the following states:
      • Session is initialized but paused.
      • Session is paused to migrate data in initial copy.
      • Session is paused to sync data in incremental copy.
    • Degraded/Warning (10) — The session failed for one of the following reasons:
      • Session failed to read some source files.
      • Session failed to copy file from source to destination.
    • Minor failure (15) — The session failed for one of the reasons listed in Reasons for import sessions Minor failures.
    • Non-recoverable error (30) — An error has caused one or more of the following:
      • Session failed.
      • Session failed due to an unrecoverable failure in initial copy.
      • Session failed due to an unrecoverable failure in incremental copy.
      NOTE:   If the migration session is in an error state, the session will not be recoverable. You will need to delete the session and create a new migration session.
    Health details
    Additional health information. See Appendix A, Reference, for details.
    State
    State of the block import session. Valid values are:
    • Pending
    • Syncing
    • Paused
    • Ready to cutover
    • Cancelling
    • Cancelled
    Progress
    Block import session progress.
    Source system
    Remote system identifier for source system.
    Source resource
    Source resource identifier.
    Target resource
    Target resource identifier.
    Estimated remaining bytes
    Specifies the current estimated remaining bytes to be transferred for the current import stage. Only supported for block import.
    Percent remaining for import
    Specifies the percentage of remaining bytes to be imported against the total size of the import resource.
    Cutover threshold percentage
    When Percent remaining for import is below this threshold, the state of the import session changes to Ready to cutover.
    Throttle
    Specifies whether to throttle the import transfer. When throttle is applied, the import session data transfer rate will be throttled back to minimize impact on host I/O operations. When throttle is off, the import session functions at full speed which could impact host I/O latencies. Valid values are:
    • yes
    • no

    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.
    NOTE:   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
    NOTE:  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.
    NOTE:  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.

    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
    NOTE:  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
    NOTE:   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 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

    Manage VNX import sessions for file

    A Virtual Data Mover (VDM) file import is the process in which a VDM on a VNX1 or VNX2 storage system (source) is imported to a remote Unity storage system (target). The file systems (common log or split log) associated with the VDM are imported to ufs64 file systems on the target storage system.

    Each file import session is identified by an ID. The Unisphere online help provides more details about import of VDM file storage.

    NOTE:  At any given point in time, only one command is supported on a file import session. Before running a new command, ensure that you wait for the existing action on the file import session to complete.

    The following table lists the attributes for file import sessions:

    Table 4. File import session attributes
    Attribute
    Description
    ID
    ID of the file import session.
    Name
    Name of the file import session.
    Health state
    Health state of the import session. Valid values are:
    • Unknown (0)—The remote system health cannot be determined.
    • OK (5)—Session is operating normally.
    • OK BUT (7)—Session is in one of the following states:
      • Session is initialized but paused.
      • Session is paused to migrate data in initial copy.
      • Session is paused to sync data in incremental copy.
    • Degraded/Warning (10)—The session failed for one of the following reasons:
      • Session failed to read some source files.
      • Session failed to copy file from source to destination.
    • Minor failure (15)—The session failed for one of the reasons listed in Table 2.
    • Non-recoverable error (30)—An error has caused one or more of the following:
      • Session failed.
      • Session failed due to an unrecoverable failure in initial copy.
      • Session failed due to an unrecoverable failure in incremental copy.
      NOTE:   If the migration session is in an error state, the session will not be recoverable. You will need to delete the session and create a new migration session.
    Health details
    Additional health information. See Appendix A, Reference, for details.
    State
    State of the NAS server import session. Valid values are:
    • Initialized
    • Initial Copy
    • Ready to Cutover
    • Cutting Over
    • Incremental Copy
    • Ready to commit
    • Commiting
    • Completed
    • Cancelling
    • Cancelled
    Progress
    Import session progress.
    Source system
    Remote system identifier for source system.
    Source resource
    Source resource identifier.
    Source import interface
    Source import interface identifier for data transfer.
    Source file systems imported as VMWare datastore
    Source file systems that are imported as VMWare datastore. The value is a list of source file system IDs, in the format of a range (for continuous file system IDs) or a comma separated value (for file systems that are scattered) of source file system IDs. For example, 13,20~25,30.
    Source file systems imported with Data Reduction enabled
    Source file systems that are imported with data reduction enabled. The value is a list of source file system IDs, in the format of a range (for continuous file system IDs) or a comma separated value (for file systems that are scattered) of source file system IDs. For example, 13,20~25,30.
    Source file systems imported with advanced deduplication enabled
    Source file systems that are imported with advanced deduplication enabled.
    Target resource
    Target resource identifier.
    Target resource pool
    Target resource containing pool identifier.
    Target file system to pool mapping
    Target resources are only provisioned after you start the import session (by resuming it). Before the target file systems are provisioned (that is, after creation but before being started), the mapping is from a range (for continuous file system IDs) or a comma separated value (for file system IDs that scatter) of source file system IDs to a target pool. For example, 24~26:pool_1; 28,33~36,40:pool_2;50,55:pool_3;78:pool_4. After all the target file systems are provisioned (that is, after the session started), the mapping is from a range (for continuous file system IDs) or a comma separated value (for file system IDs that are scattered) of target file system IDs to a target pool. For example, res_1~res_3:pool_1; res_4~res_9: pool_2;res_10~res_11:pool_3;res_12:pool_4.
    Target import interface
    Target import interface identifier for data transfer.
    Target default production port
    Target production port identifier. The default port on which production interfaces are created.
    Target production interface to port mapping
    Target resources are only provisioned after you start the import session (by resuming it). Before the target production interfaces are provisioned, the mapping is from a list of source production interfaces to a target port. For example, if_6,if_7: spa_iom_0_eth0; if_9:spa_iom_0_eth1. After the target production interfaces are provisioned, the mapping is from a list of target production interfaces to a target port. For example, if_4,if_5:spa_iom_0_eth0; if_7:port spa_iom_0_eth1.
    Target production interface to VLAN mapping
    Target resources are only provisioned after you start the import session (by resuming it). Before the target production interfaces are provisioned, the mapping is from a list of source production interfaces to a target VLAN. For example, if_6: 6; if_9:9. After the target production interfaces are provisioned, the mapping is from a list of target production interfaces to a target VLAN. For example, if_4:4; if_7:7.
    CIFS domain username
    User name for authentication to Windows domain.
    CIFS domain password
    Password for authentication to Windows domain.
    CIFS local administrator username
    User name for authentication to SMB server on the source VDM (before the import session is started). This user account is imported to the destination NAS server.
    CIFS local administrator password
    Password for authentication to SMB server on the source VDM (before the import session is started). This user account is imported to the destination NAS server.

    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 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 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.
    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 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.
    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 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.
    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:
    • 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.
    NOTE:  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.
    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 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.
    NOTICE:  Skipping the server parameters check could lead to disruptive cutover during import.
    Example

    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.
    • 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:

    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.
    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:

    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 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.

    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
    NOTE:   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.
    NOTE:  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.
    NOTE:  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:

    NOTE:  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.
    NOTE:  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.
    NOTE:   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).
    NOTE:  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.

    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

    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).

    The following table lists the attributes for import session elements:

    Table 5. Import session elements attributes
    Attribute
    Description
    Source system
    Identifies the source system.
    Source resource
    Identifies the source resource.
    Target resource
    Identifies the target resource.
    Health state
    Health state of the import element.
    Health details
    Additional health information.
    Stage
    Import data transfer stage. Valid values are:
    • Initial sync
    • Incremental sync
    • Final sync
    Iteration
    Iteration number in this stage of the import data transfer. This property only applies to the incremental copy stage for LUN import.
    Progress
    Import progress of current sync iteration.
    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%

    Manage generic block resource import sessions

    This command imports generic block resources (such as LUNS, volumes, or virtual disks) from a third-party block storage system which provides a Fibre Channel (FC) or iSCSI interface to its block devices (LUNs). It uses the SAN Copy Pull feature running on the local storage system.

    If the iSCSI protocol is used, iSCSI connections and connection paths must have been created and configured before you can manage generic import sessions. Refer to the "Manage iSCSI connections" and "Manage iSCSI connection paths" sections in this chapter for more information about configuring iSCSI connections and connection paths.

    The following table lists the attributes for import sessions:

    Table 6. Import session attributes
    Attribute
    Description
    ID
    ID of the import session.
    Name
    Name of the import session.
    Description
    Description of the import session.
    Health state
    Health state of the import session. Valid values are:
    • Unknown (0) — The remote system health cannot be determined.
    • OK (5) — Session is in one of the following states:
      • Session is operating normally.
      • Session is completed.
      • Session is cancelled.
    • OK_BUT (7) — Session is in one of the following states:
      • Session was recovered on SP reboot.
      • Session is queued.
      • Session is paused.
    • Degraded/Warning (10) — Session is in one of the following states:
      • Auto-recovery is in progress.
      • Recovery on SP reboot.
      • Waiting on LUN trespass.
    • Minor failure (15) — The session failed either because an SP is down or the session was aborted.
    • Major failure — The session failed for one of the following reasons:
      • A bad block was encountered on the source block resource.
      • A restart on auto recovery failed.
      • The session was halted on an SP reboot.
      • The destination LUN and the import session are on different SPs.
      • The destination LUN has been trespassed.
    • Critical failure — The session failed for one of the following reasons:
      • Either the source block resource or destination LUN was not found.
      • Either the source block resource or destination LUN is inaccessible.
      • The source block resource has an invalid connection type.
      • The source block resource failed.
      • The destination LUN is inconsistent.
    • Non-recoverable failure (30) — A non-recoverable error caused the session to fail.
    Health details
    Additional health information. See Appendix A, Reference, for details.
    State
    State of the import session. Valid values are:
    • Initialized
    • Pending
    • Running
    • Paused
    • Failed
    • Completed
    • Cancelled
    SP owner
    Default destination LUN SP owner. Valid values are:
    • SPA
    • SPB
    Source system name
    Remote system name provided by the user when the session was created.
    Source LUN WWN
    Source block resource World Wide Name (WWN). The WWN can be passed with the following four prefixes:
    • wwn.
    • nna.
    • wwn-0x.
    • 0x.

    It is possible to pass the WWN without any prefixes. For example, the following notations of WWN can be used:

    • 50060485c5edaa5d—16 hexadecimal chars
    • 50:06:04:85:c5:ed:aa:5d—Bytes separated by colons
    • 50:6:4:85:c5:ed:aa:5d—Leading nibble of the byte dropped if the nibble is zero
    • 50-06-04-85-c5-ed-aa-5d—Bytes separated by dashes
    NOTE:  If the system rejects the WWN as non-recognizable, you can convert the WWN manually to the Dell EMC Unity system form, such as 60:00:01:6F..
    Target resource
    CLI ID of the destination storage resource.
    Target resource name
    Name of the destination storage resource.
    Target resource type
    Type of the destination resource. Valid values are:
    • LUN
    • VMware VMFS
    Size of source
    Size of data to transfer from the source block resource to the destination LUN.
    Size copied
    Total bytes transferred from the source block resource to the destination LUN.
    Size remaining
    Current remaining size in bytes to be transferred from the source block resource to the destination LUN.
    Percent completed
    Percentage of bytes transferred from the source block resource to the destination LUN.
    Start time
    Start time of the copying process.
    Estimated time to complete
    Current estimated time to complete the copying of the source block resource to the destination LUN.
    Throttle
    Reduces CPU load and I/O latency on the destination system. The lower the throttle value, the less impact on the host latency and the longer the import will take. Valid values are:
    • Low
    • Medium
    • High (default)

    Create a generic import session

    Create an import session for third-party systems.

    Format
    /import/session/generic create [-name <value>] [-descr <value>] [-srcSystemName <value>] -srcLUNWWN <value> {-targetRes <value> | -targetResName <value>} [-throttle {Low | Medium | High}] [-async]
    Action qualifiers
    Qualifier
    Description
    -name
    Identifies the import session by unique name. If this name is not specified, it will be generated, using the pattern: <target LUN CLI ID>-<target LUN name>-<timestamp>. For example, the name might be generated as sv_1-LUN01-20180601T160654.
    -descr
    Specifies the import session description.
    -srcSystemName
    Remote third-party system name. If this name is not specified, the option is left empty and the session cannot be tracked by the remote system name.
    -srcLUNWWN
    Specifies the WWN of the source LUN. The WWN can be passed with the following four prefixes:
    • wwn.
    • nna.
    • wwn-0x.
    • 0x.

    It is possible to pass the WWN without any prefixes. For example, the following notations of WWN can be used:

    • 50060485c5edaa5d—16 hexadecimal chars
    • 50:06:04:85:c5:ed:aa:5d—Bytes separated by colons
    • 50:6:4:85:c5:ed:aa:5d—Leading nibble of the byte dropped if the nibble is zero
    • 50-06-04-85-c5-ed-aa-5d—Bytes separated by dashes
    NOTE:  If the system rejects the WWN as non-recognizable, you can convert the WWN manually to the Dell EMC Unity system form, such as 60:00:01:6F..
    -targetRes
    CLI ID of the destination storage resource.
    -targetResName
    Name of the destination storage resource.
    -throttle
    Specifies the import session throttle value. Valid values are:
    • Low
    • Medium
    • High (default)
    NOTE:  You can change the Throttle setting when a session is running or paused. Only the /import/session/generic show -detail CLI command output will reflect this change when the session is running. However, after the session is completed, that command's output reflects the Throttle value that was set when the session was created, and not the changed value.
    -async
    Run the operation in asynchronous mode.
    Example

    The following command creates an import session.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic create –name lun_17_import -srcSystemName MyOldGranSystem -srcLUNWWN 06:00:00:00:05:00:00:00:01:00:00:00:00:00:00:03 -targetRes sv_1 –throttle High 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = glimp_1
Operation completed successfully.

    View generic import session settings

    View details about existing import sessions for third-party systems.

    Format
    /import/session/generic [{-id <value> | -name <value> | -srcSystemName <value> | -active | -running | -paused | -failed | -pending | -completed | -cancelled}] show
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -name
    Type the unique name for the import session.
    -srcSystemName
    Third-party system name provided by the user at import session creation.
    -active
    Show only active sessions (all sessions that are running, paused, failed, or pending).
    -running
    Show only running sessions.
    -paused
    Show only paused sessions.
    -failed
    Show only failed sessions.
    -pending
    Show only pending sessions.
    -completed
    Show only completed sessions.
    -cancelled
    Show only cancelled sessions.
    Example

    The following command displays all import sessions on the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic show -detail 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                          = gen_import_1
      Name                        = Session_for1527875375
      Description                 =
      Health state                = OK (5)
      Health details              = "The generic LUN import session is running normally."
      State                       = Running
      SP owner                    = SPB
      Trespassed                  = no
      Source system name          =
      Source LUN WWN              = 60:06:01:60:0B:10:3D:00:80:84:11:5B:3A:20:8E:6A
      Target resource             = sv_23
      Target resource name        = destLun_Compression_Disabled_TLU_1_Standalone
      Target resource type        = LUN
      Size of source              = 21474836480 (20.0G)
      Size copied                 = 408944640 (390.0M)
      Size remaining              = 21065891840 (19.6G)
      Percent completed           = 1%
      Start time                  = 2018-06-01 17:50:03
      Estimated time to complete  = 2018-06-02 01:32:58
      Throttle                    = Low

2:    ID                          = gen_import_2
      Name                        = Session_for1527875405
      Description                 =
      Health state                = OK (5)
      Health details              = "The generic LUN import session is running normally."
      State                       = Running
      SP owner                    = SPA
      Trespassed                  = no
      Source system name          =
      Source LUN WWN              = 60:06:01:60:0B:10:3D:00:8A:84:11:5B:55:AD:35:5D
      Target resource             = sv_24
      Target resource name        = destLun_DLU_1_Ds
      Target resource type        = VMware VMFS
      Size of source              = 21474836480 (20.0G)
      Size copied                 = 81264640 (77.5M)
      Size remaining              = 21393571840 (19.9G)
      Percent completed           = 0%
      Start time                  = 2018-06-01 17:50:39
      Estimated time to complete  = 2018-06-01 19:14:35
      Throttle                    = Low

    Change generic import session settings

    Changes the existing import sessions settings for third-party systems.

    Format
    /import/session/generic {-id <value> | -name <value>} set [-newName <value>] [-descr <value>] [-srcSystemName <value>] [–throttle <value>] [-async]
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -name
    Type the unique name for the import session.
    Action qualifiers
    Qualifier
    Description
    -newName
    Specifies the new name of the import session.
    -descr
    Specifies the import session description.
    -srcSystemName
    Remote third-party system name. If this name is not specified, the option is left empty and the session cannot be tracked by the remote system name.
    -throttle
    Specifies the import session throttle value. Valid values are:
    • Low
    • Medium
    • High
    NOTE:  You can change the Throttle setting when a session is running or paused. Only the /import/session/generic show -detail CLI command output will reflect this change when the session is running. However, after the session is completed, that command's output reflects the Throttle value that was set when the session was created, and not the changed value.
    -async
    Run the operation in asynchronous mode.
    Example

    The following command changes the import session settings for name to newName:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic –id gen_import_1 set –name newName 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

    Pause a generic import session

    Pauses a running third-party system import session.

    Format
    /import/session/generic {–id <value> | -name <value>} pause [-async]
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -name
    Type the unique name for the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    Example

    The following command pauses the "gen_import_1" import session:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic –id gen_import_1 pause 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

    Resume a generic import session

    Resumes running a third-party system import session.

    Format
    /import/session/generic {–id <value> | -name <value>} resume [-async]
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -name
    Type the unique name for the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    Example

    The following command resumes the "gen_import_1" import session:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic –id gen_import_1 resume 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

    Cancel a generic import session

    Cancels an existing active or failed third-party system import session.

    NOTE:  Once an import session has been cancelled, it cannot be restarted.
    Format
    /import/session/generic {–id <value> | -name <value>} cancel [-async]
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -name
    Type the unique name for the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    Example

    The following command cancels the "gen_import_1" import session:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic –id gen_import_1 cancel 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

    Restart a generic import session

    Restarts a failed third-party system import session, once the cause of the failure has been fixed. The session restarts and copies data from the last block address saved in a checkpoint. However, if the Throttle value was changed while the session was running, the Throttle value that was set when the initial session was created is used, and not the changed value.

    Format
    /import/session/generic {–id <value> | -name <value>} restart [-async]
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -name
    Type the unique name for the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    Example

    The following command restarts the "gen_import_1" import session:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic –id gen_import_1 restart 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

    Delete a generic import session

    Deletes a specified cancelled or completed third-party system import session. The delete operation erases all historical data for the specified import session.

    Format
    /import/session/generic {–id <value> | -name <value>} delete [-async]
    Object qualifiers
    Qualifier
    Description
    -id
    Type the ID of the import session.
    -name
    Type the unique name for the import session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    Example

    The following command deletes the "gen_import_1" import session:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic –id gen_import_1 delete 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

    Manage LUN Move sessions

    Use the LUN Move feature when you need to move existing LUNs in the system, such as between pools for load balancing, to take advantage of newly purchased spindles, or to enable data reduction (for either newly-written data or both newly-written data and existing data) on a thin LUN in an All Flash pool. Note that if you choose to apply data reduction to existing data, the LUN data is moved within the same pool.

    If you move a LUN that:

    • Has not had data reduction applied, it is moved as uncompressed.
    • Has had data reduction applied, and it is being moved to an All Flash pool, it is moved as compressed. If you are not moving it to an All Flash pool, it is moved as uncompressed.
    • Not thin, it is moved as not thin.
    • Thin, it is moved as thin.

    The following table lists the attributes for moving LUNs:

    Table 7. LUN move attributes
    Attribute
    Description
    ID
    ID of the move session.
    Source resource
    Storage resource for the source.
    Source member LUN
    Source member LUN, if the storage resource is a LUN group.
    Destination pool
    Pool for the destination.
    State
    Current state that represents the lifecycle of a move session. Value is one of the following:
    • Initializing—Move session is in the process of initializing.
    • Queued—Move session is queued to run. The system begins the data transfer when sufficient resources are available.
    • Running—Indicates that the move session is transferring data.
    • Failed—Move session has failed. Consult the move session's health for more details.
    • Cancelling—Indicates that the move session is in the process of being cancelled.
    • Cancelled—Indicates that the move session has been cancelled.
    • Completed—Data transfer for the move session has completed.
    Progress
    Progress of the move session expressed as a percentage.
    Health state
    Health state of the move session. Value is one of the following:
    • Unknown—The move session health cannot be determined.
    • OK—The move session is operating normally.
    • Major failure—One of the following:
      • The pool went offline and the move cannot continue. Please remove the move session, address the issue, and recreate the move session.
      • The pool exhausted the space available and the move cannot continue. Please remove the move session, address the issue, and recreate the move session.
      • The move session encountered an internal error. Please contact your service provider.
    Health details
    Additional health information. See Appendix A, Reference, for health information details.
    Priority
    Priority for the move session. Value is one of the following:
    • Idle—No copy I/O generated. The move session continues to mirror host I/O.
    • Low—Designated for move sessions that have the least priority over other move sessions.
    • Below normal—Designated for move sessions that are slightly less critical than the average or normal move session.
    • Normal—Designated for move sessions that are appropriate for most use cases. This is the default value.
    • Above normal—Designated for move sessions that are slightly more critical than the average or normal move session.
    • High—Designated for move sessions that take the highest priority over other move sessions.
    Average transfer rate
    Average transfer rate of the move session in MB/sec.
    Current transfer rate
    Current transfer rate of the move session in MB/sec.
    Estimated time left
    Estimated time remaining in seconds based on the current transfer rate.

    Create a LUN move session

    Format
    /move/session create -srcRes <value> [-srcMemberLun <value>] -targetPool <value> [-priority {idle | low | below | normal | above | high} ] [-thin {yes | no}] [-dataReductionEnabled {yes [-advancedDedupEnabled {yes | no}] | no}] [-async]
    Action qualifiers
    Qualifier
    Description
    -srcRes
    LUN identifier for a standalone source LUN, or a Consistency Group identifier if moving a LUN that is a member of the Consistency Group.
    -srcMemberLun
    Source LUN identifier if the LUN is a member of a Consistency Group.
    –targetPool
    Identifier of the destination storage pool where the moved resources will be created.
    -priority
    Priority of the move session. Valid values are:
    • idle—Designated for move sessions that continue to mirror the host I/O.
    • low—Designated for move sessions that have the least priority over other move sessions.
    • below—Designated for move sessions that are slightly less critical than the average or normal move session.
    • normal (default)—Designated for move sessions that are appropriate for most use cases.
    • above—Designated for move sessions that are slightly more critical than the average or normal move session.
    • high—Designated for move sessions that take the highest priority over other move sessions.
    –thin
    Indicates whether to create a thin destination. Valid values are:
    • yes (default)
    • no
    -dataReductionEnabled
    Indicates whether to create a destination that will have data reduction applied to it. Valid values are:
    • yes
    • no (default)
    -advancedDedupEnabled
    Indicates whether to create a destination that will have advanced deduplication applied to it. This option only applies when data reduction is enabled. Valid values are:
    • yes
    • no (default)
    -async
    Run the operation in asynchronous mode.
    Example 1

    The following command creates a move session.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move/session create -srcRes sv_1 –targetPool pool_1 -priority above –thin yes -dataReductionEnabled no 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = move_1
Operation completed successfully.
    Example 2

    The following command creates a move session, including the source member LUN ID.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move/session create -srcRes res_1 -sourceMemberLun sv_2 -targetPool pool_2 -priority above -thin yes -dataReductionEnabled yes -advancedDedupEnabled yes 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = move_2
Operation completed successfully.

    View a LUN move session

    Format
    /move/session [-id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the move session.
    Example

    The following command displays details for a LUN move session.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move/session show -detail 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                    = movesession_1
      Source resource       = sv_1
      Source member LUN     = 
      Destination pool      = pool_1
      State                 = Initializing
      Progress              = 0%
      Health state          = OK
      Health details        = "The component is operating normally. No action is required."
      Priority              = Normal
      Average transfer rate = 0 MB/s
      Current transfer rate = 0 MB/s
      Estimated time left   = N/A

2:    ID                    = movesession_2
      Source resource       = res_1
      Source member LUN     = lun_2    
      Destination pool      = pool_2
      State                 = Running
      Progress              = 17%
      Health state          = OK
      Health details        = "The component is operating normally. No action is required."
      Priority              = Above Normal
      Average transfer rete = 147 MB/s
      Current transfer rate = 232 MB/s
      Estimated time left   = 7m

    Change LUN move session settings

    Format
    /move/session -id <value> set [-priority {idle | low | below | normal | above | high}] [-async]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the move session.
    Action qualifiers
    Qualifier
    Description
    -priority
    Specify the priority of the move session. Valid values are:
    • idle—Designated for move sessions that continue to mirror the host I/O.
    • low—Designated for move sessions that have the least priority over other move sessions.
    • below—Designated for move sessions that are slightly less critical than the average or normal move session.
    • normal (default)—Designated for move sessions that are appropriate for most use cases.
    • above—Designated for move sessions that are slightly more critical than the average or normal move session.
    • high—Designated for move sessions that take the highest priority over other move sessions.
    -async
    Run the operation in asynchronous mode.
    Example

    The following command modifies the settings of a move session.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move/session –id MoveSession_1 set -priority below 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = MoveSession_1
Operation completed successfully.

    Delete a LUN move session

    Deletes a LUN move session that was completed, cancelled, or failed. You cannot delete a move session that is in progress.

    Format
    /move/session -id <value> delete [-async]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the move session.
    Action qualifier
    Qualifier
    Description
    -async
    Run the operation in asynchronous mode.
    Example

    The following command deletes a move session.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move/session –id movesession_1 delete 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully

    Cancel a LUN move session

    Cancels a LUN move session that is in progress.

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

    The following command cancels a move session.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move/session –id movesession_1 cancel 
                              Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.