Een migratietaak definiëren en starten

1. Navigeer naar de pagina Project explorer in de Azure portal om een lijst met beschikbare projecten weer te geven. Als er geen projecten bestaan of als u een nieuw project moet maken, kunt u de stappen volgen die zijn opgenomen in het artikel Manage Azure Storage Mover-projecten.

   

   Selecteer in het deelvenster Projectverkenner of de lijst met resultaten de naam van een beschikbaar project. De eigenschappen en taakoverzichtsgegevens van het project worden weergegeven in het detailvenster . Alle bestaande taakdefinities en geïmplementeerde taken die voor het project zijn gedefinieerd, worden ook weergegeven.

   Selecteer in het menu Acties in het detailvenster van het project de optie Taakdefinitie maken om het venster Een migratietaak maken te openen. Als er geen taakdefinities binnen het project bestaan, kunt u ook een taakdefinitie maken selecteren vlakbij de onderkant van het deelvenster, zoals wordt weergegeven in het volgende voorbeeld.

   

2. Voer een waarde in het verplichte veld Naam in op het tabblad Basis van het venster Migratietaak maken. U kunt ook een optionele beschrijvingswaarde van minder dan 1024 tekens toevoegen. Selecteer ten slotte in de sectie Migratieagent de agent om de gegevensmigratie uit te voeren en selecteer vervolgens Volgende om het tabblad Bron te openen. U moet een agent kiezen die zich zo dicht mogelijk bij uw gegevensbron bevindt. De geselecteerde agent moet ook resources hebben die geschikt zijn voor de grootte en complexiteit van de taak. U kunt desgewenst een andere agent aan uw taak toewijzen.

   

3. Selecteer op het tabblad Bron een optie in het veld Broneindpunt . U kunt ervoor kiezen om een bestaand broneindpunt te gebruiken of een nieuwe eindpuntresource te maken.

   Als u een bestaand broneindpunt wilt gebruiken dat u eerder hebt gedefinieerd, kiest u de optie Een bestaand eindpunt selecteren. Selecteer vervolgens de koppeling Selecteer een bestaand eindpunt als bron om het deelvenster broneindpunt te openen. In dit deelvenster wordt een gedetailleerde lijst met uw eerder gedefinieerde eindpunten weergegeven. Selecteer het juiste eindpunt en selecteer Selecteren om terug te keren naar het tabblad Bron en vul het veld Bestaand broneindpunt in.

   

   Als u een nieuw broneindpunt wilt definiëren waaruit u uw gegevens wilt migreren, selecteert u de optie Een nieuw eindpunt maken. Geef vervolgens waarden op voor de velden Hostnaam of IP, Share-naam en Protocolversie . U kunt ook een optionele beschrijvingswaarde van minder dan 1024 tekens toevoegen.

   

   Alleen bepaalde typen eindpunten kunnen worden gebruikt als een bron of een doel. De stappen voor het maken van verschillende eindpunttypen zijn vergelijkbaar, net zoals de bijbehorende gegevensvelden. De belangrijkste differentiator tussen het maken van NFS- en SMB-eindpunten is het gebruik van Azure Key Vault voor het opslaan van de gedeelde referentie voor SMB-resources. Wanneer u een eindpuntresource maakt die het SMB-protocol ondersteunt, moet u ook waarden opgeven voor de Key Vault naam en de namen van de gebruikersnaam en wachtwoordgeheimen.

   Selecteer de naam van de Key Vault uit de vervolgkeuzelijst Key Vault. U kunt waarden opgeven voor het geheim voor gebruikersnaam en geheim voor wachtwoord door het relevante geheim te selecteren in de bijbehorende vervolgkeuzelijst. U kunt de URI ook opgeven voor het geheim, zoals wordt weergegeven in de volgende schermopname.

   Zie het artikel Storage Mover-eindpunten beheren voor meer informatie over eindpuntresources .

   

   Migratietaken beginnen standaard vanaf de hoofdmap van uw share. Als uw use-case echter betrekking heeft op het kopiëren van gegevens van een specifiek pad in uw bronshare, kunt u het pad opgeven in het veld Subpad . Als u deze waarde opgeeft, wordt de gegevensmigratie gestart vanaf de locatie die u hebt opgegeven. Als het subpad dat u hebt opgegeven niet wordt gevonden, worden er geen gegevens gekopieerd.

   Voordat u een eindpunt en een taakresource maakt, is het belangrijk om te controleren of het pad dat u hebt opgegeven juist is en of de gegevens toegankelijk zijn. U kunt geen eindpunten of taakresources wijzigen nadat ze zijn gemaakt. Als het opgegeven pad onjuist is, kunt u de resources alleen verwijderen en deze opnieuw maken.

   Waarden voor host, sharenaam en subpad worden samengevoegd om het volledige migratiebronpad te vormen. Het pad wordt weergegeven in het veld Volledig pad in de sectie Volledig pad verifiëren. Kopieer het opgegeven pad en controleer of u toegang hebt tot het pad voordat u uw wijzigingen doorvoert.

   Nadat u hebt bevestigd dat de share toegankelijk is, selecteert u Volgende om de instellingen voor het broneindpunt op te slaan en uw doel te definiëren.

