Skip to main content

Guía de recuperación del host de Server

Esta guía está diseñada para ayudar al administrador del servidor a recuperar una instancia del servidor en caso de fallo de un host o hosts originales, al pasar a un servidor actualizado nuevo, al pasar de un servidor local a un servidor en la nube y en otros casos en los que la infraestructura cambie.

Una recuperación de servidor le permite obtener un nuevo servidor en ejecución con sus usuarios originales, flujos de trabajo, Programaciones, etc., en función de tener lo siguiente de su servidor original:

  • Token del controlador

  • RuntimeSettings.xml del nodo Controlador

  • Copias de seguridad de MongoDB

A continuación se muestran los detalles de cada paso del proceso:

1 - Preparar

2 - Recuperar RuntimeSettings.xml

3 - Recuperar MongoDB

4 - Restaurar otros archivos y configuraciones

5 - Inicie Alteryx Server

6 - Prueba

Dentro del alcance

  • Recuperación de la falla de una sola instalación predeterminada de Server con el uso de MongoDB incrustado .

  • Copia de seguridad disponible con la información necesaria intacta.

  • Los equipos de destino se pueden sobrescribir.

Fuera del alcance

  • Entorno de Server de varios nodos o MongoDB administrado por el usuario: comunícate con el servicio de asistencia al cliente para obtener ayuda.

  • Combinación de las bases de datos de los archivos de conexión.

  • 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

  • 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 para minimizar el tiempo de inactividad.

  • Derechos de administrador en el servidor de destino.

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

  • Accede a RuntimeSettings.xml en el Server original que se encuentra aquí:  %PROGRAMDATA%\Alteryx\RuntimeSettings.xml .

  • Copia de seguridad de MongoDB del Server 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 servidor de destino esté establecido en la misma zona horaria que el servidor 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. Verifica si se ha utilizado la funcionalidad y completa los pasos correspondientes marcados como (Opcional) en esta guía.

  • Usuario de inicio de sesión de servicio, si se utiliza.

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

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

  • Aliases 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 Consulte C:\Users\[nombre de usuario]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

    • Conexiones de datos en base de datos de usuario Consulte C:\Users\[nombre de usuario]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

Paso 1: Prepárese

#

Paso

Detalles

1.1

Ajuste la zona horaria de la máquina

La zona horaria de Windows de la nueva máquina debe establecerse para que coincida con la máquina original.

1.2

Garantizar el acceso a Alteryx

Asegúrate de que la computadora pueda establecer contacto con el dominio web  whitelist.alteryx.com  utilizado por el sistema de licencias de Alteryx.

1.3

Instale la misma versión de Server

Realice una instalación limpia de la misma versión del servidor que generó la copia de seguridad de Mongo.

Utiliza la última versión de mantenimiento del trimestre, por ejemplo, si tu copia de seguridad es de la versión 2022.4. 2 y 2022,4. la versión de mantenimiento 5 está disponible, utiliza esa versión. Si tu versión aún no está disponible en http://downloads.alteryx.com , ponte en contacto con fulfillment@alteryx.com .

Instalar o actualizar Server

Prueba El Interfaz de usuario de Server aparece en un Navegador, no es necesario que inicie sesión.

1.4

Solucionar problemas

Error de clave de licencia en uso

Si su clave de licencia sigue vinculada a su antiguo servidor, deberá desactivarla en ese equipo. Si no se puede acceder a ese equipo, póngase en contacto con el administrador de licencias para liberar la licencia.

Paso 2: Recuperar RuntimeSettings.xml

#

Paso

Detalles

2.1

Abra el símbolo del sistema 1 en la carpeta bin

Abra un símbolo del sistema como administrador y vaya a la carpeta Alteryx\bin, introduzca los comandos a continuación (ajuste en función de la ubicación de instalación).

c: cd \Archivos de programa\Alteryx\bin

2.2

Detenga el servicio

Introduzca el comando

Comando: net stop alteryxservice

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

2.3

Realice una copia de seguridad de RuntimeSettings.xml existente

Introduzca el comando

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

2.4

Restaurar RuntimeSettings.xml

Copie el archivo RuntimeSettings.xml desde el servidor original al %ProgramData%\Alteryx\ Directorio actual .

2.5

Token de controlador faltante

Edita el 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

