Skip to main content

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

Ce guide est destiné à aider un administrateur de serveur à restaurer une instance de serveur en cas de défaillance d'un ou plusieurs hôtes d'origine, lors du passage à un nouveau serveur mis à niveau, du passage d'un serveur local à un serveur cloud et dans d'autres cas où votre infrastructure change.

Une récupération de serveur vous permet d'exécuter un nouveau serveur avec vos utilisateurs d'origine, workflows, planifications, etc., en vous basant sur les éléments suivants de votre serveur d'origine :

  • Jeton de contrôleur

  • RuntimeSettings.xml depuis le nœud du contrôleur

  • Sauvegardes MongoDB

Vous trouverez ci-dessous des détails pour chaque étape du processus :

1 - préparer

2 - récupérer RuntimeSettings.xml

3 - récupérer MongoDB

4 - Restaurer d'autres fichiers et paramètres

5 - Démarrer Alteryx Server

6 - essai

Champ d'application

  • Récupération à la suite de l'échec d'une installation unique et par défaut de Server en utilisant Mongodb intégré .

  • Sauvegarde disponible avec les informations nécessaires intactes.

  • Les machines cibles peuvent être écrasées.

Hors champ d'application

  • Environnement Server à plusieurs nœuds ou MongoDB géré par l'utilisateur. Contactez le service clientèle pour obtenir de l'aide.

  • Fusion de bases de données de fichiers de connexion.

  • Sauvegarde ou restauration des pilotes ODBC.

  • Sauvegarde ou restauration des DSN utilisateur ou système.

  • Sauvegarde ou restauration d'autres alias stockés dans Windows qui existent en dehors d'Alteryx.

