Migrera volymer till Azure NetApp Files

2025-10-22

Med Azure NetApp Files migreringsassistent kan du peer-koppla och migrera volymer från lokala ONTAP- eller molnvolymer ONTAP till Azure NetApp Files. Funktionen är för närvarande endast tillgänglig med REST-API:et.

Kravspecifikation

I ONTAP- eller molnvolymer ONTAP måste du köra ONTAP 9.10.0 eller senare.
SnapMirror-licensrättigheter måste hämtas och tillämpas på det lokala ONTAP- eller Cloud Volumes ONTAP-klustret. Arbeta med ditt kontoteam för att involvera en Azure Technology Specialist i att tillämpa licensen på det lokala lagringsklustret.
Låsning av ögonblicksbilder måste inaktiveras för volymer i källklustret. Om låsning av ögonblicksbilder är aktiverat får du en Last transfer error. Information om hur du inaktiverar låsning av ögonblicksbilder finns i ONTAP-dokumentationen.
Kontrollera att nätverkstopologin stöds för Azure NetApp Files. Se till att du har upprättat anslutningen från din lokala lagring till Azure NetApp Files.
Det delegerade undernätets adressutrymme för att vara värd för Azure NetApp Files-volymerna måste ha minst sju kostnadsfria IP-adresser: sex för klusterpeering och en för dataåtkomst till migreringsvolymerna.
Det delegerade adressutrymmet för undernätet bör vara lämpligt för att hantera fler Azure NetApp Files-nätverksgränssnitt. Läs Riktlinjerna för Azure NetApp Files-nätverksplanering för att säkerställa att du uppfyller kraven för delegerad storlek på undernät.
Med migreringsassistenten måste Azure NetApp Files-volymer använda standardnätverksfunktioner. Mer information om hur du ställer in nätverksfunktioner finns i Konfigurera nätverksfunktioner.
När du har utfärdat peering-begäran måste begäran accepteras inom 60 minuter efter att begäran har skapats. Peer-begäranden upphör att gälla om de inte godkänns inom 60 minuter.
Du bör slutföra migreringar från ett enda källkluster med en Azure-prenumeration innan du migrerar volymer som är avsedda för en annan prenumeration. Klusterpeering misslyckas när du använder en andra Azure-prenumeration och samma externa källkluster.
Om du använder Azure RBAC för att separera rollen för Azure NetApp Files-lagringshantering i syfte att separera volymhanteringsuppgifter där volymer finns på samma nätverkssyskonuppsättning bör du vara medveten om att externt anslutna ONTAP-system som är peerkopplade till den syskonuppsättningen inte följer dessa Azure-definierade roller. Den externa lagringsadministratören kan ha begränsad synlighet för alla volymer i syskonuppsättningen som visar information om metadata på lagringsnivå.
När du skapar varje migreringsvolym försöker algoritmen för volymplacering i Azure NetApp Files återanvända samma Azure NetApp Files-lagringssystem som alla tidigare skapade volymer i prenumerationen för att minska antalet nätverkskort eller IP-adresser som förbrukas i det delegerade undernätet. Om detta inte är möjligt förbrukas ytterligare sju nätverkskort.
Du bör se till att det inte finns några externa FlexGroup-volymer eftersom de inte kan migreras till stora Volymer i Azure NetApp Files.
När migreringen pågår ska du inte aktivera funktioner som säkerhetskopiering. Aktivera endast funktioner när migreringen har slutförts.

Tips/Råd

Hjälp med att skapa en migreringsvolym och peeringkluster för migreringsassistenten finns i exempelskriptet för PowerShell-migreringsassistentens arbetsflöde.

Registrera funktionen

Du måste registrera funktionen innan du använder den för migreringsassistenten för första gången. Efter registreringen är funktionen aktiverad och fungerar i bakgrunden.

Registrera funktionen:

Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMigrationAssistant

Kontrollera status för funktionsregistreringen:

Anmärkning

RegistrationState kan vara i tillståndet i Registering upp till 60 minuter innan du ändrar tillRegistered. Vänta tills statusen har registrerats innan du fortsätter.
```
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMigrationAssistant
```

Du kan också använda Azure CLI-kommandonaz feature register och az feature show registrera funktionen och visa registreringsstatusen.

Innan du börjar

Du måste skapa Express Route- eller VPN-resurser för att säkerställa nätverksanslutningen från det externa NetApp ONTAP-klustret till azure NetApp Files-målklustret. Det finns flera sätt att säkerställa nätverksanslutningen. Anslutningen omfattar den här uppsättningen brandväggsregler (dubbelriktade för alla):

ICMP
TCP 11104
TCP 11105
HTTPS

Nätverksanslutningen måste finnas för alla intercluster-LIF:er (IC) i källklustret till alla IC LIFs på Azure NetApp Files-slutpunkten.

Anmärkning

Migreringsassistenten kopierar allt volyminnehåll, inklusive kataloger, filer, filmetadata (till exempel ägare, skapandedatum, ändrat datum) och befintliga ögonblicksbilder. Du ansvarar för att säkerställa att Azure NetApp Files-målvolymen har konfigurerats med LDAP eller Active Directory.