Guarde y cierre el archivo.

2.6

Token de controlador ausente

Introduzca el comando utilizando la Token de controlador del 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 in CryptImportKey(3): Bad Data. (-2146893819)". Para corregir esto, consulta el paso anterior para asegurar que el valor se eliminó de entre las etiquetas.

2.7

Restaurar claves de cifrado

Es posible que el valor de <StorageKeysEncrypted> haya cambiado cuando se restableció el token de controlador en el paso 2.6. Si es así, se debe reemplazar con el valor del archivo RuntimeSettings.xml original. 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 3 .

Step 2.7 Restore Encryption Keys

2.8

Usuario en modo de ejecución

Si tenía un comando Ejecutar como usuario en el servidor original, introduzca el siguiente comando; de lo contrario, omita este paso. AlteryxService.exe setexecuteuser=NOMBRE,DOMINIO,CONTRASEÑA

2.9

Restaurar contraseña SMTP

Si ha rellenado Configuración del sistema Alteryx > Interfaz de usuario de Server > SMTP > Contraseña (incluso si la casilla de verificación SMTP estaba desactivada), introduzca el siguiente comando; de lo contrario, omita este paso. AlteryxService.exe setsmtppassword=PASSWORD

2.10

Ahorre RuntimeSettings.xml

Guarde el archivo RuntimeSettings.xml.

2.11

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 nodo Controlador del Server original, y el nuevo Server 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.Proceso de transferencia de clave de cifrado

2.12

Permanezca en la línea de comandos

Para el paso 3, se supone que estás en una línea de comandos de administrador en la carpeta  \Alteryx\bin .

Paso 3: Recuperar MongoDB

#

Paso

3.1

Obtener copia de seguridad de MongoDB

Copie la copia de seguridad de Mongo desde el servidor original a una carpeta MONGO_BACKUP en su nuevo servidor.

3.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. El parámetro final, “ ,10 ”, garantiza un menor uso de memoria por parte de MongoDB durante la restauración. Esto reduce la posibilidad de errores fuera de memoria, pero podría aumentar el tiempo de restauración. No usar el ,10 podría producir restauraciones más rápidas. En cualquier caso, revisa mongoRestore.log como se describe a continuación para asegurarte de que la restauración se haya realizado correctamente.

AlteryxService.exe emongorestore="MONGO_BACKUP_FOLDER","MONGO_RESTORE_FOLDER",10

Ejemplo:

AlteryxService.exe emongorestore="D:\db_bkp","%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore",10

3.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 técnica con toda la información que recopilaste.

No continúes si la restauración de MongoDB falló.

3.4

Establezca la ruta de Mongo en RuntimeSettings.XML

Edita 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

Guarde y cierre el editor de texto.

3.5

Inicie MongoDB

Introduzca el comando

Mongod ––dbpath “MONGO_RESTORE_FOLDER” ––auth ––port 27018

Ejemplo

Mongod ––dbpath “%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore” ––auth ––port 27018

No cierre la ventana del símbolo del sistema.

Si cierras la ventana del paso 3.5, ninguno de los pasos posteriores funcionará.

<< Inicio de la segunda sección del símbolo del sistema >>

3.6

Abra el segundo símbolo del sistema en la carpeta bin

Abra un SEGUNDO símbolo del sistema como Administrador y navegue a la carpeta Alteryx\bin, ingrese los comandos a continuación (ajuste en función de su ubicación de instalación).

c: cd \Archivos de programa\Alteryx\bin

3.7

Obtener contraseña de Mongo sin administrador

Introduzca el comando y copie su NON_ADMIN_MONGO_PASSWORD en el Bloc de notas

AlteryxService.exe getemongopassword

3.8

Inicie Mongo Command Line

Introduzca el comando

mongo mongodb://SERVER:PORT/AlteryxGallery -u usuario -p NON_ADMIN_MONGO_PASSWORD

Ejemplo

mongo mongodb://localhost:27018/AlteryxGallery -u usuario -p CCEC***33C0

Cuando se realice correctamente, debería aparecer un mensaje >.

3.9

Eliminar bloqueos definidos por el servidor original

Introduzca el comando Mongo

db.locks.remove({})

En caso de éxito, debería ver: ' WriteResult({ “nremoved” : N }) ', donde N es un número entre 0 y 3.

