Skip to main content

Strumento Preparazione alla migrazione

Lo strumento Preparazione alla migrazione per Server è un'utilità che consente di eseguire la pre migrazione di un database di flussi di lavoro e app garantendo un'implementazione più rapida del nuovo standard AES256.

Lo strumento Preparazione alla migrazione è opzionale e un'utilità con riga di comando separata. È necessario eseguirlo una sola volta prima dell'aggiornamento da Server 2022.1 (o versioni precedenti) a 2022.3.x o versioni successive.

Importante

  • Se esegui l'aggiornamento dalla versione 2022.1 o precedente, esegui lo strumento Preparazione alla migrazione prima di eseguire l'aggiornamento alla versione 2022.3+.

  • Se esegui l'aggiornamento dalla versione 2022.3+, il database è già stato migrato tramite crittografia e non devi eseguire lo strumento Preparazione alla migrazione.

Nota

Perché abbiamo creato questo strumento?

Server sta aggiornando lo standard di crittografia in AES256 per i dati inattivi. Tutti i dati esistenti archiviati con crittografia devono migrare dal metodo di crittografia corrente a quello nuovo. Alcuni di questi dati possono essere migrati prima dell'aggiornamento alla versione 2022.3 mentre Server è in produzione.

I dati che richiedono più tempo per la migrazione sono le app e i flussi di lavoro archiviati in Server. Questi dati possono essere migrati in anticipo per risparmiare tempo durante l'aggiornamento a Server 2022.3.

Alteryx ha creato lo strumento Preparazione alla migrazione come ausilio per la migrazione di questi dati prima dell'aggiornamento.

Quando utilizzare lo strumento Preparazione alla migrazione

Ti consigliamo di utilizzare lo strumento Preparazione alla migrazione nei seguenti casi:

  • Se la versione di Server che stai aggiornando è un sistema di produzione o un sistema di sviluppo che non può rimanere inattivo per più di qualche ora

  • Se hai più di alcune centinaia di flussi di lavoro

  • Se esegui MongoDB Atlas o MongoDB gestito dall'utente.

Anche se questi casi non si applicano alla tua situazione, per garantire il successo dell'operazione è consigliabile eseguire lo strumento Preparazione alla migrazione prima di tentare un aggiornamento.

Inoltre, è necessario considerare anche le dimensioni di db.AS_App_Chunks.dataSize() e AS_PackageDefinitions. Non sono disponibili suggerimenti sulla dimensione del database consigliata per l'esecuzione dello strumento Preparazione alla migrazione in modalità di preparazione.

Se hai pochi flussi di lavoro o non ti interessa se l'aggiornamento di Server richiede alcune ore o giorni, puoi evitare di utilizzare lo strumento Preparazione alla migrazione e usare il programma di installazione standard di Server per l'aggiornamento alla versione 2022.3. I tempi di inattività saranno più lunghi del solito, poiché la migrazione della crittografia sarà parte dell'aggiornamento.

Nota

Se scegli di non eseguire lo strumento Preparazione alla migrazione prima dell'aggiornamento, lo strumento verrà installato ed eseguito nell'ambito dell'aggiornamento alla versione 2024.1.

Controllo preliminare

Per valutare eventuali problemi che potresti dover risolvere prima di eseguire l'aggiornamento alla versione 2022.3 o successiva, esegui un controllo preliminare come parte dello strumento Preparazione alla migrazione.

Importante

Puoi eseguire un controllo preliminare solo sulle istanze di Server utilizzando un token del controller a 64 caratteri.

  • Se utilizzi la versione 2021.3 o precedente di Server, devi eseguire l'aggiornamento alla versione 2022.1 per procedere con i passaggi successivi.

  • Verifica la lunghezza del token del controller in Impostazioni di sistema Alteryx > Controller > Generale > Token > Visualizza.

    Se il token è composto da 40 caratteri, seleziona Rigenera per crearne uno nuovo. Successivamente, seleziona OK per riavviare AlteryxService e creare il nuovo token.

Durante il processo di premigrazione o di migrazione completa, potrai visualizzare log degli errori che ti permetteranno di risolvere i problemi senza chiedere aiuto. Le azioni suggerite ti consentiranno di completare correttamente la migrazione nonostante eventuali errori.

Sono state aggiunte 3 nuove opzioni di esecuzione durante l'esecuzione dello strumento Preparazione alla migrazione:

  • Opzione predefinita: esecuzione contemporanea della premigrazione e del controllo premigrazione (-p)

  • Esegui solo la premigrazione (app) (--appsonly)

  • Esegui solo la fase di convalida delle credenziali (--credonly)

Durante l'esecuzione dello strumento Preparazione alla migrazione, è necessario fornire il token del controller (-t) e il nome host/l'indirizzo IP (-i) del controller. Ciò significa anche che ora puoi eseguire lo strumento Preparazione alla migrazione su una configurazione multinodo fornendo il nome host/l'indirizzo IP del controller e il token del controller.

Tieni presente che non è possibile eseguire contemporaneamente 2 istanze dello strumento Preparazione alla migrazione per lo stesso controller.