Migrera volymer

Autentisera med Azure Active Directory för att hämta en OAuth-token. Den här token används för efterföljande API-anrop.

Skapa en API-begäran för migrering för att skapa Azure NetApp Files-volymer för varje lokal volym som du tänker migrera.

Viktigt!

Kontrollera att storleken och andra volymegenskaper på målvolymerna matchar källan.

Du bör skapa Azure NetApp Files-volymen med 20% eller mer kvot än källvolymen. Azure NetApp Files-volymer använder logisk kapacitetsstorlek. Källvolymen kan vara mindre på grund av deduplicering och komprimering. Använd det logiska utrymme som rapporteras av den volym som du migrerar för att få rätt storlek på Azure NetApp Files-volymen. Du kan krympa Azure NetApp Files utan avbrott efter migreringen för att förhindra överetablering.

Värdena för "fjärrsökväg" är värd-, server- och volymnamnen för din lokala lagring.

PUT: https://<region>.management.azure.com/subscriptions/<subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.NetApp/netAppAccounts/<account-name>/capacityPools/<capacity-pool-name>/volumes/Migvolfinal?api-version=2025-06-01
Body: {
   "type":"Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
   "location":"<LOCATION>",
   "properties":{
      "volumeType":"Migration",
      "dataProtection":{
         "replication":{
            "endpointType":"Dst",
            "replicationSchedule":"Hourly",
            "remotePath":{
               "externalHostName":"<external-host-name>",
               "serverName":"<server-name>",
               "volumeName":"<volume-name>"
            }
         }
      },
      "serviceLevel":"<service-level>",
      "creationToken":"<token>",
      "usageThreshold":<value>,
      "exportPolicy":{
         "rules":[
            {
               "ruleIndex":1,
               "unixReadOnly":false,
               "unixReadWrite":true,
               "cifs":<true|false>,
               "nfsv3":<true|false>,
               "nfsv41":<true|false>,
               "allowedClients":"0.0.0.0/0",
               "kerberos5ReadOnly":<true|false>,
               "kerberos5ReadWrite":<true|false>,
               "kerberos5iReadOnly":<true|false>,
               "kerberos5iReadWrite":<true|false>,
               "kerberos5pReadOnly":<true|false>,
               "kerberos5pReadWrite":<true|false>,
               "hasRootAccess":<true|false>
            }
         ]
      },
      "protocolTypes":[
         "<protocols>"
      ],
      "subnetId":"/subscriptions/<subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Network/virtualNetworks/<virtual-network-name>/subnets/<subnet>",
      "networkFeatures":"Standard",
      "isLargeVolume":"false"
   }
}

Utfärda en api-begäran om klusterpeering för var och en av azure NetApp Files-målmigreringsvolymerna till det lokala klustret. Upprepa det här steget för varje migreringsvolym. Varje anrop måste tillhandahålla en lista över lokala kluster-intercluster-LIF:er. Peer-IP-adresserna måste matcha ditt lokala nätverk.

Anmärkning

Klusterpeering stöder endast en aktiv prenumeration mellan ett givet par käll- och målkluster. Om en andra prenumeration skapas för samma klusterpar misslyckas peeringprocessen. Inom samma zon kan endast en aktiv prenumeration migreras i taget. Migreringar mellan olika zoner stöds dock och slutförs.

Anmärkning

Varje nod i DITT ONTAP-system behöver en IC LIF. Varje IC LIF måste anges här.
```
    PUT https://<region>.management.azure.com/subscriptions/<subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.NetApp/netAppAccounts/<account-name>/capacityPools/<capacity-pool-name>/volumes/<volume-names>/peerExternalCluster?api-version=2025-06-01

    Body: {
       "PeerAddresses":[
          "<LIF address>",
          "<LIF address>", 
          "<LIF address>",
          "<LIF address>"
       ]
    }
```
Visa resultatrubriken. Kopiera ID:t Azure-AsyncOperation .

I ONTAP- eller Cloud Volumes ONTAP-systemet godkänner du kluster peer-begäran från Azure NetApp Files genom att skicka en GET-begäran med hjälp av Azure-AsyncOperation ID.

POST https://<region>.management.azure.com/subscriptions/<subscription-ID>/providers/Microsoft.NetApp/locations/<location>/operationResults/<Azure-AsyncOperation>?api-version=2025-06-01...

Anmärkning

Den här åtgärden kan ta tid. Kontrollera statusen för begäran. Den är klar när statusen lyder "Lyckades". Azure-AsyncOperation Om inte svarar efter en timme eller om det misslyckas med ett fel kör peerExternalCluster du kommandot igen. Se till att nätverkskonfigurationen mellan ditt externa ONTAP- eller Cloud Volumes ONTAP-system och ditt Azure NetApp Files-delegerade undernät fungerar innan du fortsätter.