3.10

Salga de Mongo Command Line y Command Prompt 2

Introduzca el comando

Salir

Cierre Command_Prompt_2

<< Final de la segunda sección del símbolo del sistema >>

3.11

Detenga la base de datos de Mongo

En el símbolo del sistema original, introduzca el comando del teclado

ctrl-c

Una o más veces hasta que salga de MongoDB y vuelva a un símbolo del sistema normal.

Cierra ambos símbolos del sistema.

Paso 4: Restaurar otros archivos y configuraciones

#

Paso

Detalles

4.1

¿Tenía un usuario de inicio de sesión de servicio en el servidor original?

Establecer el usuario de inicio de sesión de servicio en el nuevo servidor.

Aplicación Servicios de Windows > Haga clic con el botón derecho en AlteryxService > Propiedades > Iniciar sesión

4.2

Agregue controladores de datos y DSN del sistema.

Agregue 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 su recuperación:

4.3

En entornos más seguros, configure los permisos de usuario Run as necesarios.

Asegúrese de que todas las credenciales utilizadas para ejecutar flujos de trabajo (Ejecutar como, Conexión de servicio o conjunto de credenciales al guardar Flujo de trabajo) tienen acceso suficiente y configure los permisos de usuario de ejecución necesarios .

4.4

Restaurar Alias de Conexión Basados en el Sistema y en la Base de Datos

No hay conexiones de datos.

%ProgramData%\Alteryx\Engine\SystemAlias.xml

Conexiones de Datos en Base de Datos del Sistema:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

4.5

Restauración de Alias de Conexión Basados en Usuario y de Usuario en Base de Datos

No hay conexiones de datos.

C:\Users\[nombre de usuario]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

Conexiones de Datos en Base de Datos de Usuario:

C:\Users\[nombre de usuario]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

4.6

¿Los flujos de trabajo utilizan Conectores?

Copie las carpetas de Connector desde el servidor original a.

\ProgramData\Alteryx\Tools

Póngase en contacto con Servicio de asistencia al cliente para habilitar Conectores en su nuevo servidor.

4.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 Server Upgrade Python Tool Environment Checklist.

4.8

¿Los flujos de trabajo utilizan la herramienta R?

Próximamente…

4.9

¿Tiene un entorno multi-nodo o Mongo administrado por el usuario?

(Próximamente) Póngase en contacto con su ejecutivo de cuentas o Servicio de asistencia al cliente.

4.10

¿Utiliza SSL?

Si se está recuperando en un servidor Sandbox para realizar pruebas, utilice HTTP para realizar pruebas.

Si está migrando a un nuevo servidor, vuelva a establecer su SSL:

Configurar SSL/TLS para Server

Configuración de Alteryx Server para la obtención e instalación de certificados SSL (15577)

Paso 5: Inicie el Alteryx Server

#

Paso

Detalles

5.1

Revise la configuración del sistema Alteryx y suspenda Programaciones si lo desea.

Ejecute Configuración del sistema de Alteryx y pase por cada página confirmando que la configuración (como Token de controlador) contiene los valores esperados.

Si no desea que Programaciones se ejecute cuando se inicie el servicio, desactive:

trabajador > General > Permitir que la máquina ejecute flujos de trabajo de Alteryx programados

Cuando seleccionas Finish , AlteryxService debería iniciarse y Server debería estar disponible en un navegador.

Importante

Preste especial atención a la configuración de Interfaz de usuario de Server, ya que un nuevo servidor puede tener una URL diferente o no tener un certificado SSL.

System Settings, the Server UI configuration section.

Paso 6: Prueba

#

Paso

Detalles

6.1

Pruebas básicas

¿Se está ejecutando AlteryxService ?

¿Puede usted:

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

  • ¿Desea desplazarse por las páginas de administración y ver los usuarios, las colecciones, etc.?

  • ¿Publicar un Flujo de trabajo de Designer en el servidor?

  • Ejecuta el flujo de trabajo:

  • Si la configuración lo permite, guarde y ejecute un Flujo de trabajo especificando sus credenciales.

6.2

Pruebas específicas del flujo de trabajo

Puede 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 la categoría Conectores

  • Descripción de Alteryx Location & Business Insights

  • Herramienta Python

  • Herramienta R