AvePint High Speed Migratin Supplementary Tls User Guide Issued April 2016 1
Table f Cntents Intrductin... 3 MD5 Value Generatr Tl... 3 Azure Data Uplad Tl... 3 Dwnlading and Unpacking the Tl... 4 Using the MD5 Value Generatr Tl... 5 Using the Azure Data Uplad Tl... 7 Ntices and Cpyright Infrmatin... 9 2
Intrductin T streamline the high speed migratin prcess, AvePint created the fllwing supplementary tls. MD5 Value Generatr Tl If perfrming an ffline migratin, yu can use the Micrsft Azure Imprt/Exprt tl t cpy the exprted data t the physical device that yu are ging t ship t a Micrsft Azure data center. After yu ship the physical device and the data in the device has been upladed t a Micrsft Azure data center, yu may find that the upladed data in a Micrsft Azure data center may nt have MD5 hash values. Data in a Micrsft Azure data center with incrrect MD5 hash values r withut MD5 hash values cannt be cpied t SharePint Online, s yu must update these MD5 hash values using AvePint s MD5 Value Generatr tl. This tl shuld be used befre uplading data frm Micrsft Azure t SharePint Online. The MD5 Value Generatr tl: Updates all data in a Micrsft Azure data center with new MD5 hash values. Keeps any existing MD5 hash values (fr example, hash values that were created by a third-party tl) f BLOBs in a Micrsft Azure data center, and creates MD5 hash values fr BLOBs that d nt have MD5 hash values. Azure Data Uplad Tl After running a SharePint High Speed Migratin Exprt jb, users have t manually create BLOB cntainers in a Micrsft Azure data center and uplad exprted data t the BLOB cntainers as BLOBs prir t imprting them t SharePint Online. T help with the cntainer creatin and uplad steps, AvePint prvides the Azure Data Uplad tl t autmate the cntainer creatin prcess and data uplad prcess. This tl uses Azure APIs, s it can generate unique MD5 hash values fr each BLOB in a Micrsft Azure data center. 3
Dwnlading and Unpacking the Tl Refer t the instructins belw t dwnlad and cnfigure the package: 1. Dwnlad the DcAve _WA_Imprt_Exprt_MD5_Serial_Number.zip file by cntacting an AvePint representative fr links t this package. 2. Cpy the DcAve _WA_Imprt_Exprt_MD5_Serial_Number.zip file t any server with a wrking netwrk cnnectin. 3. Extract the DcAve _WA_Imprt_Exprt_MD5_Serial_Number.zip file n the server. The WAImprtExprtFixMD5.exe and AzureDataUplad.exe files appear in the extracted flder. 4
Using the MD5 Value Generatr Tl After SharePint r file system data is exprted by a SharePint r File System High Speed Migratin Exprt jb, yu can use the Micrsft Azure Imprt/Exprt tl t cpy the exprted data t the hard drives yu are ging t ship t Micrsft Azure. After the data in hard drives has been upladed t Micrsft Azure, the upladed data in Micrsft Azure may nt have MD5 hash values. Using this tl, yu can generate MD5 hash values fr the data in Micrsft Azure befre cpying it t SharePint Online using a SharePint r File System High Speed Migratin Imprt jb. *Nte: The user wh runs this tl must have at least Read and Write permissins t the strage lcatin. *Nte: There is help infrmatin n hw t use this tl. T view the help, enter WAImprtExprtFixMD5.exe -?, and then press Enter n the keybard. 1. On the server where the extracted WAImprtExprtFixMD5.exe flder resides, right-click Cmmand Prmpt, and then select Run as administratr. The Administratr: Cmmand Prmpt pp-up windw appears. 2. In the pp-up windw, enter the fllwing cmmands t use the MD5 Value Generatr tl: a. Enter cd, enter the full path f the extracted flder, and then press Enter n the keybard. b. Enter the fllwing cmmands: WAImprtExprtFixMD5.exe -sn:accunt Name -sk:accunt Key -srcdir:surce Flder Path -taskcunt:10 -verwrite:0 Figure 1: The MD5 Value Generatr tl cmmands. sn:accuntname The name f an accunt that can access Micrsft Azure. Replace Accunt Name with yur wn accunt name. 5
sk:accuntkey The accunt key. Replace Accunt Key with yur wn Azure accunt key. srcdir:surceflderpath The full path f the surce strage lcatin that the data was cpied frm using the Micrsft Azure Imprt/Exprt tl. taskcunt:10 The number f threads that can be used simultaneusly in ne jb. The default value is 10. *Nte: Mre threads result in a faster jb, but may affect the perfrmance f the server depending upn yur hardware cnfiguratin. verwrite:0 The cnflict reslutin fr MD5 hash values. 3. Press Enter n the keybard t run the tl. 1 means t verwrite the existing MD5 hash value f a BLOB with the value generated by this tl. In mst cases, AvePint recmmends verwriting all existing MD5 values (if any) with values generated by this tl. 0 means t keep the existing MD5 hash values fr BLOBs, and nly apply a new hash value t BLOBs that d nt already have ne. The default value is 0. Use this methd nly if yu are certain that the MD5 values generated by a third-party tl are crrect. 4. After the jb cmpletes, a lgs.txt file will be autmatically generated in the same directry as the tl. 6
Using the Azure Data Uplad Tl The Azure Data Uplad tl is recmmended fr SharePint High Speed Migratins. After SharePint data has been exprted by a SharePint High Speed Migratin Exprt jb, use this tl t autmatically create BLOB cntainers in Micrsft Azure and t uplad the exprted data t the BLOB cntainers, as BLOBs, with a unique MD5 hash value fr each BLOB. Data with MD5 hash values in Micrsft Azure can be imprted t SharePint Online using a SharePint High Speed Migratin Imprt jb. *Nte: The user wh runs this tl must have at least Read and Write permissins t the strage lcatin. *Nte: There is help infrmatin n hw t use this tl. T view the help, enter AzureDataUplad.exe -?, and then press Enter n the keybard. Figure 2: The Azure Data Uplad tl usage. 1. On the server where the extracted AzureDataUplad.exe flder resides, right-click Cmmand Prmpt, and then select Run as administratr. The Administratr: Cmmand Prmpt pp-up windw appears. 2. In the pp-up windw, enter the fllwing cmmands t use the Azure Data Uplad tl: a. Enter cd, enter the full path f the extracted flder, and then press Enter n the keybard. b. Enter the fllwing cmmands. AzureDataUplad.exe /sn:accuntname /sk:accuntkey /srcdir:surceflderpath /jbid:mh20151130163934812175 Figure 3: The Azure Data Uplad tl cmmands. sn:accuntname The name f the accunt that can access Micrsft Azure. Replace Accunt Name with yur wn accunt name. sk:accuntkey The accunt key. Replace Accunt Key with yur wn accunt key. 7
srcdir:surceflderpath The full path f the strage lcatin where flders and files are exprted by SharePint High Speed Migratin Exprt jbs. jbid:mh20151130163934812175 The ID f a SharePint High Speed Migratin Exprt jb. The jbid parameter is ptinal. 3. Press Enter n the keybard t run the tl. If the ID f a SharePint High Speed Migratin Exprt jb is entered, the exprted flder and files in the strage lcatin will be upladed t Micrsft Azure as BLOB cntainers and BLOBs. If n value is entered fr this parameter, all f the exprted flders and files f SharePint High Speed Migratin Exprt jbs in the strage lcatin will be upladed t Micrsft Azure. 4. After the jb cmpletes, an AzureUplad.lg file will be autmatically generated in the same directry as the tl. *Nte: If a flder r file fails t be upladed, the jb will fail. The reasn why the jb fails will be recrded in the AzureUplad.lg file. 8
Ntices and Cpyright Infrmatin Ntice The materials cntained in this publicatin are wned r prvided by AvePint, Inc. and are the prperty f AvePint r its licensrs, and are prtected by cpyright, trademark and ther intellectual prperty laws. N trademark r cpyright ntice in this publicatin may be remved r altered in any way. Cpyright Cpyright 2016 AvePint, Inc. All rights reserved. All materials cntained in this publicatin are prtected by United States and internatinal cpyright laws and n part f this publicatin may be reprduced, mdified, displayed, stred in a retrieval system, r transmitted in any frm r by any means, electrnic, mechanical, phtcpying, recrding r therwise, withut the prir written cnsent f AvePint, 3 Secnd Street, Jersey City, NJ 07311, USA r, in the case f materials in this publicatin wned by third parties, withut such third party s cnsent. Ntwithstanding the freging, t the extent any AvePint material in this publicatin is reprduced r mdified in any way (including derivative wrks and transfrmative wrks), by yu r n yur behalf, then such reprduced r mdified materials shall be autmatically assigned t AvePint withut any further act and yu agree n behalf f yurself and yur successrs, assigns, heirs, beneficiaries, and executrs, t prmptly d all things and sign all dcuments t cnfirm the transfer f such reprduced r mdified materials t AvePint. Trademarks AvePint, DcAve, the AvePint lg, and the AvePint Pyramid lg are registered trademarks f AvePint, Inc. with the United States Patent and Trademark Office. These registered trademarks, alng with all ther trademarks f AvePint used in this publicatin are the exclusive prperty f AvePint and may nt be used withut prir written cnsent. Micrsft, MS-DOS, Internet Explrer, Office, Office 365, SharePint, Windws PwerShell, SQL Server, Outlk, Windws Server, Active Directry, and Dynamics CRM 2013 are either registered trademarks r trademarks f Micrsft Crpratin in the United States and/r ther cuntries. Adbe Acrbat and Acrbat Reader are trademarks f Adbe Systems, Inc. All ther trademarks cntained in this publicatin are the prperty f their respective wners and may nt be used withut such party s cnsent. Changes The material in this publicatin is fr infrmatin purpses nly and is subject t change withut ntice. While reasnable effrts have been made in the preparatin f this publicatin t ensure its accuracy, AvePint makes n representatin r warranty, expressed r implied, as t its cmpleteness, accuracy, r suitability, and assumes n liability resulting frm errrs r missins in this publicatin r frm the use f the infrmatin cntained herein. AvePint reserves the right t make changes in the Graphical User Interface f the AvePint sftware withut reservatin and withut ntificatin t its users. AvePint, Inc. Harbrside Financial Center, Plaza 10 3 Secnd Street, 9th Flr Jersey City, New Jersey 07311 USA 9