Skip to main content

Herramienta de preparación para migración

La herramienta de preparación para migración de Server es una utilidad que permite una migración previa más rápida al nuevo estándar AES256 de una base de datos de flujos de trabajo y aplicaciones.

La herramienta de preparación para migración es opcional y es una utilidad de línea de comandos independiente. Solo necesitas ejecutarla una vez antes de actualizar Server 2022.1 (o versiones anteriores) a 2022.3.x o posterior.

Nota

¿Por qué se creó esta herramienta?

Server está actualizando su criptografía a AES256 para datos en reposo. Todos los datos existentes almacenados criptográficamente deben migrar de su método de cifrado actual al nuevo. Algunos de estos datos se pueden migrar antes de la actualización a 2022.3 mientras tu Server está en producción.

Los datos que más tiempo requieren para migrar son las aplicaciones y los flujos de trabajo almacenados en Server. Estos datos se pueden migrar con antelación para ahorrar tiempo al realizar la actualización a Server 2022.3.

Alteryx creó la herramienta de preparación para migración para ayudarte a migrar estos datos antes de la actualización.

Cuándo utilizar la herramienta Preparación de migración

Se recomienda ejecutar la herramienta Preparación de migración en los siguientes casos:

  • Si la instalación de Server que está actualizando es un sistema de producción o un sistema de desarrollo que no puede estar inactivo durante más de unas horas.

  • Si tienes más de un centenar de flujos de trabajo.

  • Estás ejecutando en MongoDB Atlas o MongoDB administrado por el usuario.

Incluso si estos casos no se aplican a su caso, se recomienda ejecutar herramienta de preparación para migración antes de intentar una actualización para garantizar el éxito.

Además, también podrías considerar el tamaño de db.AS_App_Chunks.dataSize() y AS_PackageDefinitions. No tenemos recomendaciones relacionadas con el tamaño de la base de datos sobre cuándo debes ejecutar la herramienta de preparación para migración en modo de preparación.

Si solo tienes unos pocos flujos de trabajo o no te importa si Server tarda varias horas o días en actualizarse, puedes omitir el uso de la herramienta de preparación para migración y ejecutar el instalador estándar de Server para actualizar a 2022.3. El tiempo de inactividad será más largo de lo habitual, ya que la migración criptográfica formará parte de la actualización.

Nota

Si decides no ejecutar la herramienta de preparación para migración antes de la actualización, la herramienta se instalará y ejecutará como parte de la instalación de la actualización de 2022.3.

¿Y ahora qué?

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.

Ejecutar la herramienta Preparación de migración

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