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.

Importante

  • Si vas a actualizar desde 2022.1 o una versión anterior, ejecuta la herramienta de preparación para migración antes de actualizar a 2022.3+.

  • Si vas a actualizar desde 2022.3+, tu base de datos ya ha migrado a Crypto y no necesitas ejecutar la herramienta de preparación para migración.

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 ti, la práctica recomendada es ejecutar la 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 2024.1.

Comprobación previa a la migración

Para evaluar cualquier problema previsto que debas resolver antes de actualizar a la versión 2022.3 o una posterior, ejecuta la comprobación previa a la migración como parte de la herramienta de preparación para migración.

Importante

Solo puedes realizar una comprobación previa a la migración en instancias de Server mediante un token de controlador de 64 caracteres.

  • Si la versión de tu Server es 2021.3 o anterior, primero debes actualizarlo a la versión 2022.1 antes de continuar con los pasos siguientes.

  • Comprueba la longitud de tu token de controlador en Configuración del sistema Alteryx > Controlador > General > Token > Ver.

    Si tu token tiene 40 caracteres de largo, selecciona Volver a generar para crear un nuevo token. A continuación, selecciona Aceptar para reiniciar AlteryxService y crear el nuevo token.

Durante el proceso de migración previa o completa, podrás ver registros de errores que te permitirán resolver los problemas. Esto te permite tomar las acciones recomendadas para garantizar que la migración completa se realice correctamente a pesar de cualquier error que pueda producirse.

Agregamos tres nuevas opciones de ejecución al ejecutar la herramienta de preparación para migración:

  • Predeterminado: ejecutar la migración previa y la comprobación de migración previa simultáneamente (-p)

  • Ejecutar solo la migración previa (aplicaciones) (--appsonly)

  • Ejecutar solo el paso de validación de credenciales (--credonly)

Al ejecutar la herramienta de preparación para migración, debes proporcionar el token de controlador (-t), y el nombre de host y la dirección IP (-i) del controlador. Esto también significa que ahora puedes ejecutar la herramienta de preparación para migración en una configuración de múltiples nodos proporcionando el nombre de host y la dirección IP del controlador, y el token de controlador.

Ten en cuenta que no es posible ejecutar dos instancias de la herramienta de preparación para migración simultáneamente para el mismo controlador.