Mejores prácticas para la actualización de Alteryx Server
Aunque la actualización de una versión de Alteryx Server a otra es un proceso sencillo, hay varias consideraciones y pasos de preparación que pueden ayudar a garantizar una actualización sin problemas. En esta página, se proporcionará una descripción general temática del proceso, incluidos enlaces a documentación útil y un enfoque paso a paso para considerar a la hora de planificar la actualización.
No todos los pasos o recomendaciones de este documento son aplicables a cada entorno o instalación. Tu plan puede ser diferente.
En general, el proceso de actualización debe consistir en los siguientes pasos de alto nivel:
En las siguientes secciones, se describen estos pasos y se agregan comentarios para ayudar a planificar tu trabajo. Los enlaces a instrucciones detalladas, cuando existan, se mostrarán en línea, y en la sección Guías y artículos de ayuda puedes encontrar una lista agregada de todos los enlaces proporcionados en este documento.
Encuentra una lista de verificación de estos pasos en la Lista de verificación de la actualización de Alteryx Server.
Alteryx y sus socios están disponibles para ayudar en la planificación y ejecución de una actualización. Habla con tu ejecutivo de cuenta si necesitas ayuda con este proceso.
Nueva terminología
Con el lanzamiento de Server 2022.3, el término Gallery ha quedado obsoleto en favor de la interfaz de usuario de Server. Aunque el término heredado todavía existe en el software y la documentación en el momento de escribir este documento, se utiliza la interfaz de usuario de Server para referirse a los servicios, nodos, ajustes y demás elementos aplicables.
Sección 1. Documentar el entorno
Capturar la arquitectura y configuración
Es necesario tener una comprensión completa (y documentación) de tu entorno. Como mínimo, necesitas saber la siguiente información:
¿Cuántos servidores están instalados y cuáles son sus funciones?
¿Cuántos controladores, instancias de interfaz de usuario de Server, trabajadores y nodos de MongoDB y SQL tienes en cada uno de tus entornos (de desarrollo, prueba, producción)?
¿Ejecutas un entorno de alta disponibilidad (HA)?
¿Existe un diagrama arquitectónico que visualice el entorno? Si no es así, esta es una buena oportunidad para crear uno.
¿Qué versión de software de Alteryx Server se está ejecutando en tu entorno?
¿Qué software adicional se ha instalado?
Bibliotecas R personalizadas
Bibliotecas Python personalizadas
Servicios públicos de terceros
Conectores
No todos los conectores necesitan actualizarse y algunos pueden no tener una actualización disponible.
Paquetes de datos: Location Insights (insights de ubicación), Business Insights (insights empresariales), Intelligence Suite, etc.
La mejor práctica es instalar versiones coincidentes de estos complementos durante la actualización, si están disponibles.
Herramientas personalizadas diseñadas por tus usuarios o descargadas de la Comunidad, otras herramientas y conectores de terceros comprados o gratuitos. Haz una lista de estos, junto con sus versiones.
Las opciones de configuración que se han establecido a través de la herramienta de configuración Configuración del sistema Alteryx, incluidas, entre otras:
Espacios de trabajo
Directorios de registro
Configuración de habilitación del programador y del motor
Configuración de persistencia, incluidos:
Tipo de base de datos
Carpeta de datos
Opciones de retención
Configuración de la interfaz de usuario de Server (URL y seguridad)
Métodos de autenticación e información de IDP
SMTP
Ejecutar como usuario
Nota
Estas opciones de configuración (por ejemplo, Programador, Engine, Persistencia, Interfaz de usuario de Server, Configuración de SMTP, Ejecutar como usuario y más) se capturan en C:\ProgramData\Alteryx\RuntimeSettings.xml, por lo que los administradores no necesitan registrar la configuración por separado. Una copia de RuntimeSettings.xml proporciona todo esto en un archivo XML de texto sin formato.
Usuario de inicio de sesión de servicio
Especificaciones de servidores físicos y virtuales
Núcleos y memoria
Versión de SO
Para obtener más información, ve a Requisitos del sistema para Alteryx Server.
Versiones de bases de datos y Python:
MongoDB administrado por el usuario: la versión de MongoDB administrada por el usuario es independiente de una actualización de Server. Es posible que necesites actualizar por separado tu MongoDB administrado por el usuario en paralelo a una actualización de Server. En el caso de la instancia administrada por el usuario, Alteryx no proporciona soporte. Para obtener más información, ve a Política de compatibilidad de versiones.
MongoDB integrado: las versiones de Mongo y Python integradas siguen a la versión de Server y no necesitan anotarse por separado. Para obtener más información acerca de las versiones integradas de MongoDB, ve a Referencia del esquema de MongoDB o Política de compatibilidad de versiones.
SQL DB administrado por el usuario: la versión de SQL DB administrada por el usuario es independiente de una actualización de Server. Es posible que necesites actualizar por separado tu SQL DB administrado por el usuario en paralelo a una actualización de Server. En el caso de la instancia administrada por el usuario, Alteryx no proporciona soporte. Para obtener más información, ve a Política de compatibilidad de versiones.
Nota
Si estás utilizando la herramienta Python, comprueba la Entorno de la herramienta Python en las actualizaciones de Server antes de realizar la actualización.
Nota
Tu lista de trabajos programados, colecciones, flujos de trabajo y membresías es parte de MongoDB y no se pierde durante la actualización.
Hemos preparado una Configuration and Architecture Checklist para facilitarte este paso. Completar esta lista de verificación te dará una visión general de tu infraestructura y configuración.
Identificar flujos de trabajo fundamentales para el negocio
Una parte importante de la planificación de tu actualización es identificar los flujos de trabajo fundamentales para el negocio que deseas proteger y probar como parte del proceso de actualización. Estos son generalmente flujos de trabajo que se ejecutan según una programación, actúan como dependencias del trabajo posterior (dentro o fuera de Alteryx) o proporcionan datos/resultados importantes a los stakeholders clave de la empresa. Esencialmente, se recomienda identificar cualquier flujo de trabajo que, si no está disponible durante una cantidad significativa de tiempo, tendrá un efecto perjudicial en tu negocio.
Identificar flujos de trabajo fundamentales puede ayudarte a elegir la versión objetivo. Si el flujo de trabajo fundamental contiene herramientas o conectores que no son compatibles con una versión en particular, es recomendable tenerlo en cuenta a la hora de seleccionar la versión objetivo (consulta la sección 3 a continuación para revisar la Guía de actualización de Alteryx Server de versión a versión: versiones compatibles). Estos flujos de trabajo también se pueden modificar para las pruebas posteriores a la actualización (aquí debajo) e incluir en tu plan de control de calidad (QA).
Crear versiones de prueba de flujos de trabajo fundamentales para el negocio
Cuando pruebas flujos fundamentales durante el control de calidad posterior a la actualización, debes desactivar o editar las salidas que escriben datos en otros sistemas de producción o generar salidas que residan en el entorno de producción.
Una metodología común aquí es crear versiones de prueba dedicadas de estos flujos que todavía acceden a los sistemas y directorios objetivo, pero no sobrescriben los datos en los archivos de producción y tablas.
En el caso de las operaciones de datos, cambia las salidas para escribir en versiones de prueba dedicadas de tablas.
En el caso de las operaciones de archivos, escribe archivos con una convención de nombres de archivos diferente o en una subcarpeta de prueba.
Esto te permite hacer pruebas integrales que no afectan la producción. Estos flujos de trabajo de prueba deben utilizarse en las pruebas de producción por la misma razón.
Consideraciones adicionales
Planifica y programa tus actividades de actualización para minimizar la interrupción de las operaciones en curso de tu organización. Programa la ventana de actualización fuera del horario normal de trabajo (si es posible) y durante períodos de utilización “más liviana”. Por ejemplo, no la programes durante el cierre de fin de año fiscal, el procesamiento de fin de trimestre, las auditorías mensuales, etc.
Algunos clientes utilizan una ventana de actualización para repasar las versiones del sistema operativo (SO) en sus máquinas Alteryx. Trabaja con los miembros de tu departamento de TI si quieres hacer esto y revisa los requisitos del sistema. En tu plan de actualización, asegúrate de documentar si estás actualizando el SO al mismo tiempo. Si los problemas ocurren después de la actualización de Alteryx, se informará al respecto a los ingenieros de soporte.
Sección 2. Realizar una comprobación del estado de Server (opcional)
Una comprobación de estado de Alteryx Server es un recurso valioso para entender los patrones de uso de un entorno de Alteryx Server. Analiza los patrones de uso históricos para determinar qué tan ocupado está el entorno de Server, qué tipo de actividades de optimización podrían ser necesarias y si el entorno tiene el tamaño adecuado.
Si deseas obtener más información, comunícate con tu ejecutivo de cuenta de Alteryx.
Sección 3. Seleccionar una versión o versiones objetivo
Elige la versión de Server a la que planeas actualizar. Según el ciclo de actualizaciones de tu organización, es posible que tu versión esté varias ediciones atrasada con respecto al último lanzamiento. La cantidad de versiones entre tu versión actual y la objetivo afecta al enfoque de actualización, así que planifica según corresponda.
Muchas organizaciones no actualizan la versión con cada lanzamiento, en especial porque se pueden lanzar varias versiones por año. Sin embargo, es importante mantenerse al día dentro de lo razonable. Las actualizaciones periódicas proporcionan actualizaciones de seguridad importantes, mejoras de rendimiento y características nuevas.
Una estrategia común consiste en estandarizar el uso del lanzamiento más reciente o el anterior para equilibrar la estabilidad con el acceso oportuno a las mejoras.
Nota
Todos los lanzamientos principales se admiten por 24 meses. Si tu organización ha adoptado actualizaciones poco frecuentes, esto debería ser importante para tu decisión.
Revisar las notas de lanzamiento
El primer paso en el proceso de selección es leer las Notas de lanzamiento. En estas, se detallan las nuevas características y los cambios de programación en las versiones objetivo potenciales, y se detallan las correcciones de errores y los problemas conocidos.
Entender el camino de actualización, de donde estás ahora a donde quieres ir
Algunas versiones tienen consideraciones adicionales si provienen de ciertas versiones anteriores y algunas versiones no son apropiadas para todos los clientes. Por ejemplo, es posible que debas actualizar tu MongoDB para actualizar varias versiones o, en el caso de la versión 2022.3, tendrás que actualizar Server y Designer juntos debido a las mejoras de cifrado de datos en el software que hacen que esa versión de Server sea incompatible con las versiones anteriores.
El sitio de ayuda y soporte de Alteryx tiene una Guía de actualización de Alteryx Server de versión a versión: versiones compatibles. (para versiones no compatibles, consulta Guía de actualización de Alteryx Server de versión a versión: versiones no compatibles.), en la que se destacan las tareas y las consideraciones que debes tener en cuenta cuando te actualices a las versiones de Alteryx Server. La guía es especialmente útil si estás actualizando varias versiones a la vez, como la migración de 2019.1 a 2022.1. Para garantizar una actualización sin problemas, es posible que debas dar algunos pasos graduales.
Seleccionar la versión
Ahora que te has educado en las diversas versiones disponibles y las consideraciones especiales que delinean tu ruta de actualización, estás listo para seleccionar tu versión objetivo. Desde aquí, ve al sitio Descargas.
Sección 4. Descargar el software
Visita el portal de licencias de Alteryx. Necesitas una cuenta para visitar el sitio. Una vez allí, encontrarás todas las descargas que tienes disponibles, incluidas, entre otras:
Alteryx Server (versiones actuales y anteriores)
Alteryx Designer
Alteryx Intelligence Suite y datos de insights
Controladores de bases de datos compatibles con Alteryx
Descarga todo el software que necesitas y continúa con el siguiente paso en el proceso. Para obtener ayuda con las descargas, visita la página de ayuda Descargar e instalar un producto.
Paridad de las versiones
En general, es la mejor práctica mantener Server y Designer en la misma versión. Por lo tanto, descargar el instalador de Designer correspondiente en este momento tiene más sentido. Sin embargo, dado que la actualización de Designer en una base de usuarios grande requiere planificación y recursos adicionales, te recomendamos no completar la actualización al mismo tiempo que la actualización de Server.
A partir de la versión 2025.2, Alteryx ha desacoplado las actualizaciones de Designer y Server para modernizar la experiencia de actualización y reducir la sobrecarga de TI. Ahora, puedes actualizar Designer de forma independiente de Server.
Server es generalmente compatible con versiones anteriores de Designer, con la advertencia de que las nuevas características compatibles con la versión objetivo de Server no estarán disponibles en versiones anteriores de Designer.
En el caso de Server y Designer 2022.3, esta compatibilidad con versiones anteriores no existe debido a las mejoras de cifrado de datos en toda la plataforma. Si planeas actualizar a esta versión o a otra posterior, Designer debe actualizarse al mismo tiempo. En la página de ayuda Herramienta de preparación para migración, hay instrucciones especiales destinadas a preparar una actualización de esta versión. Si estás intentando descargar una versión anterior que ya no está disponible en la página Descargas, comunícate con el departamento de Cumplimiento.
Sección 5. Realizar una actualización de Sandbox o una implementación azul-verde
Aviso
La actualización directa del Server de producción puede generar tiempo de inactividad si se producen problemas durante la actualización o durante las pruebas posteriores a la actualización.
Si no se puede realizar una copia de seguridad, es posible que no puedas restaurar la versión anterior, y tu entorno de producción quedará inactivo hasta que se resuelva el problema de actualización.
Las mejores prácticas incluyen lo siguiente:
Actualización de Sandbox
Probar la actualización en un entorno que no sea de producción y documentar los pasos del proceso antes de actualizar el Server de producción ayuda a garantizar una actualización sin problemas. Esto también permite confirmar que los flujos de trabajo fundamentales para el negocio y las herramientas de terceros siguen ejecutándose según lo previsto. En caso de que no lo hagan, ofrece la oportunidad de explorar y remediar estos problemas y agregar estos pasos de remediación a tu plan de actualización de producción. Los pasos que sigas en esta actualización de prueba, además de los pasos de corrección adicionales que agregues en la fase de control de calidad, se convertirán en tu “script” de actualización para la producción. Comunícate con el equipo de Cuentas para solicitar una licencia de Sandbox.
Implementación azul-verde
Una actualización del servidor Sandbox se convierte en el nuevo entorno de producción después de la validación. Esto descarta el riesgo de que el Server de producción esté inactivo durante una cantidad de tiempo indeterminada, ya que no se actualiza en el lugar. El entorno de producción original es azul, y el entorno nuevo o de Sandbox, en el que se pueden implementar y probar actualizaciones, es verde. La implementación azul-verde valida que el entorno de Server y los controladores de base de datos, DSN, conectores requeridos y otras configuraciones se comprendan completamente, ya que deben configurarse en el Sandbox para la validación.
La siguiente tabla muestra una lista escalonada del mínimo de recomendaciones al mejor de los casos cuando se actualiza Server:
Copia de seguridad de Mongo integrada | Mínimo | Superior | best | Beneficios |
|---|---|---|---|---|
Copia de seguridad de MongoDB | ☑ | ☐ | ☐ | Conserva la información de la base de datos para la reversión en caso de que surjan errores durante la actualización. La reversión puede incluir pasos manuales y puede requerir la asistencia del soporte de Alteryx. |
Instantánea de TI de la máquina de Windows Server | ☐ | ☑ | ☐ | Proporciona una reversión rápida y fácil sin pasos manuales. Pasos: tu equipo de TI realizará la copia de seguridad de una instancia completa de la máquina de Alteryx Server. Nota: El servicio debe detenerse para que la instantánea no capture la base de datos mientras se actualiza. Esto podría impedirle funcionar al momento de la restauración. |
Implementación azul-verde | ☐ | ☐ | ☑ | En una implementación azul-verde, se necesita una copia de seguridad de la base de datos para migrar los equipos host, pero no es necesario una instantánea de TI. |
Copia de seguridad de Mongo o SQL Server administrada por el usuario | Mínimo | Superior | best | Beneficios |
Copia de seguridad de la base de datos | ☐ | ☐ | ☑ | Las actualizaciones realizan migraciones de esquemas en colecciones de bases de datos. Es necesario que la base de datos original pueda revertir la actualización. |
Actualizar | Mínimo | Superior | best | Beneficios |
Actualización in situ del Server de producción | ☑ | ☐ | ☐ | Es la más fácil de realizar, pero representa el mayor riesgo de tiempo de inactividad impredecible del Server de producción ante un problema con la actualización. |
Actualización de prueba en un servidor Sandbox | ☐ | ☑ | ☐ | Elimina los problemas de actualización y prueba flujos de trabajo y conectores fundamentales en el entorno actualizado sin tiempo de inactividad de producción. Pasos: Realiza una recuperación de host en un entorno de Sandbox:
Después de validar el proceso de actualización, realiza una actualización in situ del Server de producción. |
Implementación azul-verde | ☐ | ☐ | ☑ | La implementación azul-verde elimina el riesgo y el tiempo de inactividad potencial de una actualización in situ, ya que el entorno de producción original no se actualiza. Pasos: Realiza una actualización de Sandbox, valida flujos de trabajo fundamentales y, a continuación, cambia la URL de tu entorno de producción al Sandbox (lo que lo convierte en el nuevo entorno de producción). |
Idealmente, comienza con la misma versión de entorno de prueba/desarrollo/Server de prueba y actualízala. Consulta el artículo de la comunidad Entorno de Alteryx Server Sandbox para obtener más información sobre los entornos de Sandbox.
Si tienes un entorno de varios nodos, las pruebas siguen siendo eficaces en una sola máquina que ejecuta Controlador + Interfaz de usuario de Server + Trabajador. Del mismo modo, si tienes un MongoDB administrado por el usuario, restaurar una copia de seguridad de la base de datos en el MongoDB incrustado de la máquina de prueba puede ayudar a validar la actualización. Comunícate con tu ejecutivo de cuenta para obtener información sobre una licencia de entorno de prueba.
Como mínimo, debes instalar la versión objetivo de Designer en la máquina de un usuario para probar flujos de trabajo fundamentales en la nueva versión. Puedes encontrar las instrucciones en la página de ayuda Instalar dos versiones de Designer en la misma máquina.
1. Realizar una copia de seguridad
Realizar una copia de seguridad de:
MongoDB y SQL DB administrados por el usuario
Ten en cuenta que la creación de una copia de seguridad es responsabilidad del cliente y no cuenta con el soporte de Alteryx.
2. Completar comprobaciones previas a la actualización
Puedes evitar muchos problemas de actualización de Server mediante las comprobaciones y el flujo de trabajo previos a la actualización que se encuentran en el artículo de la comunidad Alteryx Server: comprobaciones previas a la actualización. Este procedimiento aborda los problemas más comunes que un cliente enfrentará a la hora de realizar una actualización y enumera las soluciones/pasos recomendados para cada uno.
Es importante ejecutar las comprobaciones previas a la actualización en cada uno de tus entornos antes de realizar la actualización. Por ejemplo, estás probando en una máquina de desarrollo, luego, se recomienda volver a ejecutar las comprobaciones en tu entorno de producción y seguir los pasos indicados antes de completar esa actualización.
Como parte de la planificación previa a la actualización, acuerda con los stakeholders del negocio cuánto tiempo se permitirá que la actualización se ejecute antes de activar una reversión.
Para obtener mejores resultados, evita combinar una actualización de Server con una migración de host. Realiza una operación a la vez, lo que permite un período de validación completo después de la finalización antes de comenzar con la siguiente.
Deshabilitar el programador en los nodos de trabajador durante las actualizaciones
De forma predeterminada, las programaciones que deberían haberse ejecutado mientras se actualizaba Server se reiniciarán tan pronto como se reinicien Server y los nodos. Ten esto en cuenta cuando ejecutes la actualización de prueba en tu entorno de prueba, ya que probablemente no desees que los flujos de trabajo se inicien e impacten en tus sistemas de producción.
Recomendamos desactivar todas las programaciones antes de la actualización y determinar qué debe ejecutarse de forma individual.
Si no deseas que las programaciones se ejecuten cuando se inicie el servicio:
Ejecuta la configuración del sistema Alteryx en cada trabajador (y nodo principal de Server).
Deselecciona la opción Trabajador > General > Ejecutar trabajos sin asignar.
Dale al trabajador una etiqueta de tarea única (por ejemplo, “UPGRADETESTING”).
De forma alternativa, comunícate con el servicio de asistencia al cliente para obtener ayuda con la eliminación de todas las programaciones.
3. Realizar la actualización
Realizar la actualización es un proceso sencillo si estás actualizando en el lugar. Hay diferentes pasos si estás realizando una instalación nueva de la nueva versión en un equipo objetivo, que incluyen la aplicación de licencias que no forman parte de la ruta de actualización; las licencias activas existentes continúan funcionando en máquinas actualizadas sin intervención. Los pasos generales de actualización se muestran en Instalar o actualizar Server.
Se detallan las diferentes instrucciones para nuevas instalaciones y actualizaciones en el lugar, y en el documento se incluyen enlaces a archivos de ayuda asociados/artículos sobre licencias, requisitos del sistema, listas de verificación preparatorias, actualizaciones de MongoDB y más. Muchos de estos se incluyen en la sección Guías y artículos de ayuda al final de este documento.
Ten en cuenta que las herramientas predictivas deben actualizarse con la instalación principal. Si tenías un usuario de inicio de sesión de servicio establecido, debes configurarlo de nuevo después de la actualización, ya que las actualizaciones eliminan y reinstalan el servicio Alteryx.
Actualización de un entorno de varios nodos
En entornos de varios nodos, cada nodo debe actualizarse a la misma versión y cerrarse en el orden que se muestra en la sección Cierre del documento incluido en el artículo de la comunidad Cómo reiniciar los servicios en un Alteryx Server de varios nodos.
Después de actualizar todos los nodos, sigue el orden de reinicio adecuado que aparece en la sección Inicio del mismo documento.
Una vez que todo esté en funcionamiento, actualiza los conectores, los paquetes de datos, los controladores, los complementos (como Intelligence Suite) y las herramientas de terceros que lo necesiten.
4. Probar la actualización
Ahora que el software de Server y los conectores aplicables se han actualizado, es hora de comenzar las pruebas.
Alteryx Services
Las primeras pruebas son básicas y las puedes encontrar en la sección Prueba de la Lista de verificación de actualización de Server.
¿Se está ejecutando Alteryx Service?
Puedes:
¿Acceder a la URL de Server?
¿Puedes navegar por las páginas de administrador y ver los usuarios, las colecciones, etc.?
¿Publicar un flujo de trabajo de Designer en Server?
¿Ejecutar el flujo de trabajo?
Si la configuración lo permite, ¿puedes guardar y ejecutar un flujo de trabajo especificando tus credenciales?
Opciones de configuración
A continuación, examina las opciones de configuración de la herramienta de configuración Configuración del sistema de Alteryx para asegurarte de que no se hayan perdido los ajustes. Estos ajustes se registraron en la sección Documentar el entorno. Si hay algún cambio que necesites hacer, como ajustes de persistencia, ajustes de SMTP, etc., ahora es el momento de hacerlos. Además, toma nota de estos cambios para reutilizarlos en tu entorno de producción actualizado.
Nota
Algunos ajustes se cambian activamente en algunas de las actualizaciones. Por ejemplo, la versión 2022.1 estableció AMP en Server y cambió el número de flujos de trabajo permitidos para ejecutarse simultáneamente.
Comprueba siempre las Notas de lanzamiento para obtener más información.
Conectores y controladores
El siguiente paso es probar tus conectores y controladores para sistemas importantes, como los conectores SharePoint y O365, y los conectores ODBC/OleDB para SQL Server, Snowflake, Databricks, etc. Asegúrate de poder conectar, leer y escribir datos.
Flujos de trabajo fundamentales
Ahora, prueba los flujos fundamentales para el negocio y los que utilizan los conectores que también se registraron en la sección Documentar el entorno. En este conjunto de pruebas, se utilizan las versiones de prueba de los flujos de trabajo creados en la sección Crear versiones de prueba de flujos de trabajo fundamentales para el negocio de esta guía. Si ejecutas versiones de producciones sin modificar de estos flujos, tus objetivos de producción se verán afectados como si estos flujos se estuvieran ejecutando normalmente.
Programador e interfaz de usuario de Server
Por último, si estás ejecutando el programador y la interfaz de usuario de Server, prueba estos también:
¿Se puede programar un flujo de trabajo y se ejecuta?
¿Las aplicaciones analíticas se ejecutan correctamente?
Importante
Asegúrate de que las aplicaciones que publiques y programes/ejecutes en este entorno no sean versiones de producción. Si ejecutas versiones de producciones sin modificar de estos flujos, tus objetivos de producción se verán afectados como si estos flujos se estuvieran ejecutando normalmente.
5. Observar cualquier error y obtener ayuda
Cataloga cualquier problema que tus pruebas descubran, como:
servicios que no inician o reportan errores;
migraciones del esquema de MongoDB o cripto que fallan;
flujos de trabajo que no se ejecutan o se ejecutan con resultados o errores inesperados;
conectores que no funcionan;
errores en MongoDB.
En la Lista de verificación de actualización de Server, se incluyen algunos pasos comunes de solución de problemas en la última sección. El servicio de asistencia al cliente puede ayudarte si experimentaste un error en el proceso de actualización y no puedes resolverlo con los pasos comunes de solución de problemas que se muestran en la guía. Tu ejecutivo de cuenta puede proporcionar opciones si deseas asistencia para planificar o ejecutar una actualización.
6. Realizar una reversión/restauración
Si no pudiste resolver los problemas detectados durante la fase de prueba y de control de calidad, es hora de hacer una reversión o restauración. Antes de revertir o restaurar, es recomendable recopilar archivos de registro de las máquinas de Server para proporcionar al servicio de asistencia al cliente o para realizar una revisión interna antes del siguiente intento de actualización. Si tienes una instantánea/copia de seguridad, puedes volver a ella ahora y planificar tu próximo intento de actualización. Si no fue posible emplear una metodología de instantáneas, puedes seguir la metodología de reversión convencional que se muestra en el artículo de la comunidad Cómo se hace: baja de categoría de Alteryx Server.
Sección 6. Programar la actualización de producción
Una vez que hayas probado con éxito la actualización en su entorno de no producción y tengas tu proceso de actualización documentado, es hora de planificar la actualización de tu entorno de producción.
Nota
Tu actualización de producción debe seguir el “script” que creaste en tu entorno de prueba, con cambios específicos para cualquier diferencia arquitectónica entre los entornos. Por ejemplo, si el entorno probado era una arquitectura de nodo único, pero el entorno de producción tiene nodos separados para los trabajadores y la interfaz de usuario de Server, el entorno de producción tendrá pasos de instalación adicionales. Se consciente de esto cuando planees.
Sugerencia avanzada: Utiliza las notificaciones de Server a través de la interfaz de usuario de Server como un canal de comunicación adicional para informar a los usuarios sobre las actualizaciones pendientes. También puedes publicar información de actualización en tu comunidad Alteryx interna (por ejemplo, SharePoint, Confluence, Yammer, Teams y demás).
Deberás programar una cantidad adecuada de tiempo de inactividad e informar a los usuarios que el flujo de trabajo en Server no se ejecutará durante la actualización. En el caso de los flujos fundamentales para el negocio, los usuarios pueden ejecutarlos en tu entorno de prueba recientemente actualizado, ejecutarlos de forma local o solo planificar la interrupción e informar al público posterior afectado sobre el retraso.
Si también estás planeando actualizar Designer, ya sea a través de métodos de empaquetado/automatización o proceso de instalación manual, planifica el tiempo y los recursos adicionales necesarios para completar las instalaciones y asegúrate de informar a tu base de usuarios también. Recuerda que Server es retrocompatible con Designer, hasta la versión 2022.3, pero las versiones más recientes de Designer no funcionan con versiones anteriores de Server. Por lo tanto, las actualizaciones de Server siempre deben preceder a las actualizaciones de Designer.
Importante
Recuerda planificar tu actualización en un momento que minimice las interrupciones en tu negocio. Consulta Consideraciones adicionales para obtener más detalles y recomendaciones.
Sección 7. Realizar la actualización de producción
Actualizar Server
Los pasos de nivel alto en esta sección son un espejo de los pasos del 1 al 6 en la sección 5. Consulta la sección correspondiente para obtener detalles adicionales y enlaces de ayuda.
Prueba o realiza el control de calidad de la actualización.
Comprueba que los trabajos programados, las colecciones, las membresías y los flujos de trabajo publicados todavía existen y funcionan como se espera (en los casos en que se pueda comprobar).
Ten en cuenta cualquier error y obtén ayuda del servicio de asistencia al cliente.
Realiza una reversión/restauración si es necesario.
Restaura desde copias de seguridad o sigue el proceso en el artículo de la Comunidad Cómo hacerlo: degradación de Alteryx Server.
Actualizar Designer (opcional)
Una vez que tu entorno de producción esté en funcionamiento, puedes actualizar tus instalaciones de Designer si forman parte de tu plan. Recuerda que Designer no puede ser una versión superior a la que se ha instalado en Server y esta actualización afecta directamente a las máquinas de los usuarios. Los pasos para actualizar Designer se pueden encontrar en Actualizar Designer.
Compatibilidad con Designer y Server
La versión de Designer debe ser igual o más antigua que la versión de Server a la que se conecta. La excepción es Server 2022.3 (o posterior) que requiere al menos Designer 2022.3 debido a cambios en el cifrado.
La versión de Designer NO puede ser más nueva que el Server al que se conecta.
Solo la versión (año.lanzamiento) necesita coincidir, no el parche específico.
Al igual que una actualización de Server, las versiones actualizadas de Designer deben probarse para garantizar que los flujos de trabajo continúan ejecutándose y que las conexiones con Server aún se pueden realizar. Al igual que con las mejores prácticas para las actualizaciones de Server, planea probar tu actualización de Designer en un pequeño subconjunto de máquinas de usuario.
Qué hacer si la actualización falla
Si la actualización de Server falla o encuentra problemas críticos, no reinicies el proceso de actualización repetidamente. Más bien sigue los pasos a continuación para recopilar información de diagnóstico y ponerte en contacto con el Servicio de asistencia al cliente de Alteryx.
1. Envía un ticket de soporte
Abre un caso con el Servicio de asistencia al cliente de Alteryx e incluye los siguientes detalles:
La versión de Server desde la cual actualizaste y a la cual pasaste.
Una breve descripción de lo que falló (por ejemplo, durante la instalación, después del inicio del servicio o en la migración de esquemas).
Tipo de entorno: ¿es una configuración de un solo nodo o de varios nodos?
¿Se intentó una migración de host al mismo tiempo que la actualización?
¿Es un entorno de servidor de producción?
La marca de tiempo del fallo y cualquier mensaje de error visible.
¿Ya se tomaron medidas de solución de problemas? (Por ejemplo, reinicio del servicio, reinicio del sistema o intento de reversión manual)
¿Tienes una copia de seguridad actual de tus datos de Alteryx Server y base de datos?
Incluye los archivos de registro enumerados a continuación de las últimas 24 horas (o los 2 o 3 archivos de registro más recientes) para la resolución de problemas:
Logs de Server (Gallery)
Ubicación:
\%ProgramData%\Alteryx\Gallery\LogsLogs de servicio
Ubicación:
\%ProgramData%\Alteryx\Service\AlteryxServiceLog.logIncluye varios archivos
.logsi están disponibles.RuntimeSettings.xml
Ubicación:
\%ProgramData%\Alteryx\RuntimeSettings.xmlLog de migración del esquema de AlteryxGallery configurado en Configuración del sistema Alteryx > Interfaz de usuario de Server > Directorio de archivos de registro.
Versiones 2025.1 y posteriores:
C:\ProgramData\Alteryx\Service\alteryx-gallery-migration.csvVersiones 2024.2 y anteriores:
C:\ProgramData\Alteryx\Gallery\Logs\alteryx-migration.csv
Log de migración del esquema de AlteryxService configurado en Configuración del sistema Alteryx > Controlador > Archivos de registro.
Versiones 2025.1 y posteriores:
C:\ProgramData\Alteryx\Service\alteryx-service-migration.csvVersiones 2024.2 y anteriores:
C:\ProgramData\Alteryx\Service\alteryx-migration.csv
AlteryxServiceMigrator_#.logs (obligatorio cuando se actualiza a la versión 2022.3), que se encuentra en:
Logs de herramientas de preparación:
C:\ProgramData\Alteryx\ServiceLogs de inicio del servicio: Configuración del sistema Alteryx > Controlador > General > carpeta Archivos de registro
2. Información adicional (opcional)
Si es posible, también incluye:
Capturas de pantalla de cualquier mensaje de error.
Archivos de registro del instalador (normalmente en
%TEMP% o %LOCALAPPDATA%\Temp).Salida de cualquier herramienta de preparación para migración utilizada antes de la actualización.
3. Próximos pasos
No desinstales ni reviertas a menos que lo indique el soporte de Alteryx.
Espera a que el soporte analice los logs y proporcione orientación para la corrección.
Guías y artículos de ayuda
En esta lista puedes encontrar enlaces a todos los recursos mencionados en este documento, así como recursos adicionales que pueden ser útiles en el proceso de actualización de Server.