Skip to main content

Exécuter l'outil Préparation à la migration

Important

Utilisez cet outil uniquement pour effectuer une migration à partir de Server 2022.2 ou d'une version antérieure. Le mécanisme de chiffrement a été mis à jour dans la version 2022.3.

Avant de commencer

L'outil Préparation à la migration crée une copie incrémentielle des données de workflow stockées dans votre base de données. Au cours de ce processus, l'outil vous fournira une estimation de l'espace requis pour continuer. Ne poursuivez pas si vous ne disposez pas de l'espace suffisant.

Avertissement

Vous devez vérifier manuellement que vous disposez de suffisamment d'espace pour effectuer ce processus. L'outil Préparation à la migration ne peut pas vérifier l'espace disponible.

Étape 1 : installer l'outil Préparation à la migration

  1. Téléchargez le programme d'installation sur downloads.alteryx.com et exécutez-le.

  2. Acceptez le CLUF. Sélectionnez Next.

  3. Pour modifier l'emplacement d'installation, sélectionnez Modifier. Vous pouvez également sélectionner Suivant pour accepter l'emplacement par défaut.

  4. Suivez les invites pour terminer l'installation.

Étape 2 : démarrer l'outil Préparation à la migration

  1. Ouvrez une invite de commande ou PowerShell.

  2. Accédez au chemin d'installation choisi (par défaut : C:\Program Files\Alteryx Migration Tool\).

  3. Exécutez l'une de ces commandes pour lancer l'outil Préparation à la migration. Remarque : si vous utilisez PowerShell, ajoutez .\ au début de chaque commande. Vous pouvez exécuter cette opération sur tout hôte ayant accès au serveur MongoDB. Vous pouvez l'exécuter plusieurs fois en toute sécurité sans temps d'arrêt.

    Dans le cas d'une configuration à plusieurs nœuds, l'adresse IP/le nom d'hôte, le jeton contrôleur et le mot de passe NON_ADMIN_MONGO_PASSWORD doivent provenir de la machine sur laquelle le nœud de contrôleur est exécuté, conformément aux paramètres définis lors de la configuration à plusieurs nœuds.

    Dans le cas d'un nœud unique, ces informations doivent provenir de la même machine sur laquelle Alteryx Server est installé.

Comment utiliser les exemples :

Remplacez ces variables dans la chaîne de connexion par les valeurs adaptées à votre environnement. Ces informations d'identification sont les mêmes que celles utilisées pour configurer votre base de données Server et se trouvent dans les Paramètres système Alteryx.

  • {authenticationDB} = base de données qui authentifiera les informations d'identification de l'utilisateur spécifié.

    • Si votre instance de Server est configurée pour utiliser MongoDB intégrée, utilisez le mot de passe MongoDB non-administrateur. Dans la chaîne de connexion, votre authSource doit être « AlteryxService ».

    • Pour MongoDB gérée par l'utilisateur, contactez l'administrateur MongoDB pour confirmer les informations d'identification de l'utilisateur et authSource.

  • {port} = port de service utilisé par MongoDB pour fournir l'accès à la base de données.

  • {host.domain.tld} = nom de domaine complet de votre serveur MongoDB.

  • {password} = informations d'identification de l'utilisateur.

  • {user} = nom d'utilisateur pour accéder à la base de données.

  • {atlasCluster.cloudProvider.mongodb.net} = adresse du cluster MongoDB Atlas.

Base de données

Exemple

MongoDB intégré

Remarque : vous devez modifier « NON_ADMIN_MONGO_PASSWORD », « CONTROLLER_TOKEN » et « localhost » en fonction de votre configuration actuelle.

Migration des fragments d'application et des informations d'identification RunAS

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

Migration des fragments d'application uniquement

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

Migration des informations d'identification RunAS uniquement

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

MongoDB gérée par l'utilisateur

Remarque : vous devez modifier « Password », « port », « host.domain.tld » et « AuthenticationDB » en fonction de votre instance MongoDB actuelle.

Migration des fragments d'application et des informations d'identification RunAS

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Migration des fragments d'application uniquement

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Migration des informations d'identification RunAS uniquement

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Jeux de réplicas MongoDB

Migration des fragments d'application et des informations d'identification RunAS

AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Migration des fragments d'application uniquement

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Migration des informations d'identification RunAS uniquement

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

MongoDB Atlas

Migration des fragments d'application et des informations d'identification RunAS

AlteryxServiceMigrator22_2.exe -p -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

Migration des fragments d'application uniquement

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

Migration des informations d'identification RunAS uniquement

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

Paramètres des commandes

  • -h [ --help ] afficher les informations d'aide

  • -q [ --quiet ] envoyer les messages du journal à la ligne de commande (les messages de progression ignorent cet indicateur)

  • -s [ --severity ] arg (=7) niveau de gravité de la journalisation de la console (les rapports de progression de la migration sont envoyés au niveau 5)

  • -p [ --perform ] exécuter la migration

  • --appsonly exécuter la migration de fragments uniquement, sans vérification préalable

  • --credonly effectuer une vérification préalable sans migration de fragments

  • -u [ --forcenoprogressupdates ] désactiver l'écriture des messages de mise à jour de la progression sur la console (ils sont toujours écrits dans le fichier journal)

  • -c [ --connection ] chaîne de connexion arg (la base de données AlteryxService doit être spécifiée)

  • -i [ --hostname ] nom d'hôte arg|adresse IP du contrôleur

  • -t [ --controllertoken ] jeton contrôleur arg pour récupérer les clés

  • -l [ --loggingpath ] chemin du fichier de journalisation arg (=C:\ProgramData\Alteryx), doit contenir un %N à des fins de rotation de journal

  • --loggingmaxfilesize arg (=64) taille maximale en Mo d'un fichier journal avant sa rotation

  • -d [ --stagingdirectory ] répertoire arg dans lequel les workflows déchiffrés seront temporairement stockés avant d'être à nouveau chiffrés

Que se passe-t-il ensuite ?

  • Lorsque la migration démarre, vous êtes invité à confirmer que vous avez effectué une sauvegarde de la base de données et de votre fichier de paramètres d'exécution. 

  • Une fois que vous avez confirmé les sauvegardes, l'utilitaire vérifie l'espace disque disponible. Il vous fournit une estimation de l'espace supplémentaire nécessaire à la migration. Vous devez vérifier votre système et poursuivre uniquement si vous êtes sûr que vous disposez de suffisamment d'espace libre.

  • Une fois que vous avez confirmé que vous avez suffisamment d'espace disponible, l'utilitaire commence à migrer les données de workflow. Des messages de la console indiquant l'heure de début et l'heure de fin ainsi que des messages de progression s'affichent.

Résolution des problèmes

Si une erreur se produit pendant la migration, elle s'affiche dans la console et est également enregistrée dans le fichier journal.

Si vous rencontrez une erreur, procédez comme suit :

  1. Faites une capture d'écran de l'invite de commande.

  2. Masquez ou supprimez les données sensibles.

  3. Capturez le journal (voir les étapes de validation pour l'emplacement et le nom).

  4. Exécutez à nouveau la migration.

  5. Si la migration échoue à nouveau, contactez le support Alteryx et joignez à votre rapport la capture d'écran et le fichier journal.

Note

Si l'erreur Erreur lors de l'initialisation de la clé <Erreur lors de l'importation de clés dans le répertoire Microsoft\Crypto\RSA\MachineKeys\ dans ProgramData : l'accès est refusé. (5)> La migration RunAS a échoué se produit lors de l'exécution de la commande de migration, accédez à C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys. Cliquez ensuite avec le bouton droit sur le dossier MachineKeys et sélectionnez Afficher plus d'options > Donner l'accès à > Personnes spécifiques. Sélectionnez Tout le monde, puis le niveau d'autorisation Lecture/écriture. Sélectionnez ensuite Partager.

Étape 3 : effectuer la mise à niveau vers Server 2023.2

Important

  • Avant de procéder à la mise à niveau, faites une copie de sauvegarde de votre base de données Mongo et du fichier RuntimeSettings.xml. Le chiffrement effectué pendant la fenêtre de maintenance est irréversible. La sauvegarde protège votre installation contre la perte de données ou les temps d'arrêt supplémentaires.

  • La progression de la migration n'est pas visible pendant la mise à niveau vers la version 2023.2.

  • Pour plus d'informations sur la mise à niveau, consultez la page Installation ou mise à niveau de Server.

  1. Téléchargez Server 2023.2 sur downloads.alteryx.com.

  2. Exécutez le programme d'installation. Sélectionnez Oui pour poursuivre la mise à niveau.

  3. Acceptez l'accord de licence.

  4. Choisissez votre chemin d'installation ou acceptez le chemin par défaut. Ensuite, sélectionnez Suivant.

  5. Sélectionnez Installer pour démarrer l'installation (la mise à niveau).

  6. Une fois l'installation terminée, sélectionnez Configurer Server maintenant, puis Terminer.

  7. Au terme de l'installation de Server 2023.2, sélectionnez l'option Commencer la sauvegarde et la migration.

  8. Une fois la migration réussie, sélectionnez OK.

Remarque : après l'installation, le démarrage du service peut prendre du temps.

Étapes suivantes postérieures à l'installation

Les paramètres système Alteryx s'ouvrent. Passez en revue les Paramètres système pour vérifier que vos paramètres sont corrects. Sélectionnez ensuite Terminer et Terminé pour démarrer le service.

Au démarrage du service, Server passe en mode maintenance pour migrer le fichier RuntimeSettings et les valeurs de la base de données qui n'ont pas pu être migrées auparavant. Pendant le mode maintenance, votre instance Server est indisponible.

L'outil Préparation à la migration effectue une vérification finale des modifications apportées à la base de données depuis la dernière exécution. Il effectue ensuite la migration (y compris les modifications trouvées récemment) et met en service la migration incrémentielle.

Cette migration finale peut prendre plusieurs heures. Cette durée dépend de la taille de votre configuration et de si vous avez exécuté l'outil Préparation à la migration avant la mise à niveau ou non. Une fois ce processus terminé, Server quitte le mode maintenance et entre dans un état fonctionnel.

Résolution des problèmes

Si le service s'arrête au bout d'un certain temps, vérifiez les erreurs de migration dans les journaux suivants :

  • LastStartupError.txt

  • Journal AlteryxServiceMigrator_#.log créé par l'outil Préparation à la migration

  • Journal AlteryxServiceMigrator_#.log créé lors du démarrage du service

Si des erreurs de migration se produisent, essayez de redémarrer AlteryxService. Cela peut résoudre le problème, car AlteryxService relance toutes les étapes de migration incomplètes. Si le problème persiste, récupérez les journaux et contactez le service clientèle pour obtenir de l'aide. En fonction des erreurs, une tentative de redémarrage d'AlteryxService peut résoudre le problème, car il va réessayer d'effectuer toutes les étapes de migration incomplètes.

Étape 4 : valider la réussite de la migration

Pour vérifier que l'outil Préparation à la migration a été correctement exécuté, suivez l'une des options suivantes.

Valider le journal de l'outil Préparation à la migration

  1. Accédez à C:\ProgramData\Alteryx\Service\.

  2. Ouvrez le journal AlteryxServiceMigrator_#.log.

  3. Vérifiez s'il contient des messages d'erreur ou d'échec. Rechercher l'état 3 affiché comme ';3;' dans le journal.

Valider le journal de démarrage du service

  1. Accédez au dossier de journalisation défini par Alteryx Paramètres système>Contrôleur > Général > Journalisation.

  2. Ouvrez le journal AlteryxServiceMigrator_#.log.

  3. Vérifiez s'il contient des messages d'erreur ou d'échec. Rechercher l'état 3 affiché comme ';3;' dans le journal.

Validation après la mise à niveau vers la version 2023.2 (après la migration finale)

  1. Connectez-vous à Server via l'URI Web.

  2. Vérifiez les éléments suivants :

    • Vous pouvez exécuter manuellement des workflows et des applications.

    • Les programmes sont actifs et s'exécutent en produisant les résultats attendus.

    • Vous pouvez afficher, modifier, créer et utiliser les informations d'identification du workflow.

    • Vous pouvez afficher, modifier, créer et utiliser les connexions aux données de Server.

    • Récupérez un package de workflow à partir de l'API, importez-le dans Designer et exécutez le workflow dans Designer.

Dans cette section​: