Eseguire la migrazione di volumi ad Azure NetApp Files

Usando Azure NetApp Files Migration Assistant, è possibile eseguire il peering e la migrazione di volumi da ONTAP locale o volumi cloud ONTAP a Azure NetApp Files.

Requisiti

  • In ONTAP o Cloud Volumes ONTAP deve essere eseguito ONTAP 9.10.0 o versione successiva.
  • Devono essere ottenuti i diritti di licenza per SnapMirror e applicati al cluster ONTAP locale o Cloud Volumes ONTAP. Collaborare con il team dell’account per coinvolgere uno specialista di tecnologia Azure nella procedura di applicazione della licenza al cluster di archiviazione locale.
  • Per i volumi nel cluster di origine deve essere disattivato il blocco dello snapshot. Se il blocco dello snapshot è abilitato, viene visualizzato un Last transfer error messaggio. Per disabilitare il blocco dello snapshot, vedere la documentazione su ONTAP.
  • Verificare che la topologia di rete sia supportata per Azure NetApp Files. Assicurarsi di aver stabilito la connettività dalla risorsa di archiviazione locale ad Azure NetApp Files.
  • Lo spazio indirizzi della subnet delegata per l'hosting dei volumi di Azure NetApp Files deve avere almeno sette indirizzi IP liberi: sei per il peering del cluster e uno per l'accesso dei dati ai volumi di migrazione.
  • Lo spazio indirizzi della subnet delegata deve essere delle dimensioni appropriate per supportare più interfacce di rete di Azure NetApp Files. Vedere Linee guida per la pianificazione della rete per Azure NetApp Files per accertarsi che siano soddisfatti i requisiti relativi alle dimensioni della subnet delegata.
  • 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.
  • Migration Assistant emetterà una richiesta di peering al cluster di archiviazione locale. Le richieste di peering devono essere accettate nel cluster locale entro 60 minuti. Dopo 60 minuti, una richiesta di peering non può più essere accettata e il peering avrà esito negativo. Se ciò accade, sarà necessario ricominciare.
  • È necessario assicurarsi che le richieste di peering cluster precedenti vengano eliminate e non vengano visualizzate nel cluster di origine prima di avviare una nuova richiesta di peering del cluster.
  • È necessario completare le migrazioni da un singolo cluster di origine usando un’unica sottoscrizione di Azure prima di passare alla migrazione di volumi destinati a un’altra sottoscrizione. Il peering dei 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 che risiedono sullo stesso set di elementi di pari livello di rete, tenere presente che i sistemi ONTAP collegati esternamente e di cui è stato eseguito il peering al set di elementi di pari livello non si adeguano ai ruoli definiti da Azure. L'amministratore della risorsa di archiviazione esterna potrebbe non avere una visibilità completa su tutti i volumi del set di elementi di pari livello che mostrano i dettagli dei metadati a livello di archiviazione.
  • Durante la creazione di ogni volume di migrazione, l'algoritmo di posizionamento del volume di Azure NetApp Files tenta di riusare lo stesso sistema di archiviazione Azure NetApp Files dei volumi precedentemente creati nella sottoscrizione, in modo da ridurre il numero di schede di interfaccia di rete o indirizzi IP usati nella subnet delegata. Se non è possibile, vengono usate altre sette schede di interfaccia di rete.
  • L'Assistente per la migrazione esegue la migrazione dei dati del volume, incluse le liste di controllo degli accessi (ACL) a livello di directory e file. Le autorizzazioni a livello di condivisione non vengono migrate e devono essere ricreate manualmente.
  • Se il volume locale ha più condivisioni (ad esempio, una condivisione radice e sottocondivisioni che puntano a sottodirectory), sul volume Azure NetApp Files viene creata solo la condivisione primaria. Per verificare quali condivisioni esistono nei volumi locali, usare il comando vserver:
    • vserver cifs share show
    • vserver cifs share access-control show
  • Non è possibile eseguire la migrazione dei volumi FlexGroup locali ai volumi di grandi dimensioni di Azure NetApp Files. Escludere i volumi FlexGroup dalla migrazione.
  • Mentre è in corso la migrazione, non abilitare funzionalità come il backup. Abilitarle solo dopo il completamento della procedura di migrazione.