Conditions préalables

  • Installez tous les pilotes de base de données et les logiciels nécessaires au fonctionnement du workflow avant de suivre les étapes décrites dans ce guide afin de réduire les temps d'arrêt.

  • Droits d'administrateur sur le serveur cible.

  • Accès à tous les identifiants utilisés pour l'emprunt d'identité, y compris le compte de service (si ce n'est pas le système local), l'utilisateur « Exécuter en tant que » et tous les identifiants de workflow définis/utilisés.

  • Jeton contrôleur du Server d'origine.

  • Accès au fichier RuntimeSettings.xml du Server d'origine situé dans : %PROGRAMDATA%\Alteryx\RuntimeSettings.xml .

  • Sauvegarde de MongoDB à partir du Server d'origine. Découvrez comment effectuer une sauvegarde.

    • Pour en savoir plus sur la sauvegarde et la récupération de Server, consultez la page Bonnes pratiques de sauvegarde et de restauration de Server : partie 1 et partie 2 .

  • Vérifiez que le serveur cible est défini sur le même fuseau horaire que le serveur d'origine dans les paramètres de fuseau horaire Windows. S'il n'est pas défini sur le même fuseau horaire, cela peut entraîner des erreurs dans les vues de planification.

Facultatif

Les éléments suivants n'ont peut-être pas été utilisés dans le Server d'origine. Vérifiez si la fonctionnalité a été utilisée et suivez les étapes correspondantes marquées comme (Facultatif) du présent guide.

  • Utilisateur de connexion au service, le cas échéant.

  • Informations sur l'utilisateur « Exécuter en tant que » pour la configuration de Worker :

    • Domaine

    • Nom d'utilisateur

    • Mot de passe

  • Nom d'utilisateur et mot de passe du serveur SMTP pour la configuration de Server.

  • Connecteurs de %ProgramData%\Alteryx\Tools .

  • Alias de connexion système Alteryx et en base de données du Server d'origine.

    • Connexions de données système en base de données , voir le fichier  %PROGRAMDATA%\Alteryx\Engine\SystemConnections.xml

    • Connexions de données système, voir le fichier  %PROGRAMDATA%\Alteryx\Engine\SystemAlias.xml

  • Alias de connexion Alteryx basés sur l'utilisateur et en base de données du Server d'origine : les informations ci-dessous peuvent être pertinentes pour chaque compte utilisateur avec identifiants de workflow ou « Exécuter en tant que ».

    • Connexions de données utilisateur, voir C :\Users\[nom d'utilisateur]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

    • Connexions de données de l'utilisateur dans la base de données, voir C :\Users\[nom d'utilisateur]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

Étape 1 : préparer

#

Étape

Détails

1.1

Définir le fuseau horaire de la machine

Le fuseau horaire Windows de la nouvelle machine doit être défini pour correspondre à celui de la machine d'origine.

1.2

Assurer l'accès à Alteryx

Assurez-vous que l'ordinateur peut contacter le domaine Web whitelist.alteryx.com utilisé par le système de licences Alteryx.

1.3

Installez la même version de Server

Effectuez une installation propre de la même version du serveur qui a généré la sauvegarde Mongo.

Utilisez la dernière version de maintenance pour le trimestre, par exemple, si votre sauvegarde est à partir de la version 2022.4. 2 et 2022.4. la version de maintenance 5 est disponible, utilisez cette version. Si votre version n'est pas encore disponible sur http://downloads.alteryx.com , veuillez contacter fulfillment@alteryx.com .

Installation ou mise à niveau de Server

Test l'interface utilisateur du serveur apparaît dans un navigateur, vous n'avez pas besoin de vous connecter.

1.4

Résoudre des problèmes

Erreur de clé de licence « en cours d'utilisation »

Si votre clé de licence est toujours liée à votre ancien serveur, vous devrez la désactiver sur cette machine. Si cette machine est inaccessible, contactez votre administrateur de licences pour libérer la licence.

Étape 2 : récupérer RuntimeSettings.xml

#

Étape

Détails

2.1

Ouvrez l'invite de commande 1 dans le dossier bin

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

Program Files\Alteryx\bin.

2.2

Arrêtez le service

Entrez la commande

Commande : net stop alteryxservice

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

2.3

Sauvegarde existante RuntimeSettings.xml

Entrez la commande

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

2.4

Restauration RuntimeSettings.xml

Copiez le fichier RuntimeSettings.xml de votre serveur d'origine dans le répertoire %ProgramData%\Alteryx\ actuel.

2.5

Jeton de contrôleur manquant

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 indiquées ci-dessous :

64ae505fe2c2c.png

Enregistrez et fermez le fichier.

2.6

Jeton de contrôleur manquant

Entrez la commande à l'aide de votre jeton de contrôleur de serveur d'origine

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

Résolution des problèmes

Version 2021.3+ erreur CAN à cette étape avec: "Échec de la définition du secret du serveur : erreur dans CryptImportKey(3): données incorrectes. (-2146893819) ». Pour corriger ce problème, reportez-vous à l'étape précédente pour vous assurer que la valeur a été supprimée entre les balises.

2.7

Restaurer les clés de cryptage

La valeur <StorageKeysEncrypted> a peut-être changé lors de la réinitialisation du jeton contrôleur à l'étape 2.6. Si c'est le cas, elle doit être remplacée par la valeur du fichier RuntimeSettings.xml d'origine. 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 3 .

Step 2.7 Restore Encryption Keys

2.8

Exécuter en tant qu'utilisateur

Si vous aviez un Exécuter en tant qu'utilisateur sur le serveur d'origine, entrez la commande suivante, sinon ignorez cette étape. AlteryxService.exe setexecuteuser=NOM, DOMAINE, MOT DE PASSE

2.9

Restaurer le mot de passe SMTP

Si vous avez renseigné Paramètres système Alteryx > interface utilisateur du serveur > SMTP > Mot de passe (même si la case SMTP n'était pas cochée), entrez la commande suivante, sinon ignorez cette étape. AlteryxService.exe setsmtppassword=MOT DE PASSE

2.10

Économisez RuntimeSettings.xml

Enregistrez le fichier RuntimeSettings.xmli.

2.11

Clé de chiffrement

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

  • 2021.4.2 Correctif 11+

  • 2022.1 Correctif 9+

  • 2022.3 Correctif 6+

  • 2023.1 Correctif 2+

  • 2023.2 GA+

Important

Veuillez noter qu'AlteryxService doit être exécuté sur votre nœud de contrôleur du Server d'origine et que votre nouveau Server 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.Processus de transfert de la clé de chiffrement

2.12

Restez sur la ligne de commande

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

Étape 3 : récupérer MongoDB

#

Étape

3.1

Obtenez la sauvegarde MongoDB

Copiez la sauvegarde Mongo du serveur d'origine vers un dossier MONGO_BACKUP sur votre nouveau serveur.

3.2

Restaurer dans un nouveau dossier

Restaurez la base de données Mongo depuis le dossier de sauvegarde vers un nouveau dossier de restauration. Le dernier paramètre, «  ,10  », garantit une utilisation inférieure de la mémoire par MongoDB pendant la restauration. Ce paramètre réduit le risque d'erreurs de mémoire insuffisante, mais peut augmenter le temps de restauration. Si vous supprimez «  ,10  », les restaurations seront plus rapides. Dans les deux cas, consultez le fichier mongoRestore.log comme décrit ci-dessous pour vérifier que la restauration s'est correctement effectuée.

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

Exemple :

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

3.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 :

  • Vérifiez que le fichier indique #### document(s) restored successfully, 0 document(s) failed to restore à la dernière ligne.

  • Recherchez les termes error , critical , fatal et failed . Si vous recherchez le terme failed , assurez-vous que le résultat ne correspond pas à la phrase du point précédent, qui contient 0 document(s) failed .

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 support avec toutes les informations que vous avez recueillies.

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

3.4

Définissez 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 :

Set Mongo path in RuntimeSettings.XML

Enregistrez et fermez l'éditeur de texte.

3.5

Démarrez MongoDB

Entrez 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 3.5, aucune des étapes suivantes ne fonctionnera.

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

3.6

Ouvrez la deuxième invite de commandes dans le dossier bin

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

Program Files\Alteryx\bin.

3.7

Obtenir le mot de passe Mongo non-Admin

Entrez la commande et copiez votre MOT DE PASSE NON_ADMIN_MONGO_PASSWORD dans le Bloc-notes

AlteryxService.exe getemongopassword

3.8

Démarrez Mongo Command Line

Entrez la commande

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

Exemple

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

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

3.9

Supprimer les verrous définis par le serveur d'origine

Entrez la commande Mongo

db.locks.remove({})

En cas de succès, vous devriez voir : " writeResult({ “nRemoved” : N }) ", où N est un nombre compris entre 0 et 3.

3.10

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

Entrez la commande

Quitter

Fermez Command_Prompt_2

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

3.11

Arrêtez la base de données Mongo

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

ctrl-c

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

Fermez les deux invites de commande.

Étape 4 : restaurez d'autres fichiers et paramètres

#

Étape

Détails

4.1

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

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

Application Services Windows > cliquez avec le bouton droit de la souris sur AlteryxService > Propriétés > Ouvrir une session

4.2

Ajoutez 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 serveur d'origine, https://downloads.alteryx.com/ .

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

4.3

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

Assurez-vous que toutes les informations d'identification utilisées pour exécuter les workflows (Exécuter en tant que, connexion au service ou ensemble d'informations d'identification lors de l'enregistrement du Workflow) disposent d'un accès suffisant, configurez les autorisations utilisateur d'exécution requises .

4.4

Restaurez les alias de connexion basés sur le système et dans la base de données

Gérer les connexions de données :

%ProgramData%\Alteryx\Engine\SystemAlias.xml

Connexions de données In-DB du système :

%ProgramData%\Alteryx\Engine\SystemConnections.xml

4.5

Restaurer les alias de connexion utilisateur et utilisateur dans la base de données

Gérer les connexions de données :

C :\User\[nom d'utilisateur]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

Connexions de données in-DB utilisateur :

C :\User\[nom d'utilisateur]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

4.6

Les workflows utilisent-ils des connecteurs ?

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

\ProgramData\Alteryx\Tools

Contactez le support client pour activer les connecteurs sur votre nouveau serveur.

4.7

Les workflows utilisent-ils outil Python ?

Réinstallez tous les packages Python que les workflows avaient installés. Voir Server Upgrade Python Tool Environment Checklist.

4.8

Les workflows utilisent-ils outil R ?

Bientôt disponible...

4.9

Avez-vous un environnement multi-nœuds ou Mongo géré par l'utilisateur ?

(Bientôt disponible) Contactez votre chargé de clientèle ou le service clientèle.

4.10

Utilisez-vous SSL ?

Si vous récupérez vers un Sandbox Server pour les tests, utilisez HTTP pour les tests.

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

Configurer SSL/TLS pour Server

Configuration de Alteryx Server pour SSL obtention et installation de certificats (15577)

Étape 5 : démarrez Alteryx Server

#

Étape

Détails

5.1

Vérifiez les paramètres du système Alteryx et suspendez les programmes si vous le souhaitez.

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

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

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.

Important

Portez une attention particulière aux paramètres de configuration de l'interface utilisateur du serveur car un nouveau serveur peut avoir une URL différente ou ne pas avoir de certificat SSL.

System Settings, the Server UI configuration section.

Étape 6 : Test

#

Étape

Détails

6.1

Tests de base

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

Pouvez-vous :

  • Accéder à l'URL de l'interface utilisateur du serveur ?

  • Se déplacer dans les pages d'administration et afficher les utilisateurs, les collections, etc. ?

  • Publier un Workflow depuis Designer sur le serveur ?

  • Exécutez le workflow :

  • Si votre configuration le permet, enregistrez et exécutez un Workflow en spécifiant vos informations d'identification.

6.2

Tests spécifiques au flux de travail

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

  • Entrée/sortie vers un chemin UNC réseau

  • Connexion à des bases de données

  • Outil Connecteur

  • Présentation générale des informations concernant la géolocalisation et l'entreprise

  • Outil Python

  • Outil R