Exécuter l'outil Préparation à la migration
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 peutpas vérifier l'espace disponible.
Étape 1 : installer l'outil Préparation à la migration
Suivez ces étapes pour installer l'outil Runner :
# | Étape |
---|---|
1.1 | Téléchargez le programme d'installation depuis la page https://downloads.alteryx.com et exécutez-le. |
1.2 | Acceptez le CLUF. |
1.3 | Choisissez un chemin d'installation ou acceptez le chemin par défaut. |
1.4 | Suivez les invites pour terminer l'installation. |
Étape 2 : démarrer l'outil Préparation à la migration
Procédez comme suit pour démarrer l'outil de préparation à la migration.
# | Étape |
---|---|
2.1 | Ouvrez une invite de commande ou PowerShell. |
2.2 | Accédez au chemin d'installation choisi (par défaut :
|
2.3 | Exécutez l'une de ces 3 commandes pour lancer l'outil Préparation à la migration.
Remarque :
si vous utilisez PowerShell, ajoutez
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. #Exemple à utiliser avec le MongoDB intégré ou un serveur MongoDB unique géré par l'utilisateur:
Cela peut ressembler à l'exemple suivant. Veuillez noter que «
#Exemple à utiliser avec les ensembles de répliques MongoDB:
#Exemple à utiliser avec MongoDB Atlas:
|
2.4 | 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 : |
2.5 | Une fois que vous avez confirmé les sauvegardes, l'utilitaire vérifie l'espace disque disponible. Il vous fournira 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. |
2.6 | 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 :
Faites une capture d'écran de l'invite de commande.
Masquez ou supprimez les données sensibles.
Capturez le journal (voir les étapes de validation pour l'emplacement et le nom).
Exécutez à nouveau la migration.
Si la migration échoue à nouveau, contactez le support et incluez la capture d'écran et le fichier journal dans votre rapport.
Étape 3 : effectuer la mise à niveau vers Server 2022.3
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 2022.3.
Pour plus d'informations sur la mise à niveau, consultez la page Installation ou mise à niveau de Server .
# | Étape |
---|---|
3.1 | Téléchargez le programme d'installation 2022.3 et exécutez-le. |
3.2 | Acceptez l'accord de licence. |
3.3 | Choisissez votre chemin d'installation ou acceptez le chemin par défaut. |
3.4 | Démarrez l'installation. |
3.5 | Laissez l'installation se terminer. |
3.6 | Une fois l'installation terminée, choisissez l'option Configurer Server maintenant . Note Une fois l'installation de Server 2022.3 terminée, le démarrage du service peut prendre du temps. |
3.7 | 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. |
3.8 | 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. |
3.9 | 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. |
3.10 | 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 sont produites, essayez de redémarrer AlteryxService. Une tentative de redémarrage d'AlteryxService peut résoudre le problème. 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.
Quelle peut être la cause de l'échec d'une migration ?
Il existe 2 cas d'échec :
L'enregistrement n'a pas pu être déchiffré. Cela implique un enregistrement corrompu que l'utilisateur doit supprimer de la table (après l'avoir sauvegardée, le cas échéant).
L'enregistrement n'a pas pu être chiffré à nouveau. La solution est la même que pour le cas précédent.
D'autres cas d'échec sont généralement des problèmes d'environnement. Ces problèmes sont résolus en corrigeant le problème d'environnement, puis en réexécutant l'utilitaire. La perte de connexion à MongoDB et l'espace disque insuffisant en sont quelques exemples.
É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
Accédez à
C:\ProgramData\Alteryx\Service\
.Ouvrez le journal AlteryxServiceMigrator_#.log .
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
Accédez au dossier de journalisation défini par Alteryx Paramètres système > Contrôleur > Général > Journalisation .
Ouvrez le journal AlteryxServiceMigrator_#.log .
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 2022.3 (après la migration finale)
Connectez-vous à Server via l'URI Web.
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.