4. Selecteer op het tabblad Doel een optie voor het veld Doeleindpunt .

   Net als bij het broneindpunt kiest u de optie Een bestaand eindpuntreferentie selecteren als u een eerder gedefinieerd eindpunt wilt gebruiken. Selecteer vervolgens de koppeling Selecteer een bestaand eindpunt als doel om het doeleindpuntvenster te openen. Er wordt een gedetailleerde lijst met uw eerder gedefinieerde eindpunten weergegeven. Selecteer in de lijst met eindpunten het gewenste eindpunt, selecteer vervolgens Selecteren om het veld Bestaand broneindpunt te vullen en terug te keren naar het tabblad Bron.

   

   Als u een nieuw doeleindpunt wilt definiëren, kiest u ook de optie Een nieuw eindpunt maken. Selecteer vervolgens waarden in de vervolgkeuzelijsten voor de velden Abonnement en Opslagaccount. U kunt ook een optionele beschrijvingswaarde van minder dan 1024 tekens toevoegen. Afhankelijk van uw use-case selecteert u het juiste *Doeltype.

   Zoals u weet, kunnen bepaalde typen eindpunten alleen worden gebruikt als bron of doel.

   De huidige Azure Storage Mover-release biedt ondersteuning voor volledige migraties voor specifieke combinaties van brondoelparen. Gebruik altijd de nieuwste agentversie om te profiteren van deze ondersteunde bronnen en bestemmingen:

   Bronprotocol	Doel	Opmerkingen
   AWS S3	Azure blob-container	AWS (Amazon Web Services) S3-buckets met Gletsjer- of Gletsjer Deep Archive-opslagklassen kunnen niet worden gemigreerd.
   SMB 2.x- en 3.x-koppeling	Azure bestandsshare (SMB)	SMB 1.x-bronnen en NFS-Azure-bestandsshares worden momenteel niet ondersteund.
   SMB 2.x- en 3.x-koppeling	Azure blob-container	Containers met de functie Flatnamespace (FNS) en HNS (Hierarchical Namespace Service) worden ondersteund en de ADLS Gen2 REST API-set wordt gebruikt voor migratie.
   NFS 3- en 4-koppeling	Azure blob-container	Containers met de functie Flatnamespace (FNS) en HNS (Hierarchical Namespace Service) worden ondersteund en de ADLS Gen2 REST API-set wordt gebruikt voor migratie.
   NFS 3- en 4-koppeling	Azure bestandsdeling (NFS 4.1)	NFS-Azure bestandsshares worden ondersteund met NFS v3/4-bron

   

   Een doelsubpadwaarde kan worden gebruikt om een locatie op te geven in de doelcontainer waar uw gemigreerde gegevens moeten worden gekopieerd. De subpadwaarde is relatief ten opzichte van de hoofdmap van de container. U kunt een unieke waarde opgeven om een nieuwe submap te genereren. Als u de waarde van het subpad weglaat, worden gegevens gekopieerd naar de root.

   Nadat u de nauwkeurigheid van uw instellingen hebt gecontroleerd, selecteert u Volgende om door te gaan.

5. Noteer op het tabblad Instellingen de instellingen die zijn gekoppeld aan de kopieermodus en migratieresultaten. De kopieermodus van de service is van invloed op het gedrag van de migratie-engine wanneer bestanden of mappen wisselen tussen kopieeriteraties.

   Bron samenvoegen met doel:

   • Bestanden bevinden zich in het doel, zelfs als ze niet bestaan in de bron.
   • Bestanden met overeenkomende namen en paden worden bijgewerkt zodat deze overeenkomen met de bron.
   • Naamwijzigingen van bestanden of mappen tussen kopieën zorgen voor dubbele inhoud in de doelmap.

   Bron spiegelen naar doelbestand:

   • Bestanden in het doel worden verwijderd als ze niet bestaan in de bron.
   • Bestanden en mappen in het doel worden bijgewerkt zodat deze overeenkomen met de bron.
   • Namen van bestanden of mappen tussen kopieën genereren geen dubbele inhoud. Een hernoemd item aan de bronzijde leidt tot het verwijderen van het item met de oorspronkelijke naam in het doel. Daarnaast wordt het hernoemde item ook geüpload naar het doel. Als het hernoemde item een map is, is het beschreven gedrag van verwijderen en opnieuw laden van toepassing op alle bestanden en mappen in het item. Vermijd het wijzigen van de naam van mappen tijdens een migratie, met name in de buurt van het hoofdniveau van uw brongegevens.

   Migratieresultaten zijn gebaseerd op de specifieke opslagtypen van de bron- en doeleindpunten. Omdat blobopslag bijvoorbeeld alleen virtuele mappen ondersteunt, worden de paden van bronbestanden in mappen aan het begin van hun namen toegevoegd en in een platte lijst binnen een blobcontainer geplaatst. Lege mappen worden weergegeven als een lege blob in het doel. Metagegevens van de bronmap blijven behouden in het aangepaste metagegevensveld van een blob, net als bij bestanden.

   Nadat u de effecten van de kopieermodus en migratieresultaten hebt bekeken, selecteert u Volgende om de waarden van de vorige tabbladen te bekijken.

