Skip to main content

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:

1: Preparación

2: Instalar Alteryx Server

3: Recuperación de RuntimeSettings.xml

4: Recuperación de MongoDB

5: Restauración de otros archivos y configuraciones

6: Inicio de Alteryx Server

7: Prueba

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?

  • 2022.1.1.40869 (Parche 2) o cualquier parche anterior

  • 2021.4.2.47792 (Parche 4) o cualquier parche anterior

  • 2021.3 y todas las versiones anteriores

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 Alteryx\bin e introduce los siguientes comandos (ajústalos en función de la ubicación de tu instalación).

c:

cd \Program Files\Alteryx\bin

3.2

Detener el servicio

Ingresa el comando

net stop alteryxservice

Si el proceso tiene éxito, deberías ver “El servicio AlteryxService se detuvo correctamente”.

3.3

Realizar una copia de seguridad de RuntimeSettings.xml existente

Ingresa el comando

c:

cd \ProgramData\Alteryx ren RuntimeSettings.xml RuntimeSettings_BACKUP.xml

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?

: tu RuntimeSettings.xml del proceso de recuperación en caso de desastre ya debería estar ubicado en el directorio %ProgramData%\Alteryx\ de tu host objetivo. Si no es así, copia el archivo RuntimeSettings.xml preparado en %ProgramData%\Alteryx\.

Ve al paso 3.13.

NO: copia el archivo RuntimeSettings.xml desde tu host original al directorio %ProgramData%\Alteryx\ del host objetivo.

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:

64ae505fe2c2c.png

Guarda y cierra el archivo.

3.6

Restaurar el Token de controlador

Introduce el comando utilizando tu token de controlador de servidor original

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

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 <StorageKeysEncrypted> haya cambiado cuando se restableció el token de controlador en el paso 3.6. Si es así, se debe reemplazar con el valor correspondiente del archivo RuntimeSettings.xml original. Este es el archivo de origen RuntimeSettings.xml que se copió en el paso 3.4. También es más fácil copiar las etiquetas para garantizar que todo el valor entre ellas se copie del archivo RuntimeSettings.xml original. Puedes dejar RuntimeSettings.xml abierto en un editor de texto a medida que realizas más cambios en el paso 4.

Step 2.7 Restore Encryption Keys

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.AlteryxService.exe setexecuteuser=NAME,DOMAIN,PASSWORD

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.AlteryxService.exe setsmtppassword=PASSWORD

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?

  • 2022.1.1.40869 (Parche 2) o cualquier parche anterior

  • 2021.4.2.47792 (Parche 4) o cualquier parche anterior

  • 2021.3 y todas las versiones anteriores

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:

  • 2021.4.2, parche 11 en adelante

  • 2022.1, parche 9 en adelante

  • 2022.3, parche 6 en adelante

  • 2023.1, parche 2 en adelante

  • 2023.2 con disponibilidad general en adelante

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 \Alteryx\bin.

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 MONGO_BACKUP en tu nuevo host.

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:

  • Confirma que indica #### document(s) restored successfully, 0 document(s) failed to restore en la última línea.

  • Busca por error, critical, fatal y failed. Si vas a buscar un error failed, asegúrate de que el resultado sea diferente de la oración en el punto anterior, que contiene 0 document(s) failed.

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 MONGO_RESTORE_FOLDER en la etiqueta <EmbeddedMongoDBRootPath>.

Ejemplo:

Set Mongo path in RuntimeSettings.XML

Guarda y cierra el editor de texto.

4.5

Iniciar MongoDB

Ingresa el comando

mongod ––dbpath "MONGO_RESTORE_FOLDER" ––auth ––port 27018

Ejemplo

mongod ––dbpath "%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore" ––auth ––port 27018

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 Alteryx\bin, introduce los siguientes comandos (ajústalos en función de la ubicación de tu instalación).

c:

cd \Program Files\Alteryx\bin

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

AlteryxService.exe getemongopassword

4.8

Iniciar línea de comandos de Mongo

Ingresa el comando

mongosh mongodb://SERVER:PORT/AlteryxGallery -u user -p CONTRASEÑA_DE_MONGO_DE_NO_ADMINISTRADOR

Ejemplo

mongosh mongodb://localhost:27018/AlteryxGallery -u user -p CCEC***33C0

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

db.locks.remove({})

Si el proceso tiene éxito, deberías ver: "writeResult({ “nRemoved” : N })", en el que N es un número entre 0 y 3.

4.10

Cambia a la base de datos de AlteryxService

Introduce el comando de Mongo

utiliza AlteryxService

4.11

Eliminar bloqueos de AlteryxService definidos por el Server original

Introduce el comando de Mongo

db.locks.remove({})

Si el proceso tiene éxito, deberías ver: “writeResult({ “nRemoved” : N })”, en el que N es un número entre 0 y 3.

4.12

Sal de la línea de comandos de Mongo y del Símbolo del sistema 2

Ingresa el comando

exit

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

ctrl-c

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.Configurar permisos necesarios de Ejecutar como usuario

5.4

Restaurar aliases basados en el sistema y en conexiones en-BD

Conexiones de datos de sistema:

%ProgramData%\Alteryx\Engine\SystemAlias.xml

Conexiones de datos en-BD del sistema:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

5.5

Restaurar aliases basados en usuarios y en conexiones en-BD de usuarios

Conexiones de datos de usuarios:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

Conexiones de datos en-BD de usuario:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

5.6

¿Los flujos de trabajo utilizan Conectores?

Copia las carpetas de Conectores desde el Server original a

%ProgramData%\Alteryx\Tools

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.

System Settings, the Server UI configuration section.

Paso 7: Prueba

#

Paso

Detalles

7.1

Pruebas básicas

¿Se está ejecutando AlteryxService?

Puedes:

  • ¿Acceder a la URL de Interfaz de usuario de Server?

  • ¿Desplazarte 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, guarda y ejecuta un flujo de trabajo especificando tus credenciales.

7.2

Pruebas específicas de flujo de trabajo

Puedes ejecutar flujos de trabajo que contengan extensiones o conexiones externas, como

  • Entrada/salida a una ruta UNC de red

  • Conexiones de base de datos

  • Herramientas de conectores

  • Conjunto de datos de Location y Business Insights (ubicación o insights empresariales)

  • Herramienta Python

  • Herramienta R