Guía de recuperación del host de Server

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.

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:

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 Storage Keys Encrypted

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. Si es necesario, abre ProgramData%\Alteryx\RuntimeSettings.xml en tu máquina original para obtener el valor necesario. 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 .

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

Transferir la Clave de cifrado

Esta funcionalidad solo está disponible en las siguientes versiones:

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 .

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:

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:

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

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

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.

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

Comunícate con el Servicio de asistencia al cliente para habilitar Conectores en tu nuevo Server.

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) Contáctate con tu ejecutivo de cuentas o el 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)

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.

6.1

Pruebas básicas

¿Se está ejecutando AlteryxService ?

¿Puede usted:

6.2

Pruebas específicas del flujo de trabajo

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