Prerequisiti

  • Versione di NSX 4.0.1 o successiva.
  • Versione del riquadro VMware NSX-T 4.1.2.x o successiva.
  • La rete NSX viene utilizzata solo dalle basi TAS.
  • Tutte le basi distribuite nello stesso cluster NSX Manager devono essere migrate nella stessa finestra di manutenzione.
  • Durante la finestra di manutenzione, NCP deve essere sospeso in tutte le basi (in esecuzione in modalità Manager o in modalità Criterio) distribuite nello stesso cluster NSX Manager. Questo implica che tutte le operazioni di creazione, aggiornamento ed eliminazione di TAS, come la creazione di attività o app per svuotare gli eventi, non funzioneranno durante questo periodo

Passaggi della migrazione in breve

Il riquadro NSX-T fornisce un'attività successiva alla distribuzione denominata "migrate-mp2p" per eseguire la migrazione delle basi TAS in Criterio NSX. L'attività viene eseguita in una macchina virtuale dedicata nella distribuzione creata per il riquadro VMware NSX-T. Eseguire i passaggi seguenti per eseguire la migrazione delle basi TAS alla modalità Criterio NSX:
  1. Se necessario, eseguire il refactoring delle sezioni DFW create manualmente. Vedere Gestione delle sezioni DFW create dall'amministratore di NSX.
  2. Eseguire le operazioni seguenti per tutte le basi (in esecuzione in modalità Manager o in modalità Criterio) che utilizzano gli stessi NSX Manager:
    1. Sospendere NCP nella base. Fare riferimento alla sezione "Come sospendere NCP nella base" per i passaggi dettagliati. Questa operazione dovrebbe essere eseguita in parallelo in tutte le basi
  3. Creare un backup di NSX Manager.
  4. Eseguire le operazioni seguenti per ogni base (in esecuzione solo in modalità Manager) identificata nel passaggio 2, una base alla volta:
    1. Eseguire la migrazione della base utilizzando l'attività migrate-mp2p. Per ulteriori dettagli, fare riferimento alla sezione "Come eseguire la migrazione della base TAS a Criterio NSX".
  5. Eseguire le operazioni seguenti per ogni base (in esecuzione in modalità Manager o in modalità Criterio) identificata nel passaggio 2:
    1. Avviare NCP in modalità Criterio nella base. Fare riferimento alla sezione "Come avviare le basi TAS in modalità Criterio NSX" per i passaggi dettagliati. Questa operazione dovrebbe essere eseguita in parallelo in tutte le basi.

Come sospendere NCP nella base

Il processo NCP viene eseguito nelle macchine virtuali diego_database nella distribuzione "VMware Tanzu Application Service". Poiché modifica lo stato di NSX, deve essere sospeso durante il processo di migrazione. Per lo stesso motivo, è necessario sospendere NCP prima di eseguire un backup di NSX. Eseguire i passaggi seguenti per sospendere NCP nella base. Queste operazioni dovrebbero essere eseguite in parallelo in tutte le basi TAS che condividono gli stessi NSX Manager.
  1. Fare clic sul riquadro VMware NSX-T.Schermata che mostra il riquadro NSX-T
  2. Fare clic sul riquadro di configurazione Migrazione da MP a Criterio. Selezionare il pulsante di opzione Sospendere NCP nella base.. Fare clic su Salva.Schermata che mostra la configurazione della migrazione da MP a CriterioSchermata che mostra la configurazione della migrazione da MP a Criterio
  3. Fare clic su Applica modifiche .Schermata che mostra le modifiche in sospeso

Come eseguire la migrazione della base TAS a Criterio NSX

Tipi di risorse NSX per la migrazione

La migrazione di una base TAS comporta la migrazione di due tipi di risorse NSX che differiscono principalmente in base a chi le ha create. Sono definiti come segue:
  • Risorse NSX condivise: queste risorse NSX vengono create esplicitamente dall'utente manualmente o utilizzando strumenti di automazione come Terraform. Possono essere condivise da più basi TAS o con altri prodotti come TKGi. Le risorse condivise includono le risorse NSX create utilizzando https://docs.vmware.com/it/VMware-Tanzu-Application-Service/2.11/tas-for-vms/vsphere-nsx-t.html#nsx-t-setup, specificate come annotazioni negli oggetti TAS (ad esempio pool di IP SNAT per le app o le organizzazioni) o qualsiasi risorsa NSX creata esplicitamente come le sezioni e le regole DFW utilizzate nella base. È necessario eseguire la migrazione di queste risorse in modo che NCP possa funzionare in modalità Criterio, ma deve essere eseguita dall'utente poiché è sconosciuta a NCP. Di conseguenza, queste risorse NSX devono essere specificate nel riquadro di configurazione Migrazione da MP a Criterio.
  • Risorse NSX create da NCP: queste risorse NSX vengono create da NCP in risposta al carico di lavoro di TAS. Queste risorse vengono dedotte automaticamente durante la migrazione di una base in modo che non debbano essere specificate dall'utente.

Modalità di funzionamento dell'attività migrate-mp2p

L'attività migrate-mp2p può essere eseguita in due modalità:
  1. Per eseguire la migrazione delle risorse NSX condivise e create da NCP. Questa è l'opzione predefinita. Durante il processo di migrazione, le risorse NSX condivise vengono migrate prima della migrazione di qualsiasi risorsa NSX creata da NCP.
  2. Per eseguire la migrazione solo di risorse NSX condivise. Questa operazione è utile nei seguenti casi:
    1. è necessario migrare alcune risorse NSX dopo la migrazione delle risorse NSX create da NCP, oppure
    2. l'utente ha semplicemente dimenticato di specificare alcune risorse NSX condivise al primo tentativo, oppure
    3. l'utente desidera semplicemente acquisire familiarità con il processo di migrazione.

      Il passaggio 3 in "Passaggi di migrazione" di seguito illustra come eseguire l'attività in questa modalità.

Passaggi di migrazione

I passaggi seguenti riepilogano le azioni associate alla migrazione della base in Criterio. Il passaggio 4 deve essere eseguito in una base alla volta.
  1. Individuare e compilare l'ID o il nome visualizzato di tutte le risorse NSX condivise che devono essere migrate in Criterio nel riquadro di configurazione Migrazione da MP a Criterio. Di seguito viene mostrato un esempio.Schermata che mostra la configurazione della Migrazione da MP a Criterio
  2. Selezionare il pulsante di opzione Esegui migrazione a Criterio NSX. Fare clic su Salva.Schermata che mostra il pulsante Esegui migrazione a Criterio NSX
  3. (Facoltativo) Se si desidera eseguire solo la migrazione delle risorse NSX condivise, abilitare la casella di controllo Eseguire la migrazione solo delle risorse NSX create manualmente. Se questa opzione è abilitata, le risorse NSX create da NCP per questa base non vengono migrate.
  4. Fare clic su Dashboard di installazione e poi su Rivedi modifiche in sospeso. Abilitare l'attività Esegui migrazione MP2P. Fare clic su Applica modifiche .Schermata che mostra le modifiche in sospeso
  5. Se la migrazione non riesce e i registri delle attività dichiarano che è necessario riprovare, ripetere il processo dal passaggio 1. Se è necessario utilizzare il backup di NSX, passare alla sezione "Come utilizzare il backup di NSX per ripristinare le basi TAS". In caso contrario, la migrazione viene eseguita correttamente. Lo stato di migrazione può essere dedotto con tag nel livello 0 della base. Per ulteriori dettagli, fare riferimento alla sezione "Come verificare lo stato di migrazione di una base".

Come verificare lo stato di migrazione di una fondazione

