Outil Préparation à la migration
L'outil Préparation à la migration pour Server est un utilitaire qui permet la migration préalable d'une base de données de workflows et d'applications pour accélérer la migration vers la nouvelle norme AES256.
Cet outil de préparation à la migration est facultatif. C'est un utilitaire de ligne de commande distinct. Vous n'avez besoin de l'exécuter qu'une seule fois avant de passer de la version 2022.1 de Server (ou versions antérieures) à la version 2022.3.x ou à une version ultérieure.
Important
Si vous effectuez une mise à niveau à partir de la version 2022.1 ou une version antérieure, exécutez l'outil Préparation à la migration avant d'effectuer la mise à niveau vers la version 2022.3+.
Si vous effectuez une mise à niveau à partir de la version 2022.3+, votre base de données a déjà effectué une migration cryptographique. Vous n'avez pas besoin d'exécuter l'outil Préparation à la migration.
Note
Pourquoi avons-nous créé cet outil ?
Server met à jour sa technique de chiffrement pour l'utilisation d'AES256 avec des données au repos. Toutes les données chiffrées stockées et existantes doivent migrer de leur méthode de chiffrement actuelle vers la nouvelle. Certaines de ces données peuvent être migrées avant la mise à niveau vers la version 2022.3 pendant que votre Server est en production.
Les applications et les workflows stockés dans Server sont les données les plus longues à migrer. Ces données peuvent être migrées à l'avance pour gagner du temps lors de la mise à niveau vers Server 2022.3.
Alteryx a créé l'outil Préparation à la migration pour vous aider à migrer ces données avant la mise à niveau.
Quand utiliser l'outil Préparation à la migration
Nous vous recommandons d'exécuter l'outil Préparation à la migration dans les cas suivants :
Si l'installation de Server que vous mettez à niveau est un système de production ou de développement qui ne peut pas être arrêté pendant plus de quelques heures ;
si vous disposez de plus de quelques centaines de workflows ;
si vous exécutez MongoDB Atlas ou un serveur MongoDB géré par l'utilisateur.
Même si ces cas ne s'appliquent pas à vous, nous vous recommandons d'exécuter l'outil Préparation à la migration avant de tenter une mise à niveau afin d'être certain de sa réussite.
De plus, vous devriez prendre en compte la taille de db.AS_App_Chunks.dataSize() et de AS_PackageDefinitions. Nous ne fournissons pas de recommandations concernant la taille de la base de données pour savoir quand vous devez exécuter l'outil Préparation à la migration en mode préparation.
Si vous ne disposez que de quelques workflows ou si vous ne voyez pas d'inconvénient à ce que la mise à niveau de Server prenne plusieurs heures voire plusieurs jours, vous pouvez vous passer de l'outil Préparation à la migration et exécuter le programme d'installation de Server standard pour effectuer la mise à niveau vers la version 2022.3. Le temps d'arrêt sera plus long que d'habitude puisque la migration cryptographique sera incluse dans la mise à niveau.
Note
Si vous choisissez de ne pas exécuter l'outil Préparation à la migration avant la mise à niveau, l'outil sera installé et exécuté dans le cadre de l'installation de la mise à niveau 2024.1.
Vérifications préalables
Pour évaluer de manière anticipée les problèmes que vous pourriez rencontrer avant la mise à niveau vers la version 2022.3 ou une version ultérieure, effectuez les vérifications préalables dans le cadre de l'outil Préparation à la migration.
Important
Vous ne pouvez effectuer une vérification préalable que sur des instances de Server qui utilisent un jeton contrôleur de 64 caractères.
Si votre version de Server est 2021.3 ou antérieure, vous devez d'abord effectuer une mise à niveau vers la version 2022.1 avant de passer aux étapes suivantes.
Vérifiez la longueur de votre jeton contrôleur dans les Paramètres système Alteryx > Contrôleur > Général > Jeton > Afficher.
Si votre jeton comporte 40 caractères, sélectionnez Régénérer pour créer un nouveau jeton. Sélectionnez ensuite OK pour redémarrer AlteryxService et créer le nouveau jeton.
Pendant le processus de pré-migration ou de migration complète, vous pourrez afficher des journaux d'erreurs qui vous permettront de résoudre les problèmes vous-même. Cela vous permet de prendre les mesures recommandées pour vous assurer que la migration complète s'est déroulée correctement malgré les erreurs.
Nous avons ajouté 3 nouvelles options d'exécution lors de l'exécution de l'outil Préparation à la migration :
Par défaut : exécuter la vérification de pré-migration et la pré-migration simultanément (-p)
Exécuter uniquement la pré-migration (applications) (--appsonly)
Exécuter uniquement l'étape de validation des informations d'identification (--credonly)
Lors de l'exécution de l'outil Préparation à la migration, vous devez fournir le jeton de contrôleur (-t) et le nom d'hôte/l'adresse IP du contrôleur (-i). Cela signifie également que vous pouvez désormais exécuter l'outil Préparation à la migration sur une configuration à plusieurs nœuds en fournissant le nom d'hôte/l'adresse IP du contrôleur et le jeton du contrôleur.
Veuillez noter que deux instances de l'outil Préparation à la migration ne peuvent pas s'exécuter simultanément pour le même contrôleur.