Guía de recuperación del host de Server
Esta guía tiene como objetivo ayudar a un administrador de Alteryx Server a recuperar una instancia de Server en las siguientes situaciones:
Error del host original*
Migración a un nuevo equipo de Server
Transición de un Server local a un Server en la nube
Otros cambios en la infraestructura
Una recuperación de Server te permite tener un nuevo servidor funcionando con tus usuarios originales, flujos de trabajo, programaciones, etc., basado en tener lo siguiente de Server original:
Token del controlador
RuntimeSettings.xml
*Copia de seguridad de MongoDB
* Para recuperar completamente una instancia de Server en una situación de recuperación en caso de desastre en el que el host original ya no es accesible, el archivo RuntimeSettings.xml debe estar preparado con antelación, mientras que el host original está en un estado de funcionamiento completo. Para obtener más información, consulta la página de ayuda Preparación para la recuperación en casos de desastre.
A continuación, se muestran los detalles de cada paso del proceso:
3: Recuperación de RuntimeSettings.xml
5: Restauración de otros archivos y configuraciones
Dentro del alcance
Recuperación de la falla de un único nodo, instalación predeterminada de Server con el uso de MongoDB integrado.
Copia de seguridad disponible con la información necesaria intacta.
El host objetivo se puede sobrescribir.
Fuera del alcance
Entorno de Server de varios nodos, MongoDB administrado por el usuario o SQL Server administrado por el usuario: comunícate con el Servicio de asistencia al cliente para obtener ayuda.
Copia de seguridad o restauración de controladores ODBC.
Copia de seguridad o restauración de DSN del usuario o del sistema.
Copia de seguridad o restauración de otros alias almacenados en Windows que existen fuera de Alteryx.
Prerrequisitos
Compatibilidad de versiones:
Host original | Hosts de destino compatibles |
---|---|
2021.4.2.47792 (parche 5) o el parche más reciente | 2021.4.2.47884 (Parche 11) o el parche más reciente de la versión 2021.4 |
2022.1.1.42590 (Parche 3) o el parche más reciente | 2022.1.1.42691 (Parche 9) o el parche más reciente de la versión 2022.1 |
2022.3.1.430 (Server GA) o el parche más reciente | 2022.3.1.553 (Parche 6) o el parche más reciente de la versión 2022.3 |
2023.1.1.123 (Server GA) o el parche más reciente | 2023.1.1.247 (Parche 2) o el parche más reciente de la versión 2023.1 |
Todas las versiones recientes y futuras de Alteryx Server | Cualquier versión con disponibilidad general o parche, siempre y cuando el host original y el host de destino estén en la misma versión y parche. |
Instala todos los controladores de base de datos y el software necesario para el funcionamiento del flujo de trabajo antes de completar los pasos descritos en esta guía a fon de minimizar el tiempo de inactividad.
Derechos de administrador en el host objetivo.
Acceso a todas las credenciales utilizadas para la suplantación, incluso la cuenta de servicio (si no es el sistema local), el usuario "Ejecutar como" (Run As) y cualquier credencial de flujo de trabajo definida o utilizada.
Token de controlador del host original.
Se necesita una línea visual directa para restaurar la clave de cifrado como parte de la recuperación. Tu nuevo Server necesitará acceso a AlteryxService que se ejecuta en el nodo controlador de tu Server original a través de tu red. Comunícate con el Servicio de asistencia al cliente si no puedes cumplir con este requisito previo.
Copia de seguridad de MongoDB del host original. Aprende a hacer una copia de seguridad.
Para obtener más información, consulta las prácticas recomendadas para la creación de copias de seguridad y restauraciones de Server: Parte 1 y Parte 2.
Comprueba que el host objetivo esté establecido en la misma zona horaria que el host original en la configuración de zona horaria de Windows. Si no está establecido en la misma zona horaria, se pueden producir errores en las vistas de la programación.
Opcional
Es posible que los siguientes elementos no se hayan aprovechado en el Server original. Comprueba si la funcionalidad se está utilizando en tu Server original y, si es así, completa los pasos correspondientes marcados (Opcional) en esta guía.
Usuario de inicio de sesión del servicio
Detalles del usuario "ejecutar como" (Run As) para la configuración del trabajador:
Dominio
Nombre de usuario
Contraseña
Nombre de usuario y contraseña del servidor SMTP para la configuración de Server.
Conectores de
%ProgramData%\Alteryx\Tools
.Alias de Alteryx basados en el sistema y en conexiones en-BD del Server original.
Conexiones de datos en-BD del sistema, consulta
%ProgramData%\Alteryx\Engine\SystemConnections.xml
Conexiones de datos del sistema, consulta
%ProgramData%\Alteryx\Engine\SystemAlias.xml
Alias de Alteryx basados en el usuario y en conexiones en-BD del Server original: La información que se indica a continuación puede ser relevante para cada cuenta de usuario “ejecutar como” (Run As) o de credenciales de flujo de trabajo
Conexiones de datos de usuario consulta
C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml
Conexiones de datos en-BD de usuario consulta
C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml
Herramientas predictivas de Alteryx y cualquier biblioteca R utilizada por flujos de trabajo en el Server original.
Las herramientas predictivas deben instalarse como parte de la instalación inicial de Alteryx Server (Paso 2) para garantizar que se instale la versión correcta.
Paso 1: Preparación
# | Paso | Detalles |
---|---|---|
1.1 | Ajustar la zona horaria del host | La zona horaria de Windows del host objetivo debe establecerse para que coincida con el host original. |
1.2 | Garantizar el acceso a Alteryx | Asegúrate de que el host pueda establecer contacto con whitelist.alteryx.com, utilizado por el sistema de licencias de Alteryx. |
Paso 2: Instalar Alteryx Server
# | Paso | Detalles |
---|---|---|
2.1 | ¿La versión de Alteryx Server en tu host original es alguna de las siguientes versiones?
| SÍ: instala o actualiza el host objetivo a la misma versión principal y de parche que existe en el host original. Utiliza el archivo de instalación completo en lugar del archivo de instalación del parche. Si es necesario, comunícate con fulfillment@alteryx.com para solicitar el archivo de instalación necesario. Ve al paso 2.4. NO: continúa con el paso 2.2. |
2.2 | ¿La versión de Alteryx Server en tu host original está incluida en las columnas Hosts objetivo compatibles de la tabla Compatibilidad de versiones en la sección Requisitos previos? | SÍ: instala o actualiza el host objetivo a la misma versión principal y de parche que existe en el host original. Utiliza el archivo de instalación completo en lugar del archivo de instalación del parche. Si es necesario, comunícate con fulfillment@alteryx.com para solicitar el archivo de instalación necesario. Ve al paso 2.4. NO: continúa con el paso 2.3. |
2.3 | Instala la versión de parche más reciente de Alteryx Server en el host objetivo. | Instala o actualiza el host objetivo al parche más reciente disponible para la versión principal del host original (por ejemplo, si el host original está en el parche 3 de 2022.3, instala el parche más reciente de 2022.3 en el host objetivo). |
2.4 | Configurar Alteryx Server | Configura Alteryx Server con la configuración predeterminada y confirma que la interfaz de usuario de Server aparezca en un navegador. No es necesario que inicies sesión. |
2.5 | Solucionar problemas Error de clave de licencia “en uso” | Si tu clave de licencia sigue vinculada a tu antiguo servidor, tendrás que desactivarla en ese equipo. Si no puedes acceder a ese equipo, comunícate con tu administrador de licencias para liberar la licencia. |
Paso 3: Recuperación de RuntimeSettings.xml
# | Paso | Detalles |
---|---|---|
3.1 | Abrir el Símbolo de sistema 1 en la carpeta bin | Abre un símbolo del sistema como administrador, navega hasta la carpeta
|
3.2 | Detener el servicio | Ingresa el comando
Si el proceso tiene éxito, deberías ver |
3.3 | Realizar una copia de seguridad de RuntimeSettings.xml existente | Ingresa el comando
|
3.4 | ¿Tienes un RuntimeSettings.xml preparado previamente en tu host objetivo a partir de una preparación para la recuperación en caso de desastre? | SÍ: tu RuntimeSettings.xml del proceso de recuperación en caso de desastre ya debería estar ubicado en el directorio Ve al paso 3.13. NO: copia el archivo RuntimeSettings.xml desde tu host original al directorio Continúa con el paso 3.5. |
3.5 | Borrar el Token de controlador | Edita el archivo RuntimeSettings.xml que acabas de copiar y elimina todo lo que hay entre las etiquetas <ServerSecretEncrypted>, de modo que dejes solo las etiquetas como se muestra a continuación: ![]() Guarda y cierra el archivo. |
3.6 | Restaurar el Token de controlador | Introduce el comando utilizando tu token de controlador de servidor original
Resolución de problemas: La versión 2021.3+ pueden producir un error en este paso con el mensaje: "Set server secret failed: Error inCryptImportKey(3): Bad Data. (-2146893819)". Para corregir esto, consulta el paso anterior para asegurar que el valor se eliminó de entre las etiquetas. |
3.7 | Restaurar Storage Keys Encrypted | Es posible que el valor de ![]() |
3.8 | Restaurar Ejecutar como usuario | Si tenías un comando ejecutar como usuario en el host original, introduce el siguiente comando; de lo contrario, omite este paso. |
3.9 | Restaurar Contraseña SMTP | Si completaste Configuración del sistema Alteryx > Server UI > SMTP > Password (incluso si la casilla de verificación SMTP estaba desactivada), ingresa el siguiente comando; de lo contrario, omite este paso. |
3.10 | Guarda RuntimeSettings.xml | Guarda el archivo RuntimeSettings.xml. |
3.11 | ¿La versión de Alteryx Server en tu host original es alguna de las siguientes versiones?
| SÍ: ve al paso 3.13. NO: continúa con el paso 3.12. |
3.12 | Transferir la Clave de cifrado Esta funcionalidad solo está disponible en las siguientes versiones:
| Importante: Ten en cuenta que esto requiere que AlteryxService se ejecute en el host original, y el host objetivo tendrá que poder acceder a él a través de la red. Con los pasos que se describen en Proceso de transferencia de clave de cifrado, podrás transferir la clave de cifrado de tu controlador actual a uno nuevo. |
3.13 | Permanecer en la línea de comandos | Para el paso 4, se supone que estás en una línea de comandos de administrador en la carpeta |
Paso 4: Recuperación de MongoDB
# | Paso | |
---|---|---|
4.1 | Obtener copia de seguridad de MongoDB | Copia la copia de seguridad de Mongo desde el host original a una carpeta |
4.2 | Restaurar a una nueva carpeta | Restaura la base de datos de Mongo desde la carpeta de copia de seguridad a una nueva carpeta de restauración. Revisa mongoRestore.log como se describe a continuación para asegurarte de que la restauración se haya realizado correctamente. Consulta la sección Restaurar desde una copia de seguridad de MongoDB en el documento Copias de seguridad de MongoDB para encontrar el comando de restauración adecuado para tu versión de Server. |
4.3 | Confirma que la restauración se realizó correctamente | Confirma que la restauración se realizó correctamente. Precaución Este es un paso necesario, ya que un error de restauración no se notificará en el paso anterior y puede provocar la falta de datos en tu Server. Para ello, revisa el archivo mongoRestore.log en la carpeta MongoDB donde se restauraron los datos. Abre mongoRestore.log y sigue estos pasos:
Si la recuperación falló, o si encuentras algún resultado al buscar las palabras clave enumeradas anteriormente, comunícate con el Servicio de asistencia al cliente con toda la información que recopilaste. No continúes si la restauración de MongoDB falló. |
4.4 | Establecer la ruta de Mongo en RuntimeSettings.XML | Edita el archivo RuntimeSettings.xml e ingresa la ruta de acceso a la carpeta Ejemplo: ![]() Guarda y cierra el editor de texto. |
4.5 | Iniciar MongoDB | Ingresa el comando
Ejemplo
|
No cierres la ventana del símbolo del sistema. Si cierras la ventana del paso 4.5, ninguno de los pasos posteriores funcionará. | ||
<<Inicio de la segunda sección del símbolo del sistema >> | ||
4.6 | Abrir el segundo símbolo del sistema en la carpeta bin | Abre un SEGUNDO símbolo del sistema como administrador y navega hasta la carpeta
|
4.7 | Obtener contraseña de Mongo de no administrador | Introduce el comando y copia tu CONTRASEÑA_DE_MONGO_DE_NO_ADMINISTRADOR en el bloc de notas
|
4.8 | Iniciar línea de comandos de Mongo | Ingresa el comando
Ejemplo
Si el proceso tiene éxito, deberías ver un símbolo “ |
4.9 | Eliminar bloqueos de AlteryxGallery definidos por el Server original | Introduce el comando de Mongo
Si el proceso tiene éxito, deberías ver: " |
4.10 | Cambia a la base de datos de AlteryxService | Introduce el comando de Mongo
|
4.11 | Eliminar bloqueos de AlteryxService definidos por el Server original | Introduce el comando de Mongo
Si el proceso tiene éxito, deberías ver: “ |
4.12 | Sal de la línea de comandos de Mongo y del Símbolo del sistema 2 | Ingresa el comando
Cierra el Símbolo del sistema 2 |
<< Final de la segunda sección del símbolo del sistema >> | ||
4.13 | Detener la base de datos de Mongo | En el símbolo del sistema original, introduce el comando del teclado
una o más veces hasta que salgas de MongoDB y vuelvas a un símbolo del sistema normal. Cierra el símbolo del sistema. |
Paso 5: Restauración de otros archivos y configuraciones
# | Paso | Detalles |
---|---|---|
5.1 | ¿Tenías un Usuario de inicio de sesión de servicio en el Server original? | Establece el Usuario de inicio de sesión de servicio en el nuevo Server. Aplicación de servicios de Windows > haz clic con el botón derecho en AlteryxService > Propiedades > Iniciar sesión |
5.2 | Agregar controladores de datos y DSN del sistema. | Agrega controladores de la misma versión y DSN del sistema del mismo nombre para que coincidan con el servidor original, https://downloads.alteryx.com/. |
Problemas avanzados que pueden no aplicarse a tu recuperación: | ||
5.3 | En entornos más seguros, configura los permisos necesarios de Ejecutar como usuario | Asegúrate de que todas las credenciales utilizadas para ejecutar los flujos de trabajo (Ejecutar como, Inicio de sesión de servicio o credencial establecida al guardar el flujo de trabajo) tengan el acceso adecuado suficiente y configura los permisos de usuario de ejecución necesarios. |
5.4 | Restaurar aliases basados en el sistema y en conexiones en-BD | Conexiones de datos de sistema:
Conexiones de datos en-BD del sistema:
|
5.5 | Restaurar aliases basados en usuarios y en conexiones en-BD de usuarios | Conexiones de datos de usuarios:
Conexiones de datos en-BD de usuario:
|
5.6 | ¿Los flujos de trabajo utilizan Conectores? | Copia las carpetas de Conectores desde el Server original a
Comunícate con el Servicio de asistencia al cliente para habilitar Conectores en tu nuevo Server. |
5.7 | ¿Los flujos de trabajo usan la Herramienta Python? | Vuelve a instalar los paquetes de Python que tenían instalados los flujos de trabajo. Consulta Entorno de la herramienta Python en las actualizaciones de Server |
5.8 | ¿Utilizas SSL? | Si estás recuperando a un Server Sandbox con el propósito de realizar pruebas, utiliza HTTP para realizar pruebas. Si estás migrando a un nuevo Server, vuelve a establecer tu SSL: Configurar SSL/TLS para Server Configurar Alteryx Server para la obtención e instalación de certificados SSL |
Paso 6: Inicio de Alteryx Server
# | Paso | Detalles |
---|---|---|
6.1 | Revisar la configuración del sistema Alteryx y suspender Programaciones si se desea. | Ejecuta la Configuración del sistema de Alteryx y recorre cada página confirmando que la configuración (como el Token de controlador) contiene los valores esperados. Si no deseas que programaciones se ejecuten cuando se inicie el servicio, desactiva: Worker> General > Allow machine to run scheduled Alteryx workflows Cuando seleccionas Finish, AlteryxService debería iniciarse y Server debería estar disponible en un navegador. |
Importante
Presta especial atención a la configuración de Interfaz de usuario de Server, ya que un nuevo Server puede tener una URL diferente o no tener un certificado SSL.

Paso 7: Prueba
# | Paso | Detalles |
---|---|---|
7.1 | Pruebas básicas | ¿Se está ejecutando AlteryxService? Puedes:
|
7.2 | Pruebas específicas de flujo de trabajo | Puedes ejecutar flujos de trabajo que contengan extensiones o conexiones externas, como
|