6. Controleer de instellingen voor taaknaam en beschrijving en instellingen voor eindpunten voor bron- en doelopslag. Gebruik de opties Vorige en Volgende om door de tabbladen te navigeren en eventuele fouten te corrigeren, indien nodig. Ten slotte selecteer Maken om de taakdefinitie te provisioneren.

   

7. Navigeer naar de pagina Project Explorer in de Azure-portal om een lijst met beschikbare projecten weer te geven. Selecteer een project en u ziet een lijst met taken. Selecteer een taak en selecteer Taak starten.

• Op dit moment kan slechts één taak tegelijk worden uitgevoerd op een bepaalde agent. Als er al een andere taak actief is, zal het starten van nog een taak mislukken. Mover-agent plaatst een markeringsbestand op de doelshare of container wanneer deze een taak start (bestandsnaam ').
• De gebruiker kan slechts één taak op een bepaald moment uitvoeren voor een doelcontainer of -share. Als u meerdere agents uitvoert, kunt u deze niet gebruiken om de taak uit te voeren op dezelfde doelshare of container. De taak die later wordt uitgevoerd, krijgt de foutmelding 'Kan het doel niet claimen: Doel is bezet' (fout AZSM1027)

U moet verschillende cmdlets gebruiken om een nieuwe taakdefinitie te maken. Zoals eerder vermeld, moeten bron- en doeleindpunten worden gemaakt voordat ze worden verwezen door een taakdefinitie.

Gebruik de New-AzStorageMoverJobDefinition cmdlet om een nieuwe taakdefinitieresource in een project te maken. In de volgende voorbeelden wordt ervan uitgegaan dat u geen opslageindpunten gebruikt die u eerder hebt gemaakt.

      
##  Set variables
$subscriptionID     = "Your subscription ID"
$resourceGroupName  = "Your resource group name"
$storageMoverName   = "Your storage mover name"

##  Log into Azure with your Azure credentials
Connect-AzAccount -SubscriptionId $subscriptionID

##  Define the source endpoint: an NFS share in this example
##  There is a separate cmdlet for creating each type of endpoint.
##  (Each storage location type has different properties.)
##  Run "Get-Command -Module Az.StorageMover" to see a full list.
$sourceEpName        = "Your source endpoint name could be the name of the share"
$sourceEpDescription = "Optional, up to 1024 characters"
$sourceEpHost        = "The IP address or DNS name of the source share NAS or server"
$sourceEpExport      = "The name of your source share"
##  Note that Host and Export will be concatenated to [Host]:/[Export] to form the full path 
##  to the source NFS share

New-AzStorageMoverNfsEndpoint `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -Name $sourceEpName `
    -Host $sourceEpHost `
    -Export $sourceEpExport `
    -Description $sourceEpDescription # Description optional

##  Define the target endpoint: an Azure blob container in this example
$targetEpName          = "Target endpoint or blob container name"
$targetEpDescription   = "Optional, up to 1024 characters"
$targetEpContainer     = "The name of the target container in Azure"
$targetEpSaResourceId  = /subscriptions/<GUID>/resourceGroups/<name>/providers/`
                         Microsoft.Storage/storageAccounts/<storageAccountName>
##  Note: the target storage account can be in a different subscription and region than
##  the storage mover resource.
##
##  Only the storage account resource ID contains a fully qualified reference.

New-AzStorageMoverAzStorageContainerEndpoint `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -Name $targetEpName `
    -BlobContainerName $targetEpContainer `
    -StorageAccountResourceId $targetEpSaResourceId `
    -Description $targetEpDescription # Description optional

## Create a job definition resource
$projectName        = "Your project name"
$jobDefName         = "Your job definition name"
$JobDefDescription  = "Optional, up to 1024 characters"
$jobDefCopyMode     = "Additive" # Merges source into target. See description in portal tab.
#$jobDefCopyMode    = "Mirror" # Mirrors source into target. See description in portal tab.
$agentName          = "The name of an agent previously registered to the same storage mover resource"


New-AzStorageMoverJobDefinition `
    -Name $jobDefName `
    -ProjectName $projectName `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -CopyMode $jobDefCopyMode `
    -SourceName $sourceEpName `
    -TargetName $targetEpName `
    -AgentName $agentName `
    -Description $sourceEpDescription # Description optional