Guide de récupération de l'hôte de Server

1.1

Définir le fuseau horaire de l'hôte

Le fuseau horaire Windows de l'hôte cible doit correspondre à celui de l'hôte d'origine.

1.2

Assurer l'accès à Alteryx

Assurez-vous que l'hôte peut contacter whitelist.alteryx.com, utilisé par le système de licences Alteryx.

3.1

Ouvrir l'invite de commande 1 dans le dossier « bin »

Ouvrez une invite de commande en tant qu'administrateur et accédez au dossier Alteryx\bin, saisissez les commandes ci-dessous (à ajuster en fonction de votre emplacement d'installation).

c:

cd \Program Files\Alteryx\bin

3.2

Arrêter le service

Saisissez la commande

net stop alteryxservice

En cas de succès, vous devriez voir le message « The AlteryxService service was stopped successfully. »

3.3

Sauvegarder le fichier RuntimeSettings.xml existant

Saisissez la commande

c:

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

3.4

Disposez-vous d'un fichier RuntimeSettings.xml préalablement préparé sur votre hôte cible à partir d'une préparation à la récupération après incident ?

OUI : votre fichier RuntimeSettings.xml du processus de reprise après incident doit déjà se trouver dans le répertoire %ProgramData%\Alteryx\ de votre hôte cible. Si ce n'est pas le cas, copiez le fichier RuntimeSettings.xml préparé dans %ProgramData%\Alteryx\.

Passez à l'étape 3.13.

NON : Copiez le fichier RuntimeSettings.xml depuis votre hôte d'origine dans le répertoire %ProgramData%\Alteryx\ de l'hôte cible actuel.

Continuez à l'étape 3.5.

3.5

Effacer le jeton contrôleur

Modifiez le fichier RuntimeSettings.xml que vous venez de copier et supprimez tout ce qui se trouve entre les balises <ServerSecretEncrypted>, en ne laissant que les balises comme indiqué ci-dessous :

Enregistrez et fermez le fichier.

3.6

Restaurer le jeton contrôleur

Saisissez la commande à l'aide du jeton contrôleur de votre Server d'origine.

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

Dépannage :

La version 2021.3+ peut produire une erreur à cette étape : « Set server secret failed: Error in CryptImportKey(3): Bad Data. (-2146893819) ». Pour corriger ce problème, reportez-vous à l'étape précédente pour vous assurer que la valeur a bien été retirée entre les balises.

3.7

Restaurer les clés de stockage chiffrées

La valeur <StorageKeysEncrypted> a peut-être changé lorsque le jeton contrôleur a été réinitialisé à l'étape 3.6. Si c'est le cas, elle doit être remplacée par la valeur correspondante du fichier RuntimeSettings.xml d'origine. Il s'agit du fichier source RuntimeSettings.xml qui a été copié à l'étape 3.4. Il est également plus facile de copier les balises pour s'assurer que la valeur entière entre elles est copiée à partir du fichier RuntimeSettings.xml d'origine. Vous pouvez laisser RuntimeSettings.xml ouvert dans un éditeur de texte lorsque vous apportez d'autres modifications à l'étape 4.

3.8

Restaurer la fonction Exécuter en tant qu'utilisateur

Si vous disposiez de la fonction Exécuter en tant qu'utilisateur sur l'hôte d'origine, saisissez la commande ci-après. Sinon, ignorez cette étape.AlteryxService.exe setexecuteuser=NAME,DOMAIN,PASSWORD

3.9

Restaurer le mot de passe SMTP

Si vous avez renseigné Paramètres système Alteryx > Server UI (Interface utilisateur Server) > SMTP > Password (Mot de passe) (même si la case à cocher SMTP n'a pas été cochée), saisissez la commande suivante. Sinon, ignorez cette étape.AlteryxService.exe setsmtppassword=PASSWORD

3.10

Enregistrer RuntimeSettings.xml

Enregistrez le fichier RuntimeSettings.xml.

3.11

La version de Alteryx Server sur votre hôte d'origine est-elle l'une des versions suivantes ?

OUI : passez à l'étape 3.13.

NON : continuez à l'étape 3.12.

3.12

Transférer la clé de chiffrement

Cette fonctionnalité n'est disponible que dans les versions suivantes :

Important : Veuillez noter qu'AlteryxService doit être exécuté sur votre nœud d'hôte d'origine et que votre hôte cible doit pouvoir y accéder via le réseau.

Les étapes décrites dans la section Processus de transfert de la clé de chiffrement vous permettent de transférer la clé de chiffrement de votre contrôleur existant vers votre nouveau contrôleur.

3.13

Rester sur la ligne de commande

Pour l'étape 4, vous devez vous trouver dans une ligne de commande Administrateur dans le dossier \Alteryx\bin.

4.1

Obtenir la sauvegarde MongoDB

Copiez la sauvegarde Mongo de l'hôte d'origine vers un dossier MONGO_BACKUP sur votre nouvel hôte.

4.2

Restaurer dans un nouveau dossier

Restaurez la base de données Mongo depuis le dossier de sauvegarde vers un nouveau dossier de restauration. Consultez le fichier mongoRestore.log comme décrit ci-dessous pour vérifier que la restauration s'est correctement effectuée.

Reportez-vous à la section Effectuer une restauration à partir d'une sauvegarde MongoDB dans le document Sauvegardes MongoDB pour trouver la commande de restauration correspondant à votre version de Server.

4.3

Vérifier que la restauration a réussi

Vérifiez que la restauration a réussi.

Attention

Il s'agit d'une étape nécessaire, car un échec de restauration ne sera pas signalé à l'étape précédente et peut entraîner une perte de données sur votre Server. Pour vérifier la restauration, consultez le fichier mongoRestore.log dans le dossier MongoDB où les données ont été restaurées. Ouvrez le fichier mongoRestore.log et procédez comme suit :

Si la récupération a échoué, ou si vous trouvez des résultats lorsque vous recherchez les mots clés énumérés ci-dessus, veuillez contacter le service clientèle avec toutes les informations que vous avez recueillies.

Ne poursuivez pas si la restauration MongoDB a échoué.

4.4

Définir le chemin Mongo dans RuntimeSettings.XML

Modifiez le fichier RuntimeSettings.xml et saisissez le chemin d'accès au dossier MONGO_RESTORE_FOLDER dans la balise <EmbeddedMongoDBRootPath>.

Exemple :

Enregistrez et fermez l'éditeur de texte.

4.5

Démarrer MongoDB

Saisissez la commande

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

Exemple

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

Ne fermez pas la fenêtre d'invite de commande.

Si vous fermez la fenêtre à partir de l'étape 4.5, aucune des étapes suivantes ne fonctionnera.

<< Début de la section de la deuxième invite de commande >>

4.6

Ouvrir la deuxième invite de commande dans le dossier « bin »

Ouvrez une DEUXIÈME invite de commande en tant qu'administrateur et accédez au dossier Alteryx\bin, saisissez les commandes ci-dessous (à ajuster en fonction de votre emplacement d'installation).

c:

cd \Program Files\Alteryx\bin

4.7

Obtenir le mot de passe Mongo non administrateur

Saisissez la commande et copiez votre MOT DE PASSE MONGO NON ADMINISTRATEUR dans Notepad

AlteryxService.exe getemongopassword

4.8

Démarrer la ligne de commande Mongo

Saisissez la commande

mongosh mongodb://SERVER:PORT/AlteryxGallery -u user -p NON_ADMIN_MONGO_PASSWORD

Exemple

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

En cas de succès, vous devriez voir l'invite « > ».

4.9

Supprimer les verrous AlteryxGallery définis par le Server d'origine

Saisissez la commande Mongo

db.locks.remove({})

En cas de succès, le message suivant devrait s'afficher : « writeResult({ “nRemoved” : N }) », où N est un nombre compris entre 0 et 3.

