How to Translate EMCopy error codes

Before running emcopy to migrate data in production environment, it is always recommended to execute multiple test runs to solve all authentication and permissions errors.

There are two ways to check for EMCopy error codes:

  1. Using Windows MSDN link below that will reference how to read those errors:

Examples:

ERROR_SHARING_VIOLATION
32 (0x20)          The process cannot access the file because it is being used by another process.

ERROR_ACCESS_DENIED
5 (0x5)          Access is denied.

ERROR_FILE_NOT_FOUND
2 (0x2)          The system cannot find the file specified.

ERROR_NETNAME_DELETED
64 (0x40)          The specified network name is no longer available.

 

  1. Using net helpmsg from the windows command line:

Examples:

net helpmsg 32
The process cannot access the file because it is being used by another process

net helpmsg 5
Access is denied

net helpmsg 2
The system cannot find the file specified

net helpmsg 64
The specified network name is no longer available

Example EMCopy with errors:

EMCOPY64 4.17 – File migration tool

EMC Migration Tools
Copyright  (C)1999-2014, All Rights Reserved, by EMC Corporation, Hopkinton MA.

System information
==================
Client OS   : Microsoft Windows Seven Enterprise Edition, AMD 64-bit Service Pack 1 (build 7601)
Server SRC   : TestServer-001   6.1
Server DEST   : Isilon-001 6.1 Isilon Server

Command information
===================
Date   : 10/12/2015 13:51:58
Source path   : D:\TestDirectory\
Desti. path   : \\Isilon-001\SMB\TestDirectory\
Files and Dirs filter(s)  : *
Directory options   : /s /purge /stream /sdd
List/Modify/Create options : /de
Security options: : /secforce /o
Thread count : 16
Retry options : /r:1 /w:1 /c
Log file : /log:c:\emc\testemcopy.log

Processing the copy from D:\TestDirectory\ to \\Isilon-001\SMB\TestDirectory\ …

TH001 : 11:34:36 : ERROR (32) : D:\TestDirectory\Dir1\FileValidation.xlsx -> Unable to open, Retrying in 1 seconds…
TH002 : 11:41:36 : ERROR (5) : D:\TestDirectory\Dir1\FileValidation2.xlsx -> SD not set, Failed after 1 retries….
TH003 : 11:53:40 : ERROR (64) : D:\TestDirectory\Dir2\FileValidation1.xlsx -> Unable to get content, Failed after 1 retries….

Copy engine Statistics
======================
File(s) copied                            : 54260
File(s) recovered                         : 0
Directory(ies) created                    : 547
Copy of File(s) failed                    : 3 !
Number of Deleted file(s)                 : 10
Amount of copied byte(s)                  : 13 GB (14 261 939 213 Byte(s))
Estimated copy bitrate                    : 204456.109 KB/s
Global copy duration                      : 68.121
Elapsed time: mins: 43, secs: 08

The above sample errors in the log means:

TH001 : 11:34:36 : ERROR (32) : D:\TestDirectory\Dir1\FileValidation.xlsx -> Unable to open, Retrying in 1 seconds…
Error Description: The file is locked by a process on the source

TH002 : 11:41:36 : ERROR (5) : D:\TestDirectory\Dir1\FileValidation2.xlsx -> SD not set, Failed after 1 retries….
Error Description: Migration account do not have enough permission “Access Denied”

TH003 : 11:53:40 : ERROR (64) : D:\TestDirectory\Dir2\FileValidation1.xlsx -> Unable to get content, Failed after 1 retries….
Error Description: the path no longer exists, this can occur if source is overloaded because EMCopy is running with a lot of threads or source is a stub (archived) and source cannot be found