Condividi tramite

Eseguire la migrazione di volumi ad Azure NetApp Files

Con l'Assistente migrazione di Azure NetApp Files, è possibile eseguire il peering e la migrazione di volumi da ONTAP locale o volumi cloud ONTAP ad Azure NetApp Files. La funzionalità è attualmente disponibile solo con l'API REST.

Requisiti

  • In ONTAP o nei volumi cloud ONTAP è necessario eseguire ONTAP 9.10.0 o versione successiva.
  • L'entitlement di licenza snapMirror deve essere ottenuto e applicato al cluster ONTAP locale o ai volumi cloud ONTAP. Collaborare con il team dell'account per coinvolgere uno specialista della tecnologia di Azure per applicare la licenza al cluster di archiviazione locale.
  • Il blocco dello snapshot deve essere disattivato per i volumi nel cluster di origine. Se il blocco dello snapshot è abilitato, si riceve un oggetto Last transfer error. Per disabilitare il blocco degli snapshot, vedere la documentazione di ONTAP.
  • Verificare che la topologia di rete sia supportata per Azure NetApp Files. Assicurarsi di aver stabilito la connettività dall'archiviazione locale ad Azure NetApp Files.
  • Lo spazio indirizzi della subnet delegato per l'hosting dei volumi di Azure NetApp Files deve avere almeno sette indirizzi IP gratuiti: sei per il peering del cluster e uno per l'accesso ai dati ai volumi di migrazione.
  • Lo spazio indirizzi della subnet delegata deve essere ridimensionato in modo appropriato per supportare più interfacce di rete di Azure NetApp Files. Vedere Linee guida per la pianificazione della rete di Azure NetApp Files per assicurarsi di soddisfare i requisiti per il dimensionamento delle subnet delegate.
  • Con Migration Assistant, i volumi di Azure NetApp Files devono usare funzionalità di rete Standard. Per altre informazioni sull'impostazione delle funzionalità di rete, vedere Configurare le funzionalità di rete.
  • Dopo aver emesso la richiesta di peering, la richiesta deve essere accettata entro 60 minuti dall'esecuzione della richiesta. Le richieste peer scadono se non sono accettate entro 60 minuti.
  • È necessario completare le migrazioni da un singolo cluster di origine usando una sottoscrizione di Azure prima di eseguire la migrazione dei volumi destinati a un'altra sottoscrizione. Il peering del cluster ha esito negativo quando si usa una seconda sottoscrizione di Azure e gli stessi cluster di origine esterni.
  • Se si usa il controllo degli accessi in base al ruolo di Azure per separare il ruolo di gestione dell'archiviazione di Azure NetApp Files con l'intenzione di separare le attività di gestione dei volumi in cui risiedono i volumi nello stesso set di pari livello di rete, tenere presente che i sistemi ONTAP connessi esternamente a tale set di pari livello non rispettano questi ruoli definiti da Azure. L'amministratore di archiviazione esterno potrebbe avere visibilità limitata a tutti i volumi nel set di pari livello che mostra i dettagli dei metadati a livello di archiviazione.
  • Quando si crea ogni volume di migrazione, l'algoritmo di posizionamento del volume di Azure NetApp Files tenta di riutilizzare lo stesso sistema di archiviazione di Azure NetApp Files creato in precedenza nella sottoscrizione per ridurre il numero di schede di interfaccia di rete (NIC) o IP utilizzati nella subnet delegata. Se non è possibile, vengono utilizzate altre sette schede di interfaccia di rete.
  • È necessario assicurarsi che non siano presenti volumi FlexGroup esterni perché non possono essere migrati a volumi di grandi dimensioni di Azure NetApp Files.
  • Quando la migrazione è in corso, non abilitare funzionalità come il backup. Abilitare le funzionalità solo dopo il completamento della migrazione.

Suggerimento

Per informazioni sulla creazione di un volume di migrazione e di cluster di peering per Migration Assistant, vedere lo script di esempio del flusso di lavoro di PowerShell Migration Assistant.

Registrare la funzionalità

È necessario registrare la funzionalità prima di usarla per l'Assistente migrazione per la prima volta. Dopo la registrazione, la funzionalità è abilitata e funziona in background.

  1. Registrare la funzionalità :

    Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMigrationAssistant

  2. Verificare lo stato della registrazione della funzionalità:

    Annotazioni

    RegistrationState può trovarsi nello Registering stato per un massimo di 60 minuti prima di passare aRegistered . Attendere che lo stato sia Registrato prima di continuare.

    Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMigrationAssistant

È anche possibile usare i comandi CLI di Azureaz feature register e az feature show per registrare la funzionalità e visualizzare lo stato di registrazione.

Prima di iniziare

È necessario creare risorse ExpressRoute o VPN per garantire la connettività di rete dal cluster NetApp ONTAP esterno al cluster Azure NetApp Files di destinazione. Esistono diversi modi per garantire la connettività di rete. La connettività include questo set di regole del firewall (bidirezionale per tutti):

  • ICMP
  • TCP 11104
  • TCP 11105
  • HTTPS

La connettività di rete deve essere attiva per tutte le LIF intercluster (IC) nel cluster di origine a tutte le LIBRERIe ICF nell'endpoint di Azure NetApp Files.

Annotazioni

Migration Assistant copia tutto il contenuto del volume, inclusi directory, file, metadati di file (ad esempio proprietario, data di creazione, data di modifica) e snapshot esistenti. L'utente è responsabile di assicurarsi che il volume di destinazione di Azure NetApp Files sia configurato con LDAP o Active Directory.

Eseguire la migrazione dei volumi

  1. Eseguire l'autenticazione con Azure Active Directory per recuperare un token OAuth. Questo token viene usato per le chiamate API successive.

  2. Creare una richiesta api di migrazione per creare volumi di Azure NetApp Files per ogni volume locale di cui si intende eseguire la migrazione.

    Importante

    Verificare che le dimensioni e altre proprietà del volume nei volumi di destinazione corrispondano all'origine.

    È consigliabile creare il volume di Azure NetApp Files con 20% o più quote rispetto al volume di origine. I volumi di Azure NetApp Files usano dimensioni di capacità non elaborate. Il volume di origine potrebbe essere inferiore a causa della deduplicazione e della compressione. È possibile compattare Azure NetApp Files in modo non selettivo dopo la migrazione per evitare il over-provisioning.

    I valori "percorso remoto" sono i nomi host, server e volume dell'archiviazione locale.

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

  3. Eseguire una richiesta API di peering del cluster per ognuno dei volumi di migrazione di Azure NetApp Files di destinazione al cluster locale. Ripetere questo passaggio per ogni volume di migrazione. Ogni chiamata deve fornire un elenco delle GIF cluster locali. Gli indirizzi IP peer devono corrispondere alla rete locale.

    Annotazioni

    Ogni nodo del sistema ONTAP necessita di un IC LIF. Ogni IC LIF deve essere elencato qui.

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

  4. Visualizzare l'intestazione del risultato. Copiare l'ID Azure-AsyncOperation .

  5. Nel sistema ONTAP o Volumi cloud ONTAP accettare la richiesta peer del cluster da Azure NetApp Files inviando una richiesta GET usando 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...

    Annotazioni

    Questa operazione può richiedere tempo. Controllare lo stato della richiesta. Quando lo stato è completato, viene visualizzato "Succeeded". Se l'oggetto Azure-AsyncOperation non risponde correttamente dopo un'ora o ha esito negativo con un errore, eseguire di nuovo il peerExternalCluster comando. Verificare che la configurazione di rete tra il sistema ONTAP esterno o i volumi cloud ONTAP e la subnet delegata di Azure NetApp Files funzioni prima di continuare.

    {
    "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. Dopo aver ricevuto lo stato completato, copiare e incollare la peerAcceptCommand stringa nella riga di comando per i volumi locali seguiti dalla stringa passphrase.

    Annotazioni

    Se la peerAcceptCommand stringa nel corpo della risposta è vuota, il peering è già stato stabilito. Ignorare questo passaggio per il volume di migrazione corrispondente.

  7. Eseguire una authorizeExternalReplication richiesta API per i volumi di migrazione. Ripetere questa richiesta per ogni volume di migrazione.

    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

  8. Accettare la richiesta peer della macchina virtuale di archiviazione (SVM) da Azure NetApp Files inviando una richiesta GET usando l'ID Azure-AsyncOperation nel passaggio 4.

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

    Risposta di esempio:

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

    Consentire il completamento del trasferimento dei dati di base. È possibile monitorare lo stato della replica usando il portale di Azure o l'API REST.

  9. Dopo aver ricevuto la risposta, copiare il comando dell'interfaccia della riga di comando da svmPeeringCommand nell'interfaccia della riga di comando di ONTAP.

  10. Al termine dei trasferimenti di base, selezionare un tempo per portare offline i volumi locali per evitare nuove scritture di dati.

  11. Se sono state apportate modifiche ai dati dopo il trasferimento di base, inviare una richiesta "Esegui trasferimento replica" per acquisire i dati incrementali scritti dopo il completamento del trasferimento di base. Ripetere questa operazione per ogni volume di migrazione.

        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

  12. Interrompere la relazione di replica. Per interrompere la replica nel portale, passare al menu Replica di ogni volume e quindi selezionare Interrompi peering. In alternativa, è possibile inviare una richiesta 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-06-01

    Annotazioni

    Dopo aver interrotto la relazione di replica, non eseguire comandi snapmirror ( ad esempio snapmirror delete o snapmirror release). Questi comandi rendono inutilizzabili i volumi di Azure NetApp Files.

  13. Eliminare la relazione di replica della migrazione. Se la replica eliminata è l'ultima migrazione associata alla sottoscrizione, vengono eliminate le FUNZIONI peer e intercluster del cluster associate.

    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

    La finalizzazione della replica rimuove tutte le informazioni sul peering in Azure NetApp Files. Verificare manualmente che tutti i dati di replica vengano rimossi nel cluster ONTAP. Se rimangono informazioni sul peering, eseguire il cluster peer delete comando .

Maggiori informazioni