Suggerimento

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

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, che sono tutte bidirezionali:

  • ICMP
  • TCP 11104
  • TCP 11105
  • HTTPS

La connettività di rete deve essere disponibile per tutte le interfacce logiche intercluster sul cluster di origine verso tutte le interfacce logiche intercluster sull'endpoint di Azure NetApp Files.

Annotazioni

Migration Assistant copia tutti i contenuti del volume, tra cui directory, file, metadati dei file (ad esempio proprietario, data di creazione, data di modifica) e snapshot esistenti. È responsabilità dell'utente 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 verrà usato per 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à dei volumi di destinazione corrispondano a quelle dei volumi di origine.

    È consigliabile creare il volume di Azure NetApp Files con una quota superiore almeno del 20% rispetto al volume di origine. I volumi di Azure NetApp Files usano la capacità dimensionale logica. Il volume di origine potrebbe essere più piccolo a causa della deduplicazione e della compressione. Per correggere il ridimensionamento del volume di Azure NetApp Files, usare lo spazio logico segnalato dal volume di cui si sta eseguendo la migrazione. Dopo la migrazione, è possibile ridurre le dimensioni di Azure NetApp Files senza comportare interruzioni per evitare un’eccessiva attività di provisioning.

    I valori del “percorso remoto” corrispondono ai nomi dell'host, del server e del volume della risorsa di 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-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. Inviare al cluster locale una richiesta API di peering del cluster per ognuno dei volumi di migrazione di Azure NetApp Files di destinazione. Ripetere questo passaggio per ogni volume di migrazione. Ogni chiamata deve fornire un elenco delle interfacce logiche intercluster dei cluster locali. Gli indirizzi IP di peering devono corrispondere alla rete locale.

    Annotazioni

    Il peering di cluster supporta una sola sottoscrizione attiva tra una determinata coppia di cluster di origine e di destinazione. Se viene creata una seconda sottoscrizione per la stessa coppia di cluster, il processo di peering avrà esito negativo. All'interno della stessa zona è possibile eseguire la migrazione di una sola sottoscrizione attiva alla volta; Tuttavia, le migrazioni tra zone diverse sono supportate e verranno completate correttamente.

    Annotazioni

    Per ogni nodo del sistema ONTAP deve essere disponibile un interfaccia logica intercluster. Ogni interfaccia logica intercluster deve essere elencata 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-07-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 in Cloud Volumes ONTAP accettare la richiesta di peering del cluster da Azure NetApp Files inviando una richiesta GET tramite l’ID di Azure-AsyncOperation.

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

    Annotazioni

    Questa operazione può richiedere alcuni minuti. Controllare lo stato della richiesta. È completo quando lo stato indica “Succeeded” (Riuscito). Se dopo un'ora Azure-AsyncOperation non ha ancora risposto o restituisce un errore, eseguire nuovamente il comando peerExternalCluster. Prima di continuare, verificare che la configurazione di rete tra il sistema ONTAP esterno o Cloud Volumes ONTAP e la subnet delegata di Azure NetApp Files funzioni correttamente.

    {
        "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 ottenuto lo stato di operazione riuscita, copiare e incollare la stringa peerAcceptCommand nella riga di comando relativa ai volumi locali, seguita dalla stringa della passphrase.

    Annotazioni

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

  7. Eseguire una richiesta API authorizeExternalReplication 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-07-01
    
  8. Accettare la richiesta di peering della macchina virtuale di archiviazione (SVM) da Azure NetApp Files inviando una richiesta GET tramite l'ID Azure-AsyncOperation del passaggio 4.

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

    La risposta ha un aspetto simile al seguente:

    {
        "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. Una volta completati i trasferimenti di base, selezionare un'ora in cui mettere offline i volumi locali per impedire nuove scritture di dati.

  11. Se sono state apportate modifiche ai dati dopo il trasferimento dei dati di base, inviare la richiesta “Esegui trasferimento di replica” per acquisire eventuali dati incrementali scritti dopo il trasferimento dei dati 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=2025-07-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-07-01
    

    Annotazioni

    Dopo aver interrotto la relazione di replica, non eseguire alcun comando 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 eliminati anche il peering del cluster e le interfacce logiche intercluster associati.

    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
    

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

Maggiori informazioni