Udostępnij przez

Migrowanie woluminów do usługi Azure NetApp Files

Za pomocą asystenta migracji usługi Azure NetApp Files można migrować woluminy z lokalnych woluminów ONTAP lub Cloud Volumes ONTAP do usługi Azure NetApp Files. Asystent migracji jest ogólnie dostępny za pomocą interfejsu API REST i w wersji zapoznawczej witryny Azure Portal.

Requirements

  • Na woluminach ONTAP lub Cloud Volumes ONTAP należy uruchomić funkcję ONTAP 9.10.0 lub nowszą.
  • Uprawnienia licencji SnapMirror należy uzyskać i zastosować do lokalnego klastra ONTAP lub woluminów w chmurze ONTAP. Skontaktuj się z zespołem ds. kont, aby zaangażować specjalistę ds. technologii platformy Azure w stosowanie licencji do klastra magazynu lokalnego.
  • Blokowanie migawek musi być wyłączone dla woluminów w klastrze źródłowym. Jeśli blokada migawki jest włączona, zostanie wyświetlony Last transfer error komunikat. Aby wyłączyć blokowanie migawek, zobacz dokumentację ONTAP.
  • Upewnij się, że topologia sieci jest obsługiwana dla usługi Azure NetApp Files. Upewnij się, że nawiązaliśmy łączność z magazynu lokalnego do usługi Azure NetApp Files.
  • Przestrzeń adresowa delegowanej podsieci do hostowania woluminów usługi Azure NetApp Files musi mieć co najmniej siedem bezpłatnych adresów IP: sześć dla komunikacji równorzędnej klastra i jeden dla dostępu do danych do woluminów migracji.
  • Przestrzeń adresowa delegowanej podsieci powinna mieć odpowiedni rozmiar, aby pomieścić więcej interfejsów sieciowych usługi Azure NetApp Files. Zapoznaj się z wytycznymi dotyczącymi planowania sieci usługi Azure NetApp Files , aby upewnić się, że spełniasz wymagania dotyczące rozmiaru delegowanej podsieci.
  • W przypadku asystenta migracji woluminy usługi Azure NetApp Files muszą korzystać z funkcji sieci w warstwie Standardowa. Aby uzyskać więcej informacji na temat ustawiania funkcji sieciowych, zobacz Konfigurowanie funkcji sieciowych.
  • Po zgłoszeniu żądania komunikacji równorzędnej, musi ono zostać zaakceptowane w ciągu 60 minut. Żądania komunikacji równorzędnej wygasają, jeśli nie zostaną zaakceptowane w ciągu 60 minut.
  • Przed migracją woluminów przeznaczonych dla innej subskrypcji należy ukończyć migracje z jednego klastra źródłowego przy użyciu jednej subskrypcji platformy Azure. Komunikacja równorzędna klastra kończy się niepowodzeniem w przypadku korzystania z drugiej subskrypcji platformy Azure i tych samych klastrów zewnętrznych.
  • Przed zainicjowaniem nowego żądania komunikacji równorzędnej klastra należy upewnić się, że wcześniejsze żądania komunikacji równorzędnej klastra są usunięte i nie są wyświetlane w klastrze źródłowym.
  • Jeśli używasz kontroli dostępu opartej na rolach platformy Azure do oddzielenia roli zarządzania magazynem usługi Azure NetApp Files z zamiarem oddzielenia zadań zarządzania woluminami, w których woluminy znajdują się w tym samym zestawie równorzędnym sieci, należy pamiętać, że zewnętrznie połączone systemy ONTAP równorzędne z tym zestawem równorzędnym nie są zgodne z tymi rolami zdefiniowanymi przez platformę Azure. Administrator magazynu zewnętrznego może mieć ograniczony wgląd we wszystkie woluminy w zestawie równorzędnym, pokazując szczegóły metadanych na poziomie magazynu.
  • Podczas tworzenia każdego woluminu migracji algorytm umieszczania woluminów usługi Azure NetApp Files próbuje ponownie użyć tego samego systemu magazynu usługi Azure NetApp Files co wszystkie wcześniej utworzone woluminy w subskrypcji, aby zmniejszyć liczbę kart interfejsu sieciowego lub adresów IP używanych w podsieci delegowanej. Jeśli nie jest to możliwe, są używane dodatkowe siedem kart sieciowych.
  • Upewnij się, że nie ma zewnętrznych woluminów FlexGroup, ponieważ nie można ich migrować do dużych woluminów usługi Azure NetApp Files.
  • Gdy migracja jest w toku, nie włączaj funkcji, takich jak kopia zapasowa. Włącz funkcje tylko po zakończeniu migracji.

