Skip to main content

Rétrogradation d'Alteryx Server

Cet article vous propose des conseils relatifs à la rétrogradation d'Alteryx Server.

Les mises à niveau d'Alteryx Server entraînent parfois des complications imprévues. Pour éviter des perturbations supplémentaires, il faut soit résoudre ces complications, soit opter pour la rétrogradation. Vous pouvez résoudre la plupart des problèmes à l'aide des ressources présentes sur notre page Communauté ou en contactant le support Alteryx. Dans certains cas, vous devrez restaurer la dernière version opérationnelle afin de résoudre les problèmes sous-jacents.

Note

Avant de procéder à la rétrogradation, vous pouvez effectuer une recherche dans la communauté Alteryx et contacter le support Alteryx pour discuter des raisons qui vous poussent à opter pour la rétrogradation.

Important

Assurez-vous de disposer d'une sauvegarde de MongoDB avant la mise à niveau. Sans cela, la rétrogradation sera impossible.

Important

Si vous avez migré de MongoDB vers MSSQL géré par l'utilisateur, vous NE pourrez PAS rétrograder vers une version antérieure à la version 2024.1 car la prise en charge de SQL Server n'est disponible qu'à partir de la version 2024.1.

Pour rétrograder à partir d'un environnement SQL géré par l'utilisateur, vous devez d'abord revenir à la dernière version de MongoDB que vous utilisiez avant la migration vers SQL. Si vous avez effectué une sauvegarde de votre environnement MongoDB avant la migration, vous pouvez la substituer à votre base de données SQL actuelle. Pour ce faire, mettez à jour les chaînes de connexion dans les paramètres système Alteryx pour que le Contrôleur et l'interface utilisateur Server pointent à nouveau vers l'ancien environnement MongoDB. Reportez-vous à cet article de la base de connaissances sur la sauvegarde et la récupération Server pour plus d'informations sur la sauvegarde. En procédant ainsi, vous reviendrez à MongoDB au moment où vous avez effectué la migration, de sorte que toute modification apportée à l'environnement après la migration vers SQL ne sera pas présente dans votre ancienne version de MongoDB.

Environnement

  • Alteryx Server (toutes les versions)

  • MongoDB intégrée ou gérée par l'utilisateur (toutes les versions)

Conditions préalables

  • Vous devez disposer des autorisations Administrateur sur la machine Server.

  • Fenêtre d'indisponibilité (maintenance) de Server pour effectuer la rétrogradation.

    La planification d'une fenêtre d'indisponibilité de Server n'est pas une obligation et dépend de vos stratégies internes. La durée de cette fenêtre d'indisponibilité dépend de votre configuration et de la taille de la base de données.

  • Fichier d'installation de la version précédente de Server vers laquelle vous effectuez la rétrogradation.

  • Sauvegarde MongoDB prise de la version précédente vers laquelle vous effectuez la rétrogradation. Pour plus d'informations, consultez l'article Procédures de sauvegarde et de restauration d'Alteryx Server.

  • Si vous rétrogradez de la version 2022.3+ vers une version antérieure à 2022.3, vous aurez besoin de la sauvegarde du fichier RuntimeSettings.xml pour la mise à niveau vers la version 2022.3+ : C:\ProgramData\Alteryx\RuntimeSettings.22_2_legacy.xml

Rétrogradation d'Alteryx Server

Cette procédure montre comment rétrograder d'Alteryx Server vers une version antérieure qui était exécutée auparavant dans le même environnement. Pour les besoins de cet article, nous prendrons comme exemple la rétrogradation d'Alteryx Server 2023.1 vers 2022.3.

  1. Connectez-vous à Alteryx Server. Pour les environnements multinœuds, connectez-vous au nœud du contrôleur qui héberge MongoDB intégrée ou gérée par l'utilisateur.

  2. Ouvrez la console Services.msc et sélectionnez Arrêter le service.

    Pour plus d'informations sur l'arrêt du service, consultez la rubrique Mode d'emploi : démarrage d'AlteryxService. Dans la procédure A décrite dans cet article, utilisez Arrêter au lieu de Démarrer.

  3. Pour ouvrir le panneau de configuration, recherchez Panneau de configuration dans le menu Démarrer.

  4. Sélectionnez Programmes et désinstallez Alteryx Server 2023.1. Le programme de désinstallation désinstalle également automatiquement les outils prédictifs Alteryx.

    downgrade_Server_01_03.png

  5. Si vous rétrogradez de la version 2022.3+ vers une version antérieure à 2022.3, vous devez restaurer votre fichier RuntimeSettings.xml d'origine.

    1. Accédez au dossier dans lequel se trouve le fichier RuntimeSettings.xml (par exemple, %ProgramData%\Alteryx\RuntimeSettings.xml), cliquez dessus avec le bouton droit de la souris et sélectionnez Renommer. Renommez-le ensuite en RuntimeSettings_rollback_bkp.xml.

    2. Dans le même dossier, renommez RuntimeSettings.22_2_legacy.xml en RuntimeSettings.xml en cliquant dessus avec le bouton droit de la souris, puis en sélectionnant Renommer.

  6. Une fois complètement désinstallé, exécutez le programme d'installation d'Alteryx Server pour la version 2022.3 (ou la version vers laquelle vous effectuez la rétrogradation). Cliquez avec le bouton droit de la souris sur le fichier d'installation et sélectionnez Exécuter en tant qu'administrateur.

    Note

    Veillez à bien rétrograder vers la version que vous utilisiez précédemment, jusqu'au niveau du correctif. Si vous ne vous souvenez plus du correctif que vous utilisiez précédemment, rétrogradez vers le correctif le plus récent pour cette version.

  7. Prenez connaissance du contrat de licence et sélectionnez Suivant.

  8. Sélectionnez le chemin d'accès au dossier d'installation s'il est différent de l'emplacement par défaut, puis sélectionnez Suivant.

    downgrade_Server_02_02.png

  9. Une fois l'installation terminée, vous serez invité à installer les outils prédictifs comme indiqué sur l'image ci-dessous. Si vous avez l'intention de conserver cette version et que certains de vos workflows s'appuient sur les outils prédictifs, sélectionnez Installer les outils prédictifs, puis Terminer. Sinon, sélectionnez Fermer et exécuter Alteryx Designer ultérieurement, puis sélectionnez Terminer.

    downgrade_Server_03_02.png

Note

Dans les environnements à plusieurs nœuds, suivez le même processus pour chaque nœud.

Restauration de MongoDB

Dans l'étape suivante, restaurez votre base de données MongoDB vers la version précédente.

  1. À ce stade, le service Alteryx doit encore se trouver à l'état d'arrêt. Pour le confirmer, vérifiez la console Services.msc.

  2. Rename the current Persistence folder to “MongoDB_failedUpgradeAttempt_to_version##”.  While this folder is no longer in use, it’s best practice to avoid deleting files and folders during a Server incident.

  3. Recreate the Persistence folder in File Explorer. The folder is now empty and ready for the database restore.

  4. Restaurez MongoDB à partir de la dernière sauvegarde MongoDB prise de la version vers laquelle vous effectuez la rétrogradation. Les étapes pour restaurer MongoDB et vérifier la réussite de sa restauration se trouvent dans la section Restauration à partir d'une sauvegarde MongoDB sur la page d'aide des sauvegardes MongoDB.

Note

To confirm your Persistence folder, go to Alteryx System Settings > Controller > Persistence > Data Folder, or go to C:\ProgramData\Alteryx\RuntimeSettings.xml and search for <EmbeddedMongoDBEnabled>.

Vérifications post-rétrogradation

  • Vérifiez que l'interface utilisateur de Server est accessible et que le contenu attendu, tel que les utilisateurs, les workflows et les planifications, a été restauré avec succès.

  • Vérifiez si les journaux de Server ont consigné des verrouillages inattendus. Pour savoir où trouver les fichiers journaux, consultez Mode d'emploi : joindre les fichiers journaux de Server. Si les erreurs ci-dessous s'affichent, supprimez les verrous en exécutant 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.

    • 2020-05-11 15:53:06.564593,FATAL,18,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock->Retry in (1) seconds...,"Lucene.Net.Store.LockObtainFailedException: Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock-context, String name)

    • 2020-05-11 15:33:59.700855,FATAL,20,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Failed to obtain IndexWriter lock.->Retry in (1) seconds...,System.Exception: Failed to obtain IndexWriter lock. -> at Alteryx.Server.Models.BackgroundThread.QueueWorker.RunOnce()

Note

Si vous craignez d'appliquer le processus, contactez le support Alteryx pour obtenir de l'aide.

Dans cette section​: