Tutorial: Import data to Blob Storage with Azure Import/Export service

This article provides step-by-step instructions on how to use the Azure Import/Export service to securely import large amounts of data to Azure Blob storage. To import data into Azure Blobs, the service requires you to ship encrypted disk drives containing your data to an Azure datacenter.

In deze zelfstudie leert u het volgende:

• Prerequisites to import data to Azure Blob storage
• Step 1: Prepare the drives
• Step 2: Create an import job
• Step 3: Configure customer managed key (Optional)
• Step 4: Ship the drives
• Step 5: Update job with tracking information
• Step 6: Verify data upload to Azure

Vereiste voorwaarden

Before you create an import job to transfer data into Azure Blob Storage, carefully review and complete the following list of prerequisites for this service. U moet het volgende doen:

• Een actief Azure-abonnement hebben dat kan worden gebruikt voor de Import/Export-service.
• Have at least one Azure Storage account with a storage container. Zie de lijst met ondersteunde opslagaccounts en opslagtypen voor de Import/Export-service.
  • Zie Een opslagaccount maken voor meer informatie over het maken van een nieuw opslagaccount.
  • For information on creating storage containers, go to Create a storage container.
• Have adequate number of disks of supported types.
• Have a Windows system running a supported OS version.
• Enable BitLocker on the Windows system. See How to enable BitLocker.
• Download the current release of the Azure Import/Export version 1 tool, for blobs, on the Windows system:
  1. Download WAImportExport versie 1. De huidige versie is 1.5.0.300.
  2. Unzip to the default folder WaImportExportV1. Bijvoorbeeld: C:\WaImportExportV1.

• Have a valid carrier account and a tracking number for the order:
  • U moet een vervoerder gebruiken in de lijst met namen van vervoerders op het tabblad Verzending voor uw bestelling. Als u geen provideraccount hebt, neemt u contact op met de provider om er een te maken.
  • Het provideraccount moet geldig zijn, moet een saldo hebben en moet retourmogelijkheden hebben. Microsoft gebruikt de geselecteerde provider om alle opslagmedia te retourneren.
  • Genereer een traceringsnummer voor de import-/exporttaak in het provideraccount. Elke taak moet een afzonderlijk traceringsnummer hebben. Meerdere taken met hetzelfde volgnummer worden niet ondersteund.

Step 1: Prepare the drives

This step generates a journal file. The journal file stores basic information such as drive serial number, encryption key, and storage account details.

Perform the following steps to prepare the drives.

1. Connect your disk drives to the Windows system via SATA connectors.

2. Create a single NTFS volume on each drive. Assign a drive letter to the volume. Don't use mountpoints.

3. Enable BitLocker encryption on the NTFS volume. If using a Windows Server system, use the instructions in How to enable BitLocker on Windows Server 2012 R2.