Lo stato della migrazione di una base può essere letto da un tag con ambito "ncp/mp2p_status_<foundation name>" nel livello 0 della base in NSX, se il livello 0 è in grado di aggiungere questo tag. Questo tag viene sempre aggiunto al dominio del Criterio NSX creato per la base. L'ID del dominio è uguale al nome della base e questo dominio non è visibile nell'interfaccia utente di NSX. Non vi è alcun impatto sul piano dati in alcuno degli stati. Lo stato può essere uno dei seguenti:
  1. "in_progress": indica che la migrazione è in corso in questa base.
  2. "success": indica che la base è stata migrata in Criterio e che NCP può essere avviato in modalità Criterio
  3. "rollback_succeeded": indica che la migrazione alla modalità Criterio non è riuscita, ma è stato eseguito il rollback di tutte le risorse NSX migrate come parte di questa base, ovvero sono state riportate allo stato originale che avevano in modalità Manager prima della migrazione. I passaggi successivi consigliati sono:
    1. Eseguire nuovamente la commissione migrate-mp2p. Potrebbe riuscire se non riesce a causa di un motivo temporaneo. Si consiglia di riprovare in caso di errore almeno 3 volte con un intervallo di 15 minuti tra ogni tentativo prima di passare al passaggio 3b.
    2. Riavviare NCP in modalità Manager in questa base e mantenerlo in esecuzione per almeno 30 minuti per consentire a NCP di riconciliare lo stato di TAS con il back-end di NSX prima di riprendere le operazioni di TAS. Questa operazione potrebbe causare alcuni errori temporanei nelle operazioni TAS. Se possibile, tentare nuovamente di eseguire la migrazione di questa base. Si consiglia di eseguire questa operazione almeno 3 volte prima di passare al passaggio 3c.
    3. Ripristinare le basi TAS e gli NSX Manager utilizzando il backup creato prima della migrazione di qualsiasi base. Per ulteriori dettagli, fare riferimento alla sezione "Come utilizzare il backup di NSX per ripristinare le basi TAS". Contattare l'assistenza VMware.
  4. "rollback_failed": indica che la migrazione a Criterio non è riuscita e che non è stato possibile eseguire il rollback di tutte le risorse NSX migrate come parte di questa base. Se in questo caso NCP viene eseguito in modalità Manager o Criterio, non viene avviato correttamente. Questa condizione è probabilmente dovuta a un errore imprevisto in NSX Manager. I passaggi successivi consigliati sono
    1. Eseguire nuovamente la commissione migrate-mp2p. Tenterà di eseguire nuovamente il rollback delle risorse NSX. Questa operazione può essere eseguita più volte. Questa operazione deve essere eseguita finché il rollback non può essere completato correttamente, condizione indicata dai registri delle attività e dai tag nel livello 0 della base. Si consiglia di riprovare in caso di errore almeno 5 volte con un intervallo di 15 minuti tra ogni tentativo prima di passare al passaggio 4b.
    2. Ripristinare le basi TAS e gli NSX Manager utilizzando il backup creato prima della migrazione di qualsiasi base. Per ulteriori dettagli, fare riferimento alla sezione "Come utilizzare il backup di NSX per ripristinare le basi TAS". Contattare l'assistenza VMware.
  5. "commit_failed": indica che la migrazione a Criterio non è riuscita poiché dopo una corretta migrazione delle risorse NSX in modalità Criterio, si è verificato un errore durante l'aggiornamento di queste risorse per l'utilizzo di NCP (vedere la sezione "Fase 4" in Migrazione dei cluster NCP e delle basi TAS alla modalità Criterio). In questo caso, è consigliabile eseguire nuovamente l'attività migrate-mp2p. NCP non deve essere in esecuzione in modalità Manager o Criterio in questo stato. Questa operazione può essere eseguita più volte. Questa operazione deve essere eseguita finché la migrazione non viene completata correttamente, condizione indicata dai registri delle attività e dai tag nel livello 0 della base. Si consiglia di riprovare in caso di errore almeno 5 volte con un intervallo di tempo di 15 minuti tra ogni tentativo e contattare l'assistenza VMware se il problema persiste.
  6. "payload_creation_failed": indica che l'attività di migrazione non è riuscita a creare il payload necessario per eseguire la migrazione delle risorse NSX. In questo caso, è consigliabile eseguire nuovamente l'attività. Se il problema persiste,
    1. Riavviare NCP in modalità Manager in questa base, mantenerlo in esecuzione per almeno 30 minuti per consentire a NCP di riconciliare lo stato di TAS con il back-end di NSX prima di riprendere le operazioni di TAS, quindi riprovare la migrazione di questa base quando è possibile. Si consiglia di eseguire questa operazione almeno 3 volte prima di passare al passaggio 6b.
    2. Ripristinare le basi TAS e gli NSX Manager utilizzando il backup creato prima della migrazione di qualsiasi base. Per ulteriori dettagli, fare riferimento alla sezione "Come utilizzare il backup di NSX per ripristinare le basi TAS". Contattare l'assistenza VMware.

Come avviare le basi TAS in modalità Criterio NSX

Eseguire i passaggi seguenti per eseguire una base TAS in modalità Criterio nell'interfaccia utente di Opsmanager
  1. Passare al riquadro di configurazione NCP nel riquadro VMware NSX-T. Selezionare la casella di controllo Abilita API dei criteri di NSX-T. Fare clic su Salva.Schermata che mostra la configurazione di NCP
  2. Passare al riquadro di configurazione Migrazione da MP a Criterio nel riquadro VMware NSX-T. Selezionare il pulsante di opzione Esegui NCP. Fare clic su Salva.Schermata che mostra la configurazione della Migrazione da MP a Criterio
  3. Fare clic su Dashboard di installazione e poi su Rivedi modifiche in sospeso. Fare clic su Applica modifiche .

Come utilizzare il backup di NSX per ripristinare le basi TAS

Nelle sezioni seguenti vengono descritti i passaggi per ripristinare le basi TAS in modalità Manager o Criterio dopo il ripristino di tutti i nodi NSX Manager utilizzando i rispettivi backup di NSX.

Passaggi per ripristinare la modalità Manager per le basi TAS

