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 2022.3.

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

You can only perform a pre-flight check on Server instances using a 64-character Controller Token.

  • If your Server is on version 2021.3 or earlier, you need to first upgrade to version 2022.1 before proceeding with the next steps.

  • Check the length of your Controller Token in Alteryx System Settings > Controller > General > Token > View.

    If your token is 40 characters long, select Regenerate to create a new token. Then select OK to restart the AlteryxService and create the new 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 per 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.