4. Copy data to encrypted volume. Use drag and drop or Robocopy or any such copy tool. A journal (.jrn) file is created in the same folder where you run the tool.

   If the drive is locked and you need to unlock the drive, the steps to unlock may be different depending on your use case.

   • If you have added data to a pre-encrypted drive (WAImportExport tool wasn't used for encryption), use the BitLocker key (a numerical password that you specify) in the popup to unlock the drive.

   • If you have added data to a drive that was encrypted by WAImportExport tool, use the following command to unlock the drive:

     WAImportExport Unlock /bk:<BitLocker key (base 64 string) copied from journal (*.jrn*) file>

5. Open een PowerShell- of opdrachtregelvenster met beheerdersbevoegdheden. To change directory to the unzipped folder, run the following command:

   cd C:\WaImportExportV1

6. To get the BitLocker key of the drive, run the following command:

   manage-bde -protectors -get <DriveLetter>:

7. To prepare the disk, run the following command. Depending on the data size, disk preparation may take several hours to days.

   ./WAImportExport.exe PrepImport /j:<journal file name> /id:session<session number> /t:<Drive letter> /bk:<BitLocker key> /srcdir:<Drive letter>:\ /dstdir:<Container name>/ /blobtype:<BlockBlob or PageBlob> /skipwrite
   

   A journal file is created in the same folder where you ran the tool. Two other files are also created - an .xml file (folder where you run the tool) and a drive-manifest.xml file (folder where data resides).

   The parameters used are described in the following table:

   Optie	Beschrijving
   /j:	The name of the journal file, with the .jrn extension. A journal file is generated per drive. We recommend that you use the disk serial number as the journal file name.
   /id:	De sessie-id. Use a unique session number for each instance of the command.
   /t:	The drive letter of the disk to be shipped. For example, drive D.
   /bk:	The BitLocker key for the drive. Its numerical password from output of manage-bde -protectors -get D:
   /srcdir:	The drive letter of the disk to be shipped followed by :\. Bijvoorbeeld: D:\.
   /dstdir:	The name of the destination container in Azure Storage.
   /blobtype:	This option specifies the type of blobs you want to import the data to. For block blobs, the blob type is BlockBlob and for page blobs, it's PageBlob.
   /skipwrite:	Specifies that there's no new data required to be copied and existing data on the disk is to be prepared.
   /enablecontentmd5:	The option when enabled, ensures that MD5 is computed and set as Content-md5 property on each blob. Use this option only if you want to use the Content-md5 field after the data is uploaded to Azure. This option doesn't affect the data integrity check (that occurs by default). The setting does increase the time taken to upload data to cloud.

   Notitie

   • If you import a blob with the same name as an existing blob in the destination container, the imported blob will overwrite the existing blob. In earlier tool versions (before 1.5.0.300), the imported blob was renamed by default, and a \Disposition parameter let you specify whether to rename, overwrite, or disregard the blob in the import.
   • If you don't have long paths enabled on the client, and any path and file name in your data copy exceeds 256 characters, the WAImportExport tool will report failures. To avoid this kind of failure, enable long paths on your Windows client.

8. Repeat the previous step for each disk that needs to be shipped.

   A journal file with the provided name is created for every run of the command line.

   Together with the journal file, a <Journal file name>_DriveInfo_<Drive serial ID>.xml file is also created in the same folder where the tool resides. The .xml file is used in place of the journal file when creating a job if the journal file is too large.

Belangrijk

• Do not modify the journal files or the data on the disk drives, and don't reformat any disks, after completing disk preparation.
• The maximum size of the journal file that the portal allows is 2 MB. If the journal file exceeds that limit, an error is returned.

Step 2: Create an import job

Portal

Do the following steps to order an import job in Azure Import/Export job via the portal.

1. Gebruik uw Microsoft Azure-referenties om u aan te melden op deze URL: https://portal.azure.com.

2. Select + Create a resource, and search for Azure Data Box. Kies Azure Data Box.

   

3. Klik op Creëren.

   

4. Selecteer de volgende opties om aan de slag te gaan met de importorder:

   1. Select the Import to Azure transfer type.
   2. Selecteer het abonnement dat u wilt gebruiken voor de import-/exporttaak.
   3. Selecteer een resourcegroep.
   4. Select the Source country/region for the job.
   5. Select the Destination Azure region for the job.
   6. Selecteer vervolgens Toepassen.

   

5. Kies de knop Selecteren voor de import-/exporttaak.

   

6. In Basis:

   • Voer een beschrijvende naam in voor de taak. Use the name to track the progress of your jobs.
     • De naam moet 3 tot 24 tekens bevatten.
     • De naam mag alleen letters, cijfers en afbreekstreepjes bevatten.
     • De naam moet beginnen en eindigen met een letter of cijfer.

   

   Select Next: Job Details > to proceed.

7. In Job Details:

   1. Before you go further, make sure you're using the latest WAImportExport tool. The tool is used to read the journal file(s) that you upload. You can use the download link to update the tool.

      

   2. Change the destination Azure region for the job if needed.

   3. Select one or more storage accounts to use for the job. You can create a new storage account if needed.

   4. Under Drive information, use the Copy button to upload each journal file that you created during the preceding Step 1: Prepare the drives. When you upload a journal file, the Drive ID is displayed.

      • If waimportexport.exe version1 was used, upload one file for each drive that you prepared.

      • If the journal file is larger than 2 MB, then you can use the <Journal file name>_DriveInfo_<Drive serial ID>.xml, which was created along with the journal file.

        

   

8. In Return shipping:

   1. Selecteer een vervoerder in de vervolgkeuzelijst voor Carrier. De locatie van het Microsoft-datacenter voor de geselecteerde regio bepaalt welke providers beschikbaar zijn.

   2. Voer een nummer van het provideraccount in. Het rekeningnummer voor een geldig provideraccount is vereist.

   3. In the Return address area, select the + Add Address button, and add the address to ship to.

      

      Op de blade Adres toevoegen kunt u een adres toevoegen of een bestaand adres gebruiken. When you complete the address fields, select Add shipping address.

      

   4. Voer in het meldingsgebied e-mailadressen in voor de personen die u op de hoogte wilt stellen van de voortgang van de opdracht.

      Tip

      In plaats van een e-mailadres voor één gebruiker op te geven, geeft u een groeps-e-mail op om ervoor te zorgen dat u meldingen ontvangt, zelfs als een beheerder vertrekt.

   

   Selecteer Beoordelen + Maken om door te gaan.

9. In Beoordelen en maken:

   1. Review the Terms and Privacy information, and then select the checkbox by "I acknowledge that all the information provided is correct and agree to the terms and conditions." Validation is then done.
   2. Controleer de taakgegevens. Noteer de taaknaam en het verzendadres van het Azure-datacenter waarnaar schijven worden verzonden. Deze informatie wordt later op het verzendlabel gebruikt.
   3. Klik op Creëren.

   

10. Nadat de taak is gemaakt, ziet u het volgende bericht.

    

    You can select Go to resource to open the Overview of the job.

    

Azure CLI

Use the following steps to create an import job in the Azure CLI.

Uw omgeving voorbereiden voor de Azure CLI

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Quickstart voor Bash in Azure Cloud Shellvoor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met de opdracht az login. Volg de stappen die worden weergegeven in uw terminal om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Wanneer u hierom wordt gevraagd, installeert u de Azure CLI-extensie voor het eerste gebruik. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.

Een taak maken

1. Gebruik de opdracht az extension add om de extensie az import-export toe te voegen:

   az extension add --name import-export
   

2. You can use an existing resource group or create one. Voer de opdracht az group create uit om een resourcegroep te maken:

   az group create --name myierg --location "West US"
   

3. You can use an existing storage account or create one. To create a storage account, run the az storage account create command:

   az storage account create --resource-group myierg --name myssdocsstorage --https-only
   

4. To get a list of the locations to which you can ship disks, use the az import-export location list command:

   az import-export location list
   

5. Use the az import-export location show command to get locations for your region:

   az import-export location show --location "West US"
   

6. Run the following az import-export create command to create an import job:

   az import-export create \
       --resource-group myierg \
       --name MyIEjob1 \
       --location "West US" \
       --backup-drive-manifest true \
       --diagnostics-path waimportexport \
       --drive-list bit-locker-key=439675-460165-128202-905124-487224-524332-851649-442187 \
           drive-header-hash= drive-id=AZ31BGB1 manifest-file=\\DriveManifest.xml \
           manifest-hash=69512026C1E8D4401816A2E5B8D7420D \
       --type Import \
       --log-level Verbose \
       --shipping-information recipient-name="Microsoft Azure Import/Export Service" \
           street-address1="3020 Coronado" city="Santa Clara" state-or-province=CA postal-code=98054 \
           country-or-region=USA phone=4083527600 \
       --return-address recipient-name="Gus Poland" street-address1="1020 Enterprise way" \
           city=Sunnyvale country-or-region=USA state-or-province=CA postal-code=94089 \
           email=gus@contoso.com phone=4085555555" \
       --return-shipping carrier-name=FedEx carrier-account-number=123456789 \
       --storage-account myssdocsstorage
   

   Tip

   Instead of specifying an email address for a single user, provide a group email. This ensures that you receive notifications even if an admin leaves.

7. Use the az import-export list command to see all the jobs for the myierg resource group:

   az import-export list --resource-group myierg
   

8. Als u uw taak wilt bijwerken of uw taak wilt annuleren, voert u de opdracht az import-export update uit:

   az import-export update --resource-group myierg --name MyIEjob1 --cancel-requested true
   

Azure PowerShell

Use the following steps to create an import job in Azure PowerShell.

Vereiste voorwaarden

• Als u ervoor kiest om Azure PowerShell lokaal te gebruiken:
  • Installeer de nieuwste versie van de Az PowerShell-module.
  • Maak verbinding met uw Azure-account met de cmdlet Connect-AzAccount.
• Als u ervoor kiest om Azure Cloud Shell te gebruiken:
  • Raadpleeg Overzicht van Azure Cloud Shell voor meer informatie.

Belangrijk

Hoewel de PowerShell-module Az.ImportExport in preview is, moet u deze afzonderlijk installeren met behulp van de Install-Module cmdlet. Nadat de PowerShell-module algemeen beschikbaar is geworden, wordt deze onderdeel van toekomstige releases van de Az PowerShell-module en is deze standaard beschikbaar vanuit Azure Cloud Shell.

Install-Module -Name Az.ImportExport

Een taak maken

1. You can use an existing resource group or create one. To create a resource group, run the New-AzResourceGroup cmdlet:

   New-AzResourceGroup -Name myierg -Location westus
   

2. You can use an existing storage account or create one. To create a storage account, run the New-AzStorageAccount cmdlet:

   New-AzStorageAccount -ResourceGroupName myierg -AccountName myssdocsstorage -SkuName Standard_RAGRS -Location westus -EnableHttpsTrafficOnly $true
   

3. To get a list of the locations to which you can ship disks, use the Get-AzImportExportLocation cmdlet:

   Get-AzImportExportLocation
   

4. Use the Get-AzImportExportLocation cmdlet with the Name parameter to get locations for your region:

   Get-AzImportExportLocation -Name westus
   

5. Run the following New-AzImportExport example to create an import job:

   $driveList = @(@{
     DriveId = '9CA995BA'
     BitLockerKey = '439675-460165-128202-905124-487224-524332-851649-442187'
     ManifestFile = '\\DriveManifest.xml'
     ManifestHash = '69512026C1E8D4401816A2E5B8D7420D'
     DriveHeaderHash = 'AZ31BGB1'
   })
   
   $Params = @{
      ResourceGroupName = 'myierg'
      Name = 'MyIEjob1'
      Location = 'westus'
      BackupDriveManifest = $true
      DiagnosticsPath = 'waimportexport'
      DriveList = $driveList
      JobType = 'Import'
      LogLevel = 'Verbose'
      ShippingInformationRecipientName = 'Microsoft Azure Import/Export Service'
      ShippingInformationStreetAddress1 = '3020 Coronado'
      ShippingInformationCity = 'Santa Clara'
      ShippingInformationStateOrProvince = 'CA'
      ShippingInformationPostalCode = '98054'
      ShippingInformationCountryOrRegion = 'USA'
      ShippingInformationPhone = '4083527600'
      ReturnAddressRecipientName = 'Gus Poland'
      ReturnAddressStreetAddress1 = '1020 Enterprise way'
      ReturnAddressCity = 'Sunnyvale'
      ReturnAddressStateOrProvince = 'CA'
      ReturnAddressPostalCode = '94089'
      ReturnAddressCountryOrRegion = 'USA'
      ReturnAddressPhone = '4085555555'
      ReturnAddressEmail = 'gus@contoso.com'
      ReturnShippingCarrierName = 'FedEx'
      ReturnShippingCarrierAccountNumber = '123456789'
      StorageAccountId = '/subscriptions/<SubscriptionId>/resourceGroups/myierg/providers/Microsoft.Storage/storageAccounts/myssdocsstorage'
   }
   New-AzImportExport @Params
   

   Tip

   Instead of specifying an email address for a single user, provide a group email. This ensures that you receive notifications even if an admin leaves.

6. Use the Get-AzImportExport cmdlet to see all the jobs for the myierg resource group:

   Get-AzImportExport -ResourceGroupName myierg
   

7. Als u uw taak wilt bijwerken of uw taak wilt annuleren, voert u de cmdlet Update-AzImportExport uit:

   Update-AzImportExport -Name MyIEjob1 -ResourceGroupName myierg -CancelRequested
   

Step 3 (Optional): Configure customer managed key

Skip this step and go to the next step if you want to use the Microsoft managed key to protect your BitLocker keys for the drives. To configure your own key to protect the BitLocker key, follow the instructions in Configure customer-managed keys with Azure Key Vault for Azure Import/Export in the Azure portal.

Step 4: Ship the drives

FedEx, UPS of DHL kan worden gebruikt om het pakket naar het Azure-datacenter te verzenden. Als u een andere vervoerder dan FedEx/DHL wilt gebruiken, neemt u contact op met het Azure Data Box Operations-team op adbops@microsoft.com

• Provide a valid FedEx, UPS, or DHL carrier account number for use by Microsoft to return the drives.
  • Een FedEx-, UPS- of DHL-accountnummer is vereist voor verzendingen vanaf de locaties in de VS en Europa.
    • Een DHL-rekeningnummer heeft de voorkeur voor het terugzenden van pakketten vanuit locaties in Azië en Australië.
    • Als u geen rekeningnummer hebt, maakt u een FedEx - of DHL-vervoerdersaccount .
• Wanneer u uw pakketten verzendt, moet u de Servicevoorwaarden van Microsoft Azure volgen.
• Pak uw schijven op de juiste manier in om mogelijke schade en vertragingen in de verwerking te voorkomen. Volg deze aanbevolen praktijken:
  • Wrap the disk drives securely with protective bubble wrap. Bubble wrap acts as a shock absorber and protects the drive from impact during transit. Before shipping, ensure that the entire drive is thoroughly covered and cushioned.
  • Place the wrapped drives within a foam shipper. The foam shipper provides extra protection and keeps the drive securely in place during transit.

Step 5: Update the job with tracking information

Nadat u de schijven hebt verzonden, keert u terug naar de taak in Azure Portal en vult u de traceringsgegevens in.

Nadat u traceringsgegevens hebt opgegeven, wordt de taakstatus gewijzigd in Verzending en kan de taak niet worden geannuleerd. U kunt een taak alleen annuleren terwijl deze de status Maken heeft.

Belangrijk

Als het traceringsnummer niet binnen 2 weken na het maken van de taak wordt bijgewerkt, verloopt de taak.

Portal

Voer de volgende stappen uit om de traceringsgegevens te voltooien voor een taak die u in de portal hebt gemaakt:

1. Open de taak in Azure Portal/.

2. Schuif in het deelvenster Overzicht omlaag naar Traceringsgegevens en voltooi de vermeldingen:

   1. Geef de vervoerder en het trackingnummer op.
   2. Controleer of het adres van het schip juist is.
   3. Select the checkbox by "Drives have been shipped to the above mentioned address."
   4. Wanneer u klaar bent, selecteert u Bijwerken.

   

U kunt de voortgang van de taak bijhouden in het deelvenster Overzicht . Ga naar De taakstatus weergeven voor een beschrijving van elke taakstatus.

Azure CLI

Als u uw Azure Import/Export-taak hebt gemaakt met behulp van Azure CLI, opent u de taak in Azure Portal om traceringsgegevens bij te werken. Azure CLI en Azure PowerShell maken taken in de klassieke Azure Import/Export-service en maken daarom een Azure-resource van het type Import/Export-taak.

Azure PowerShell

Als u uw Azure Import/Export-taak hebt gemaakt met behulp van Azure PowerShell, opent u de taak in Azure Portal om traceringsgegevens bij te werken. Azure CLI en Azure PowerShell maken taken in de klassieke Azure Import/Export-service en maken daarom een Azure-resource van het type Import/Export-taak.

Step 6: Verify data upload to Azure

Track the job to completion, then verify that the upload was successful and all data is present.

Review the Data copy details of the completed job to locate the logs for each drive included in the job:

• Use the verbose log to verify each successfully transferred file.
• Gebruik het kopieerlogboek om de bron te vinden van elke mislukte gegevenskopie.

For more information, see Review copy logs from imports and exports.

After you verify the data transfers, you can delete your on-premises data. Delete your on-premises data only after you verify that the upload was successful.

Notitie

If any path and file name exceeds 256 characters, and long paths aren't enabled on the client, the data upload will fail. To avoid this kind of failure, enable long paths on your Windows client.

Volgende stappen

• De taak- en schijfstatus weergeven
• Kopieerlogboeken voor importeren/exporteren controleren