Dell EqualLogic PS6210XS EqualLogic Host Integration Tools for Microsoft Editi - Page 61

Tools and Utilities

The Host Integration Toolkit includes utilities that can be run by administrators.

NOTE:

If the Host Integration Kit is installed with the capability to import EqualLogic volumes to a PowerStore array,

see the Appendix

ImportKit-CLI for Windows

in the

Importing External Storage to PowerStore Guide

.

Topics:

•

EqlXcp Utility

•

EqlLog Utility

•

EqlRethin Utility

EqlXcp Utility

EqlXcp

is a command-line Windows utility that uses SAN Data Copy Offload, an API that accelerates file copy operations by using

SCSI

Extended Copy

commands. In a standard file copy operation, data is read from the source volume to the host computer, and then

written to the destination volume. With

SCSI Extended Copy

commands, the source volume can transmit the data directly to the

destination volume. The host computer is therefore eliminated from the I/O path, and network utilization is drastically reduced.

EqlXcp

cannot be used to copy files between volumes when one of the volumes is using an access group ACL and the other is not. For

EqlXcp

to work, ensure that either both volumes are using traditional ACLs or both volumes are using access group ACLs.

Windows Server 2012 or later has built-in support for offload data copy operations. Calling any of the standard file copy utilities or APIs on

Windows Server 2012 or later will result in an accelerated copy when possible. You do not need to use

EqlXcp

on Windows Server 2012

or later.

EqlXcp Utility Restrictions

If any of the following rules are not met, the

EqlXcp

utility will exit with an error message. No data will be lost.

•

To use this utility, you must have the SE_MANAGE_VOLUME_NAME privilege.

NOTE:

Administrators have this privilege by default.

•

You can only copy between volumes on a single group.

•

The source and destination volumes must reside on a PS Series group.

•

The group members must be running PS Series firmware version 7.1 or later.

•

You cannot use this utility on compressed or sparse files. (Sparse files are files that are thin-provisioned on the NTFS or ReFS file

systems.)

•

EqlXcp

is not supported on volumes that are cluster resources.

Run the EqlXcp Utility

The

EqlXcp

utility is located under the default installation folder, or the folder that you specified for HIT during installation. The default

folder is

C:\Program Files\EqualLogic\bin

.

NOTE:

You must be logged in to the host as an administrator to run this utility.

1.

From the

Start

menu, right-click

Command Prompt

and select

Run as administrator

.

2.

In the command window, you can change the directory to

C:\Program Files\EqualLogic\bin

.

3.

Entering

eqlxcp

alone displays the syntax for the utility. The utility supports multiple source files on the command line, and accepts

wildcards:

eqlxcp [-hocv] source-file [source-file-n] destination-file

Wildcards can be used to specify the source files. If multiple source files are specified, the destination must be an existing directory.

Options:

9

Tools and Utilities

61