4.10

Basculer vers la base de données AlteryxService

Saisissez la commande Mongo

utiliser AlteryxService

4.11

Supprimer les verrous AlteryxService définis par le Server d'origine

Saisissez la commande Mongo

db.locks.remove({})

En cas de succès, le message suivant devrait s'afficher : « writeResult({ “nRemoved” : N }) », où N est un nombre compris entre 0 et 3.

4.12

Quitter la ligne de commande Mongo et l'invite de commande 2

Saisissez la commande

exit

Fermez Command_Prompt_2

<<Fin de la section de la deuxième invite de commande >>

4.13

Arrêter la base de données Mongo

Dans l'invite de commande d'origine, saisissez la commande clavier

ctrl-c

une ou plusieurs fois jusqu'à ce que vous quittiez MongoDB et reveniez à une invite de commande normale.

Fermez l'invite de commande.

5.1

Aviez-vous un utilisateur de connexion au service sur le Server d'origine ?

Définissez l'utilisateur de connexion au service sur le nouveau Server.

Application Windows Services > clic droit sur AlteryxService > Propriétés > Connexion

5.2

Ajouter des pilotes de données et des DSN système

Ajoutez des pilotes de même version et des DSN système de même nom pour correspondre au Server d'origine, https://downloads.alteryx.com/.

Problèmes avancés qui peuvent ne pas s'appliquer à votre récupération :

5.3

Dans des environnements plus sécurisés, configurez les autorisations Exécuter en tant qu'utilisateur requises.

Toutes les informations d'identification utilisées pour exécuter les workflows (Exécuter en tant que, Connexion au service ou l'ensemble d'informations d'identification lors de l'enregistrement du workflow) doivent disposer d'un accès suffisant. Configurer les autorisations d'exécution utilisateur requises.Configurer les autorisations Exécuter en tant qu'utilisateur requises

5.4

Restaurer les alias de connexion basés sur le système et en base de données

Connexion aux données système :

%ProgramData%\Alteryx\Engine\SystemAlias.xml

Connexion aux données en base de donnée système :

%ProgramData%\Alteryx\Engine\SystemConnections.xml

5.5

Restaurer les alias de connexion basés sur l'utilisateur et en base de données

Connexion aux données utilisateur :

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

Connexion aux données utilisateur en base de données :

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

5.6

Les workflows utilisent-ils des connecteurs ?

Copiez les dossiers de connecteurs de votre Server d'origine vers

%ProgramData%\Alteryx\Tools

Contactez le service clientèle pour activer les Connecteurs sur votre nouveau Server.

5.7

Les workflows utilisent-ils l'outil Python ?

Réinstallez tous les packages Python que les workflows avaient installés. Voir Environnement de l'outil Python dans les mises à niveau de Server.

5.8

Utilisez-vous SSL ?

Si vous effectuez une récupération vers un Server Sandbox pour des tests, utilisez HTTP pour les tests.

Si vous migrez vers un nouveau Server, rétablissez votre SSL :

Configurer SSL/TLS pour Server

Configuration d'Alteryx Server pour SSL : obtention et installation de certificats

6.1

Vérifier les paramètres système Alteryx et suspendre les Planifications, si souhaitable

Exécutez les paramètres système Alteryx et parcourez chaque page pour vérifier que les paramètres (comme le jeton contrôleur) contiennent les valeurs attendues.

Si vous ne souhaitez pas que les Planifications s'exécutent au démarrage du service, décochez :

Worker > General (Général) > Allow machine to run scheduled Alteryx workflows (Autoriser la machine à exécuter les workflows Alteryx planifiés)

Lorsque vous sélectionnez Finish (Terminer), AlteryxService doit démarrer et le Server doit être disponible dans un navigateur.

7.1

Tests de base

AlteryxService est-il en cours d'exécution ?

Pouvez-vous :

7.2

Tests spécifiques aux workflows

Pouvez-vous exécuter des workflows contenant des extensions ou des connexions externes, telles que :