{
    "id": "/subscriptions/<subscriptionID>/providers/Microsoft.NetApp/locations/southcentralus/operationResults/00000-aaaa-1111-bbbb-22222222222",
    "name": "<name>",
    "status": "Succeeded",
    "name": "<name>",
    "status": "Succeeded",
    "startTime": "2023-11-02T07:48:53.6563893Z",
    "endTime": "2023-11-02T07:53:25.3253982Z",
    "percentComplete": 100.0,
    "properties": {
        "peerAcceptCommand": "cluster peer create -ipspace <IP-SPACE-NAME> -encryption-protocol-proposed tls-psk -peer-addrs <peer-addresses-list>",
        "passphrase": "<passphrase>"
    }
}

När du har fått statusen lyckades kopierar och klistrar du in strängen peerAcceptCommand på kommandoraden för dina lokala volymer följt av lösenfrasens sträng.

Anmärkning

Om strängen peerAcceptCommand i svarstexten är tom har peering redan upprättats. Hoppa över det här steget för motsvarande migreringsvolym.

Utfärda en authorizeExternalReplication API-begäran för dina migreringsvolymer. Upprepa den här begäran för varje migreringsvolym.

POST: https://<region>.management.azure.com/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.NetApp/netAppAccounts/<account-name>/capacityPools/<capacity-pool-name>/volumes/<volume-names>/authorizeExternalReplication?api-version=2025-06-01

Acceptera peer-begäran för den virtuella lagringsdatorn (SVM) från Azure NetApp Files genom att skicka en GET-begäran med hjälp av Azure-AsyncOperation-ID:t i steg 4.

GET https://<region>.management.azure.com/subscriptions/<subscription-ID>/providers/Microsoft.NetApp/locations/<location>/operationResults/<>?api-version=2025-06-01&...

Ett exempelsvar:

{
    "id": "/subscriptions/00000000-aaaa-0000-aaaa-0000000000000/providers/Microsoft.NetApp/locations/southcentralus/operationResults/00000000-aaaa-000-aaaa-000000000000"
    "name": "00000000-aaaa-000-aaaa-000000000000",
    "status": "Succeeded",
    "name": "00000000-aaaa-0000-aaaa-0000000000000",
    "status": "Succeeded",
    "startTime": "2023-11-02T07:48:53.6563893Z",
    "endTime": "2023-11-02T07:53:25.3253982Z",
    "percentComplete": 100.0,
    "properties": {
        "svmPeeringCommand": "vserver peer accept -vserver on-prem-svm-name -peer-vserver destination-svm-name",
    }
}

Tillåt att baslinjedataöverföringen slutförs. Du kan övervaka replikeringens status med hjälp av Azure-portalen eller REST-API:et.

När du har fått svaret kopierar du CLI-kommandot från svmPeeringCommand till ONTAP CLI.
När baslinjeöverföringarna har slutförts väljer du en tid för att ta de lokala volymerna offline för att förhindra nya dataskrivningar.

Om det fanns ändringar i data efter baslinjeöverföringen skickar du en begäran om att utföra replikeringsöverföring för att samla in inkrementella data som skrivits efter att baslinjeöverföringen har slutförts. Upprepa den här åtgärden för varje migreringsvolym.

    POST https://<region>.management.azure.com/subscriptions/<subscription-ID>/resourceGroups/<resource-group-names>/providers/Microsoft.NetApp/netAppAccounts/<account-name>>/capacityPools/<capacity-pool>/volumes/<volumes>/performReplicationTransfer?api-version=2024-06-01

Avbryt replikeringsrelationen. Om du vill avbryta replikeringen i portalen går du till varje volyms replikeringsmeny och väljer Sedan Bryt peering. Du kan alternativt skicka en API-begäran:
```
POST https://<region>.management.azure.com/subscriptions/<subscription-ID>/resourceGroups/<resource-group>/providers/Microsoft.NetApp/netAppAccounts/<NetApp-account>/capacityPools/<capacity-pool-name>>/volumes/<volumes>/breakReplication?api-version=2025-06-01
```
Anmärkning

När du har brutit replikeringsrelationen kör snapmirror du inga kommandon (till exempel snapmirror delete eller snapmirror release); dessa kommandon gör Azure NetApp Files-volymerna oanvändbara.
Ta bort migreringsreplikeringsrelationen. Om den borttagna replikeringen är den senaste migreringen som är associerad med din prenumeration tas den associerade kluster peer- och intercluster-LIF:erna bort.
```
POST https://<region>.management.azure.com/subscriptions/<subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.NetApp/netAppAccounts/<NetApp-account>/capacityPools/<capacity-pool>/volumes/<volume-names>/finalizeExternalReplication?api-version=2025-06-01
```
När replikeringen slutförs tar all peeringinformation bort på Azure NetApp Files. Bekräfta manuellt att alla replikeringsdata tas bort i ONTAP-klustret. Kör kommandot om någon peeringinformation finns kvar cluster peer delete .

Mer information

Feedback

Var den här sidan till hjälp?