Section	Page
Dell EqualLogic Host Integration Tools for Microsoft Edition Version 5.3 Installation and User's Guide	3
About This Guide	6
Revision History	6
Audience	6
Support Resources	6
Download the Installation Kit	6
Related Documentation	6
Dell Online Services	6
Contacting Dell	7
Introduction to Host Integration Tools	8
Host Integration Tools Components	8
SMP Support	9
SMP Configuration	9
SCVMM Support	9
Configure SCVMM	9
Supported SCVMM Operations	10
Supported Applications	10
Microsoft Exchange Server	10
Microsoft SQL Server	10
Microsoft Hyper-V	11
SharePoint	11
Installation	12
Obtain the Installation Kit	12
Download the Installation Kit	12
Administrative Installation Using Active Directory	12
Installation Considerations	13
Install Host Integration Tools for Microsoft	13
Update an Installation	14
Uninstall HIT or a Component	14
Install HIT/Microsoft on a Windows Server 2012 R2 Core Machine	14
Install HIT on a Windows Server 2012 R2 Core Cluster	15
About Remote Host Installations	15
Install HIT on Remote Hosts With the Add Hosts Wizard	15
Procedure for Installing HIT on Remote Hosts with the Add Hosts Wizard	16
Install HIT on Remote Hosts Using PowerShell Scripts	16
Syntax for PowerShell Remote Host Installation	17
Procedure for Installing HIT on Remote Hosts With PowerShell	18
Install HIT on a Failover Cluster	18
Specify the ASM/ME Backup Document Directory	19
Change the Login Account for ASM/ME Services (EQLReqService and EqlASMAgent)	19
Join a Computer into a Failover Cluster	19
About Silent Installations	19
Support for a Silent Installation	20
Syntax	20
Perform a Silent Installation	20
Perform a Silent Uninstallation	21
Create a Log File During Silent Mode	21
Using HIT With a SharePoint Farm	21
Specify Index File Locations When Installing SharePoint	21
Modify Index File Locations in an Existing SharePoint Farm	22
Change the Default Index File Location Using PowerShell cmdlets	23
Change Index File Locations Using Central Administration	23
Change Administration Component Index File Location	23
Change the SPSearch Index File Location	23
Best Practices for SharePoint	24
Remote Setup Wizard	25
PS Series Group Requirements for Using RSW	25
Windows System Requirements for Using RSW	25
Launch RSW on the Host	25
Launch RSW From ASM/ME	26
Initialize a PS Series Array Using RSW	26
Search for a PS Series Array Using RSW	26
Information Required for Initializing a PS Series Array	26
Initialize an Array and Create a PS Series Group	27
Initialize an Array and Add It to an Existing Group	28
Troubleshoot RSW	28
Remote Setup Command Line Utility	29
General Command Syntax for the RSWCLI	29
Getting Help on Commands	29
Using RSWCLI Commands	30
Discover a PS Series Array	30
Initialize a PS Series Array	30
List or Modify MPIO Settings	31
List Included and Excluded Subnets for MPIO	32
Include a Subnet or Adapter for Use by MPIO	33
Exclude a Subnet or Adapter From Use By MPIO	33
Using the Multipath I/O Component	35
Introduction to Multipath I/O DSM	35
Determining the Number of iSCSI Sessions for a Volume Slice	36
Prerequisites for Configuring Multipath I/O DSM	37
Requirements for Multipath I/O	37
Configure Multipath I/O Between a Computer and a Group	38
Log In to a Volume With Multipath I/O	38
Log Off a Volume With Multipath I/O on Variants of Windows Operating Systems	39
View MPIO Sessions	39
Set the MPIO Load-Balancing Policy	41
On Other Operating Systems	41
EqualLogic MPIO Configuration Tool	41
Use the VDS Provider	43
VDS Provider Requirements	43
VDS Provider Guidelines and Restrictions	43
Simple Target and LUN Naming	43
Import VSS Snapshots	44
Adjustments After Access Control Modifications	44
Create a Volume Using Storage Manager for SANs	44
Start Storage Manager for SANs	44
Use SCVMM With the Dell EqualLogic SMP	46
Install the Dell EqualLogic Storage Management Provider	46
Configure the Dell EqualLogic Storage Management Provider	46
Create a Classification for Dell EqualLogic Storage Resources	47
Import the SMP Through the SCVMM GUI	47
Configure PS Series Groups	49
Configure Group Access on Managed Hosts and Clusters	50
Configure Storage for VM Rapid Provisioning	51
Create a VM Template for the Library Share	52
Create a VM Template From a VHD	53
Migrate the Rapid-Provisioned VMs	55
Migrate Storage of a Deployed VM to Another Location	56
Troubleshoot SCVMM Issues	57
Supported SMP PowerShell Cmdlets	57
Use the HPC iSCSI Provider	59
About the HPC iSCSI Provider Installation	59
Configure the PS Series Array	59
HPC iSCSI Provider Settings	59
Tools and Utilities	61
EqlXcp Utility	61
EqlXcp Utility Restrictions	61
Run the EqlXcp Utility	61
EqlLog Utility	62
EqlLog Utility Overview	62
Run the EqlLog Utility	62
EqlLog Command Line Options	62
Trace Log Daemon	63
EqlRethin Utility	63
Run the EqlRethin Utility	63
Index	65
Special Characters	65
A	65
B	65
C	65
D	65
E	65
F	65
G	65
H	66
I	66
K	66
L	66
M	66
N	67
P	67
R	67
S	68
T	68
U	68
V	69
W	69

Dell EqualLogic PS6210XS EqualLogic Host Integration Tools for Microsoft Editi - Page 61

Tools and Utilities, EqlXcp Utility, EqlXcp Utility Restrictions, Run the EqlXcp Utility

Page 61 highlights