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.

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, è consigliabile eseguire Strumento Preparazione migrazione prima di tentare un aggiornamento per garantire il successo dell'operazione.

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.

Operazioni successive

To evaluate any anticipated issues you might need to address prior to upgrading to 2022.3 or later, run the pre-flight check as part of the Migration Prep Tool.

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.

During the pre-migration or full migration process, you will be able to see error logs that allow you to resolve the issues yourselves. This enables you to take the recommended action to ensure the full migration is completed successfully despite any errors.

Esecuzione dello strumento Preparazione alla migrazione

  • Default: Run the pre-migration and pre-migration check simultaneously (-p)

  • Run just the pre-migration (apps) (--appsonly)

  • Run just the credential validation step (--credonly)

While running the Migration Prep Tool, you must provide the controller token (-t) and hostname/IP Address (-i) of the controller. This also means you can now run the Migration Prep Tool on a multi-node setup by providing the controller's hostname/IP address and controller token.

Please note that 2 instances of the Migration Prep Tool tool cannot run simultaneously for the same controller.