Questi passaggi devono essere eseguiti per ripristinare le basi che sono state migrate a Criterio correttamente o non correttamente e che condividono gli stessi NSX Manager:
  1. Nell'interfaccia utente di Ops Manager della base,
    1. Passare al riquadro di configurazione NCP nel riquadro VMware NSX-T. Deselezionare la casella di controllo Abilita API dei criteri di NSX-T. Fare clic su Salva.
    2. Passare al riquadro di configurazione Migrazione da MP a Criterio nel riquadro VMware NSX-T. Selezionare il pulsante di opzione Esegui NCP. Fare clic su Salva.
  2. Fare clic su Dashboard di installazione e poi su Rivedi modifiche in sospeso. Fare clic su Applica modifiche . Dopo l'applicazione delle modifiche, la base funzionerà di nuovo in modalità Manager.

Passaggi per ripristinare la modalità Criterio per le basi TAS

Questi passaggi devono essere eseguiti per ripristinare le basi che erano già di proprietà di Criterio (ovvero in cui non è stata eseguita alcuna migrazione) e che condividono gli stessi NSX Manager:
  1. Nell'interfaccia utente di Ops Manager della base,
    1. Passare al riquadro di configurazione Migrazione da MP a Criterio nel riquadro VMware NSX-T. Selezionare il pulsante di opzione Esegui NCP. Fare clic su Salva.
  2. Fare clic su Dashboard di installazione e poi su Rivedi modifiche in sospeso. Fare clic su Applica modifiche . Dopo aver applicato correttamente le modifiche, la base funzionerà di nuovo in modalità Criterio.

Risoluzione dei problemi

Registri della migrazione

Quando una risorsa NSX viene migrata in Criterio, lo script mp2p memorizza nella cache l'ID MP NSX in locale (ovvero nella macchina virtuale). Tutti questi ID costituiscono collettivamente ciò che viene definito record di migrazione. Per ulteriori dettagli, vedere Migrazione dei cluster NCP e delle basi TAS alla modalità Criterio.

I registri e i record della migrazione vengono conservati in un'archiviazione persistente nel percorso /var/vcap/store/migrate-mp2p che, per impostazione predefinita, ha dimensioni 2048 MB. In questo percorso viene creata una nuova directory denominata directory di destinazione, con il nome "mp2p-records-<time in epoch>". Questa directory contiene tutti i registri e i record della migrazione. Questa directory è accessibile nella macchina virtuale "migrate-mp2p" distribuita nella distribuzione di "VMware NSX-T". I registri della migrazione dell'ultima esecuzione dell'attività sono presenti anche nel percorso /var/vcap/sys/log/migrate-mp2p/ in questa macchina virtuale.
  • Se la migrazione viene eseguita correttamente, i record della migrazione sono vuoti.
  • Se la migrazione non riesce, l'attività tenterà un rollback automatico utilizzando i record della migrazione. Se il rollback non riesce, archivia i record della migrazione nella directory di destinazione. Quando l'attività viene eseguita nuovamente, carica i record della migrazione dall'ultima esecuzione e tenta automaticamente di eseguire il rollback delle risorse NSX o di completare la migrazione.

Considerazioni

Quando si esegue la migrazione alla modalità Criterio, è necessario tenere presente quanto segue:
  1. L'ID criterio di tutte le risorse NSX condivise in TAS è uguale al relativo ID MP.
  2. Dopo la migrazione di una base in modalità Criterio, NCP deve essere avviato in modalità Criterio. Non può essere utilizzato in modalità Manager a meno che non venga utilizzato il backup di NSX per ripristinare uno stato delle risorse NSX migrate registrato prima dell'esecuzione della migrazione.
  3. Dopo la migrazione di una base in modalità Criterio e l'avvio di NCP in modalità Criterio, potrebbe non essere più possibile utilizzare il backup di NSX per ripristinare la modalità Manager della base.
  4. I registri della migrazione sono disponibili solo fino a 5 giorni dopo l'avvio di NCP in modalità Criterio. È consigliabile archiviare questi registri in un'archiviazione persistente a lungo termine nel caso in cui si verifichi un problema in un secondo momento.
  5. È possibile che il tag "ncp/mp2p_status_<foundation name>" non possa essere aggiunto al gateway di livello 0 della base dopo la migrazione di una base poiché il livello 0 non dispone di capacità di riserva. In questi casi, un tag esistente della migrazione precedente verrà sostituito con il nuovo tag, se possibile.
  6. Se NCP viene eseguito in modalità Manager dopo la migrazione, non riuscirà a modificare lo stato di alcuna risorsa NSX, perché ora sono di proprietà di Criterio di NSX.
  7. Una volta migrate tutte le basi alla modalità Criterio e solo se non sono presenti altri prodotti in esecuzione in NSX, è consigliabile eseguire la migrazione di tutte le risorse NSX rimanenti in modalità Manager utilizzando l'interfaccia utente di NSX passando a Sistema > Migrazione in uno degli NSX Manager
  8. Se le regole DFW hanno origine e destinazione come ANY, la migrazione di tali sezioni DFW deve essere eseguita al dominio del criterio NSX "predefinito".