Wskazówka

Aby uzyskać pomoc w tworzeniu woluminu migracji i konfiguracji klastrów równorzędnych dla asystenta migracji, zobacz przykładowy skrypt przepływu pracy asystenta migracji w PowerShell.

Rejestrowanie funkcji

Należy zarejestrować tę funkcję przed jej użyciem na potrzeby asystenta migracji po raz pierwszy. Po rejestracji funkcja jest włączona i działa w tle.

  1. Zarejestruj funkcję:

    Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMigrationAssistant

  2. Sprawdź stan rejestracji funkcji:

    Uwaga / Notatka

    Stan RegistrationState może być w Registering stanie do 60 minut przed zmianą naRegistered. Poczekaj, aż status zmieni się na Zarejestrowany, zanim kontynuujesz.

    Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMigrationAssistant

Możesz również użyć poleceń Azure CLIaz feature register do zarejestrowania funkcji oraz az feature show wyświetlenia stanu rejestracji.

Zanim rozpoczniesz

Należy utworzyć zasoby usługi ExpressRoute lub sieci VPN, aby zapewnić łączność sieciową z zewnętrznego klastra NetApp ONTAP do docelowego klastra usługi Azure NetApp Files. Istnieje wiele sposobów zapewnienia łączności sieciowej. Łączność obejmuje ten zestaw reguł zapory, które są wszystkie dwukierunkowe:

  • ICMP
  • TCP 11104
  • TCP 11105
  • HTTPS

Łączność sieciowa musi być włączona dla wszystkich plików LIF międzyklastrowych (IC) w klastrze źródłowym do wszystkich plików LIF IC w punkcie końcowym usługi Azure NetApp Files.

Uwaga / Notatka

Asystent migracji kopiuje całą zawartość woluminu, w tym katalogi, pliki, metadane pliku (na przykład właściciel, data utworzenia, data modyfikacji) i istniejące migawki. Odpowiadasz za upewnienie się, że wolumin docelowy usługi Azure NetApp Files jest skonfigurowany przy użyciu protokołu LDAP lub usługi Active Directory.

Migrowanie woluminów

  1. Uwierzytelnianie za pomocą usługi Azure Active Directory w celu pobrania tokenu OAuth. Ten token jest używany do kolejnych wywołań interfejsu API.

  2. Utwórz żądanie interfejsu API migracji, aby utworzyć woluminy usługi Azure NetApp Files dla każdego woluminu lokalnego, który zamierzasz migrować.

    Ważne

    Upewnij się, że rozmiar i inne właściwości woluminu na woluminach docelowych są zgodne ze źródłem.

    Należy utworzyć wolumin usługi Azure NetApp Files z 20% lub większą liczbą przydziałów niż wolumin źródłowy. Woluminy usługi Azure NetApp Files używają logicznej wielkości pojemności. Wolumin źródłowy może być mniejszy z powodu deduplikacji i kompresji. Aby uzyskać poprawny rozmiar woluminu usługi Azure NetApp Files, użyj przestrzeni logicznej zgłaszanej przez wolumin, który migrujesz. Po migracji można zmniejszyć usługę Azure NetApp Files, aby zapobiec nadmiernej aprowizacji.

    Wartości "ścieżka zdalna" to nazwy hosta, serwera i woluminu magazynu lokalnego.

    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-07-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"
   }
}

  3. Wydaj żądanie interfejsu API komunikacji równorzędnej klastra dla każdego docelowego woluminu migracji usługi Azure NetApp Files do klastra lokalnego. Powtórz ten krok dla każdego woluminu migracji. Każde wywołanie musi zawierać listę międzyklasowych plików LIFs klastra lokalnego. Równorzędne adresy IP muszą być zgodne z siecią lokalną.

    Uwaga / Notatka

    Peering klastrów obsługuje tylko jedną aktywną subskrypcję między daną parą klastra źródłowego i docelowego. Jeśli zostanie utworzona druga subskrypcja dla tej samej pary klastra, proces peeringu zostanie przerwany. W tej samej strefie można migrować tylko jedną aktywną subskrypcję; jednak migracje w różnych strefach są obsługiwane i zostaną ukończone pomyślnie.

    Uwaga / Notatka

    Każdy węzeł w systemie ONTAP wymaga IC LIF. Każdy IC LIF musi być wymieniony tutaj.

        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-07-01

    Body: {
       "PeerAddresses":[
          "<LIF address>",
          "<LIF address>", 
          "<LIF address>",
          "<LIF address>"
       ]
    }

  4. Wyświetl nagłówek wyniku. Azure-AsyncOperation Skopiuj identyfikator.

  5. W systemie ONTAP lub Cloud Volumes ONTAP zaakceptuj żądanie komunikacji równorzędnej klastra z usługi Azure NetApp Files, wysyłając żądanie GET przy użyciu identyfikatora Azure-AsyncOperation.

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

    Uwaga / Notatka

    Ta operacja może zająć trochę czasu. Sprawdź stan żądania. Po przeczytaniu tego stanu zostanie wyświetlony komunikat "Powodzenie". Jeśli polecenie Azure-AsyncOperation nie odpowiada pomyślnie po godzinie lub kończy się niepowodzeniem z powodu błędu, uruchom peerExternalCluster polecenie ponownie. Przed kontynuowaniem upewnij się, że konfiguracja sieci między zewnętrznym systemem ONTAP lub woluminami w chmurze i podsieci delegowanej usługi Azure NetApp Files działa.

    {
    "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>"
    }
}

  6. Po otrzymaniu stanu powodzenia skopiuj i wklej peerAcceptCommand ciąg w wierszu polecenia dla woluminów lokalnych, a następnie ciąg hasła.

    Uwaga / Notatka

    peerAcceptCommand Jeśli ciąg w treści odpowiedzi jest pusty, komunikacja równorzędna jest już ustanowiona. Pomiń ten krok dla odpowiedniego woluminu migracji.

  7. Wystawianie żądania interfejsu authorizeExternalReplication API dla woluminów migracji. Powtórz to żądanie dla każdego woluminu migracji.

    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-07-01

  8. Zaakceptuj żądanie komunikacji równorzędnej maszyny wirtualnej magazynu (SVM) z usługi Azure NetApp Files, wysyłając żądanie GET przy użyciu identyfikatora Azure-AsyncOperation w kroku 4.

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

    Odpowiedź wygląda następująco:

    {
    "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",
    }
}

    Zezwalaj na ukończenie transferu danych według planu bazowego. Stan replikacji można monitorować przy użyciu witryny Azure Portal lub interfejsu API REST.

  9. Po otrzymaniu odpowiedzi skopiuj polecenie interfejsu wiersza polecenia z svmPeeringCommand do interfejsu wiersza polecenia ONTAP.

  10. Po zakończeniu transferów linii bazowej wybierz czas, aby przejąć woluminy lokalne w tryb offline, aby zapobiec nowym zapisom danych.

  11. Jeśli po przeniesieniu linii bazowej wprowadzono zmiany, wyślij żądanie "Przeprowadź transfer replikacji", aby przechwycić wszelkie dane przyrostowe zapisane po zakończeniu transferu bazowego. Powtórz tę operację dla każdego woluminu migracji.

        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=2025-07-01

  12. Przerwij relację replikacji. Aby przerwać replikację w portalu, przejdź do menu Replikacja każdego woluminu, a następnie wybierz pozycję Przerwij komunikację równorzędną. Możesz też przesłać żądanie interfejsu API:

    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-07-01

    Uwaga / Notatka

    Po przerwaniu relacji replikacji nie uruchamiaj żadnych snapmirror poleceń (takich jak snapmirror delete lub snapmirror release); te polecenia renderują woluminy usługi Azure NetApp Files bezużyteczne.

  13. Usuń relację replikacji migracji. Jeśli usunięta replikacja jest ostatnią migracją skojarzona z subskrypcją, skojarzony element równorzędny klastra i międzyklasowe elementy LIF zostaną usunięte.

    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-07-01

    Finalizowanie replikacji powoduje usunięcie wszystkich informacji dotyczących komunikacji równorzędnej w usłudze Azure NetApp Files. Ręcznie upewnij się, że wszystkie dane replikacji są usuwane w klastrze ONTAP. Jeśli jakiekolwiek informacje dotyczące komunikacji równorzędnej pozostają, uruchom cluster peer delete polecenie .

Więcej informacji

  • Last updated on