Sunday, May 12, 2013

File-Based Migration using EMCopy

1. EMCopy is windows based tool which can be used for migrating the shares from windows file server to celerra CIFS server
2. It lets you copy a file or directory (and included subdirectories) from and to an NTFS partition, keeping security the same on the copy as on the original.
3. EMCOPY allows you to back up the file and directory security—ACLs, owner information, and audit information—from a source directory to a destination directory without copying the file data.

Download EMCopy.exe:
1. You need to contact your SAM or TC to have a copy of the emcopy.exe
2. I have a copy that I use --> send a email to

1. Download to any location on your local computer, in this example I did it to "C:\emcopy"
2. Open command prompt, change to the directory

cd /d C:\emcopy

3. Run the command to see available options

C:\emcopy> emcopy.exe

1. The migration User account should have Domain Admin membership and must be logged onto the system that is conducting the actual migration of data and attributes.
2. Make sure there are no unresolvable SID's on the source
3. Proper Group Membership and User Rights for the Windows account used for the migration.

Example: 1
Copy one directory with all its contents and its owner to a different directory on a Data Mover.

C:\emcopy>emcopy.exe c:\source\ h:\destination /o /s

Note: By default, the DACLs are copied when the /NOSEC option is not set. The owner attribute of the directories and files is also duplicated.

Example: 2
Copy source directory to destination directory including the local groups security entries, use this command syntax:

C:\emcopy>emcopy.exe c:\source\ h:\destination /o /s /lg

Note: You must use LGDUP before using EMCOPY with the /lg option.

Example: 3
C:\emcopy>emcopy.exe \\source\share\directory \\destination\share /o /s /c /r:3 /w:5 /log:"c:\log file.txt"

Note: 1. The "/o" option enables the copy of a file's owner. Without this option, the account used for the copy will be the owner of the copied files and directories.

2. The "/s" option enables the copy of the subdirectories.

3. The "/c" switch allows the process to continue after the retries.

4. The "/r:n" option specifies the maximum number of retries. By default it is set up
to 100.

5. The "/w:n" option specifies the time in seconds to wait between two retries.
By default it is set up to 30 seconds.

6. The "/log:filename" option allows to redirect the console messages to a new file.

Note: You can use /purge option as it enables the deletion of the files and directories fromt he destination tree which do not exist in the source one.

Post-Migration Activities:
1. Analyse the emcopy log files that have been generated and run ‘Beyond Compare’ on source server to compare the directories copied

Download Beyond Compare link:

2. Right- click > Properties on the source and destination folders to check that windows can see the same amount of files and folders.

3. Check NTFS permissions at each share have been brought across by EMCopy

Useful EMC Primus:
1. emc245596 - "EMCOPY 4.0x shows multiple errors like 'Trying to DELETE due to copy ABORT' and 'DELETED due to copy ABORT'"
2. emc288299 - "EMCOPY 4.xx shows error "DELETION FAILED""
3. emc224742 - "Warning EMCOPY and /z /d and /de command line switches"
4. emc135845 - "EMCopy data migration replaces UNIX primary group permission with default Windows Domain Users group when the /o switch is used in the EMCopy command."
5. emc195882 - "Failure using EMCopy 3.01: 'Error (1203): No network provider accepted the given network path.'"
6. emc46968 - "EMCopy utility fails with error 'Security Descriptor Error: Unable to set SD' while migrating data from source to target server."
7. emc254769 - "'Unable to set access time to' when copying files with EMCOPY"
8. emc70946 - "Emcopy fails to work as designed when using /purge command."
9. emc121242 -"EMCOPY fails to copy all files to destination when there is a mixture of long filenames and short filenames"
10. emc64705 - "Celerra Best Practices recommends using EMCopy to backup the customer ACLs."
Post a Comment
Read more: