Important
Consultez la liste de contrôle de mise à niveau de Server pour planifier et exécuter une mise à niveau réussie de Server, y compris le workflow de vérification préalable à la mise à niveau pour identifier les problèmes qui entraînent l'échec des mises à niveau.
En quoi ce document aide-t-il ?
Ce document présente les tâches et les modifications que vous devez connaître lors de la mise à niveau des versions d'Alteryx Server. Les problèmes sont cumulatifs, alors lisez chaque section au fur et à mesure que vous passez d'une version à une autre. Cela ne remplace pas les notes de publication (voir les liens dans chaque section).
Les versions semestrielles ajoutent des fonctionnalités, mais peuvent également modifier la gestion de Server en vous obligeant, vous ou vos utilisateurs, à modifier votre comportement.
Chaque trimestre, les mises à jour/correctifs de maintenance permettent de résoudre les problèmes détectés dans la version initiale. Par exemple, la première version de maintenance pour 2022.3 serait 2022.3.2.
ARRÊT TECHNIQUE | Modification importante nécessitant une mise à niveau vers cette version avant de passer à une version ultérieure. |
Mise à niveau de MongoDB | La version de la base de données Mongo est mise à niveau. Une mise à niveau d'Alteryx Server ne peut inclure qu'UNE SEULE mise à niveau de version MongoDB entre votre version actuelle et la version de mise à niveau cible. |
CRITIQUE | Problème critique : les administrateurs doivent traiter ce problème ou en être conscients lorsqu'ils passent à cette version ou une version ultérieure. |
Critères pour les entrées de cette liste
Cette liste synthétise les notes de publication de chaque version pour indiquer où :
Les administrateurs ou utilisateurs doivent effectuer une action.
L'élément est important pour choisir une version de mise à niveau (c'est-à-dire, changement de comportement ou défaut).
Une modification importante a été apportée à l'administration de Server.
Nouveautés / Notes de publication / Blog de la communauté Server / Présentation du blog de la communauté
Version | Actions à effectuer lors de la mise à niveau vers cette version ou une version ultérieure. |
|---|---|
2022.3 CRITIQUE | Exigence de mise à niveau pour le défaut 2022.1 TCPE-1100 : si vous effectuez une mise à niveau de la version 2022.1 vers cette version ou une version ultérieure, un correctif est requis. Impact : si vous utilisez actuellement la version 22.1, vous devez avoir installé 22.1.1.9.42691_Patch_9 ou supérieur avant la mise à niveau vers ou via 22.3 pour éviter le défaut TCPE-1100. Ce défaut affecte les numéros de révision du workflow et les définit tous sur « 1 ». Tâche : appliquez le dernier correctif 22.1 avant de procéder à la mise à niveau si vous n'utilisez pas encore Patch_9 ou une version ultérieure. |
2022.3 CRITIQUE | Rechiffrement MongoDB : les collections de bases de données doivent être rechiffrées avec les normes de hachage AES256 et SHA256 avant la mise à niveau Impact : l'outil de préparation à la migration Crypto doit être exécuté avant la mise à niveau vers la version 2022.3+ afin de rechiffrer les workflows en arrière-plan pendant que Server continue de fonctionner. Après l'exécution de l'outil de préparation, la première fois que Server démarre après la mise à niveau de quelques collections supplémentaires, RuntimeSettings.xml est également migré via Crypto. Tâche : Votre Server doit utiliser la version 2021.2 ou ultérieure avant de commencer ce processus. Si vous utilisez une version antérieure, effectuez une mise à niveau vers une version comprise entre 2021.2 et 2022.1 avant de tenter de mettre à niveau vers 2022.3+. Exécutez l'outil de préparation à la migration Crypto avant de mettre à niveau Server et consultez le journal de Migrator pour voir s'il y a des lignes d'erreur contenant Après la mise à niveau, vous pouvez supprimer les anciennes collections non chiffées. Contactez le support pour plus d'informations sur le nettoyage des fichiers temporaires créés et la réduction de la taille de la base de données Mongo (pour les CSE, voir ici). Si vous devez annuler la mise à niveau, vous devrez restaurer la sauvegarde du fichier RuntimeSettings.xml effectuée lors de la mise à niveau, C:\ProgramData\Alteryx\. |
2022.3 CRITIQUE | Version de Designer requise : Designer 2022.3 requis Impact : les méthodes de chiffrement utilisées par 2022.3 Server nécessitent Designer 2022.3. Tâche : les utilisateurs doivent mettre à niveau Designer pour enregistrer les workflows sur Server. |
2022.3 CRITIQUE | Modification de la configuration : le point de terminaison SAML ACS doit être en minuscules Impact : le point de terminaison ACS est maintenant en minuscules (/saml2/acs) mais était mixte auparavant (/Saml2/Acs). Cela empêche le démarrage du service. [TCPE-940 demande que l'ancienne et la nouvelle casse soient acceptées sans erreur]. Tâche : modifiez le point de terminaison ACS dans l'IDP en minuscules. |
2022.3 Correctif 2 | Modification administrative : Option permettant aux utilisateurs d'exécuter des workflows à l'aide de connexions de base de données Server partagées Impact : l'option Autoriser l'accès aux workflows sans informations d'identification partagées a été ajoutée pour autoriser qu'un workflow utilisant une connexion de base de données Server partagée soit exécuté par toute personne avec laquelle le workflow a été partagé via une collection. Les autres utilisateurs n'ont pas besoin que la connexion Gallery soit explicitement partagée avec eux. Tâche : accédez à Interface utilisateur Server > Administrateur > Paramètres > Ressources. Cochez ensuite la case Autoriser l'accès aux workflows sans informations d'identification partagées. |
2022.3 | Modification administrative : Équilibreur de charge Impact : les options Paramètres système Alteryx > Interface utilisateur Server > Adresse canonique ont été ajoutées pour garantir que les e-mails de Server utiliseront l'URL que vos utilisateurs utilisent pour accéder à l'interface utilisateur Server. Tâche : si vous utilisez un équilibreur de charge, définissez ces valeurs sur l'URL que vos utilisateurs utilisent généralement pour accéder à l'interface utilisateur Server ou à l'API. |
2022.3 | Le rapport d'utilisation de Server est obsolète Impact : le rapport d'utilisation de Server n'est plus pris en charge par Alteryx. Les versions précédentes peuvent continuer à fonctionner. |
2022.3 | Gestion des mots de passe : prise en charge du coffre-fort de mots de passe HashiCorp et CyberArk ajoutée |
2022.3 | Outil Télécharger, accès à une renégociation d'établissement de liaison moins sécurisée : le fichier de paramètres permet un contrôle spécifique au site Impact : utilisez la liste d'autorisation de validation par les pairs si vous recevez « erreur de connexion SSL » de l'outil Télécharger. Outil Télécharger mis à jour vers OpenSSL 3.0.7. |
2022.3 | Modification interne : longueur du jeton de contrôleur Impact : Server 2021.4 a introduit un jeton de contrôleur plus long et plus sécurisé. Cependant, les mises à niveau depuis 2021.3 ont conservé leur jeton plus court. Si le jeton n'a pas été régénéré à la longueur la plus longue à un moment donné, il sera automatiquement régénéré dans la mise à niveau 2022.3. Cela se produira sur tous les nœuds de la même manière afin qu'ils créent le même jeton plus long et qu'ils puissent communiquer avec le contrôleur après la mise à niveau. Tâche : utilisez le nouveau jeton de contrôleur pour ajouter de nouveaux nœuds à votre architecture de Server à l'avenir. |
2022.3 | Défaut TGAL-7199 : toutes les versions du workflow étiquetées « 1 » (corrigé dans 2022.3.1_Patch2) Impact : lors de l'affichage de la liste des versions d'un workflow, toutes les versions affichent « 1 » au lieu d'un numéro de version séquentiel. Il s'agit d'un problème d'interface utilisateur et la version correcte est utilisée pour exécuter les tâches. |
Nouveautés / Notes de publication
Version | Actions à effectuer lors de la mise à niveau vers cette version ou une version ultérieure. |
|---|---|
2023.1 CRITIQUE | Version de Designer minimale Impact : le correctif 3 de Designer 2022.3 ou ultérieur est requis pour la connexion à Server. Consultez les Notes de publication Server 2023.1. |
2023.1 | Modification administrative : Option permettant aux utilisateurs d'exécuter des workflows à l'aide de connexions de base de données Server partagées Impact : l'option Autoriser l'accès aux workflows sans informations d'identification partagées a été ajoutée pour autoriser qu'un workflow utilisant une connexion de base de données Server partagée soit exécuté par toute personne avec laquelle le workflow a été partagé via une collection. Les autres utilisateurs n'ont pas besoin que la connexion Gallery soit explicitement partagée avec eux. Tâche : Interface utilisateur Server > Administrateur > Paramètres > Ressources > cochez la case Autoriser l'accès aux workflows sans informations d'identification partagées. |
2023.1 | Gestion des mots de passe : prise en charge du coffre-fort de mots de passe AWS Secrets Manager ajoutée Impact : AWS Secrets Manager |
2023.1 | Ajouts d'API : pour les serveurs d'authentification Active Directory (AD), un groupe AD peut être ajouté à un groupe personnalisé Impact : points de terminaison ajoutés :
|
2023.1 | Modification administrative : prise en charge du groupe Azure Active Directory avec authentification SAML Impact : les administrateurs peuvent désormais synchroniser l'accès des utilisateurs et des groupes à Server à l'aide d'Azure Active Directory (Azure AD) et du protocole SCIM. Tâche : configurez Alteryx Server SCIM Azure Active Directory |
2023.1 | Fonction DCM : option permettant de désactiver la synchronisation DCM entre Designer et Server Impact : cette fonctionnalité est utile sur un Server de production pour s'assurer que les utilisateurs ne synchronisent pas par inadvertance et n'utilisent pas d'informations d'identification du Server de production dans leur Designer local. Tâche : Paramètres système Alteryx > DCM > cochez la case Bloquer la synchronisation des connexions DCM entre Server et Designer. Pour plus d'informations, consultez DCM - Server. |
2023.1 | Modification administrative : les workers peuvent se connecter à MongoDB géré par l'utilisateur avec des informations d'identification uniques. Impact : permet d'effectuer un audit par worker. |
2023.1 | Connexions de base de données : fin de vie pour les connexions de base de données 32 bits Impact : fin de la prise en charge des connexions de base de données 32 bits - FAQ. Les connexions 32 bits ne fonctionneront plus. |
2023.1 Programme d'installation de R CRITIQUE | Mise à niveau de R : mise à niveau de la version de R intégrée de 4.1.3 à 4.2.3 dans RInstaller_2023.1.1.200.exe+ Impact : la version de R sera 4.1.3 ou 4.2.3 comme suit :
Tâche :
Comment utiliser l'outil R avec des packages compatibles avec R version 4.2.3 |
2023.1 | Défauts de l'application analytique (corrigés dans 2023.1_Patch_2) Impact :
|
2023.1 CRITIQUE | Produit Connect : connect n'est pas compatible avec la version initiale 2023.1 Impact : les notes de publication indiquent quel correctif est compatible avec la version 2022.3. |
Nouveautés / Notes de publication
Version | Actions à effectuer lors de la mise à niveau vers cette version ou une version ultérieure. |
|---|---|
2023.2 MongoDB 6.0.5 | Mise à niveau de MongoDB : mises à niveau de MongoDB intégré de la version 4.2.15 à la version 6.0.5 Impact : mises à niveau de MongoDB intégré vers 6.0.5 Tâche : si vous utilisez MongoDB intégré, la mise à niveau vers cette version ou ultérieure mettra à niveau MongoDB vers la version 6.0.5. Notez que les besoins en espace disque libre représentent 1x-2x votre taille MongoDB actuelle. |
2023.2 CRITIQUE | Boîte de dialogue de mise à niveau de MongoDB : la boîte de dialogue pour lancer la mise à niveau de MongoDB intégré est réduite Impact : lors de la mise à niveau vers la version 2023.2, après avoir sélectionné Terminer lors de la mise à niveau, la boîte de dialogue de migration de MongoDB intégré s'ouvre mais est immédiatement réduite, donnant l'impression que la mise à niveau est terminée [TGAL-9041]. Pour plus d'informations, consultez Erreur dans les journaux de service lors de la mise à niveau vers la version 23.2 de Server : valeur de version de compatibilité de fonctionnalité non valide, attendue : '5.0' ou '5.3' ou '6.0'. Tâche : assurez-vous de rendre cette boîte de dialogue visible et cliquez pour lancer la mise à niveau de MongoDB. Le service ne démarrera pas tant que MongoDB n'aura pas été mis à niveau. |
2023.2 | Modification MongoDB : champ __ServiceDataBlob supprimé des collections AlteryxGallery Impact : le champ __ServiceDataBlob a été supprimé des collections AlteryxGallery ; les champs apparaissent désormais comme des champs MongoDB standard. Tâche : si vous avez des workflows d'administration qui utilisaient la macro ServiceDataParser pour décompresser les données de ce blob, ils devront être révisés. |
2023.2 | Modification administrative DCM : les connexions DCM peuvent désormais être partagées pour la collaboration Impact : lors du partage d'une connexion DCM dans l'interface utilisateur Server, l'option « Partager pour collaboration » permet à d'autres utilisateurs d'utiliser la connexion DCM dans leur Designer. Pour plus d'informations, consultez Gestionnaire de connexion aux données : interface utilisateur Server > Partager dans Designer. Tâche : cette modification facilite la collaboration sur les workflows partagés et la création de nouveaux workflows à l'aide de la connexion DCM d'un collègue. |
2023.2 | Mise à niveau de Python : mises à niveau de Python intégré de 3.8.5 à 3.8.16 Impact : les utilisateurs doivent retester Python dans les workflows. Engine utilise toujours Python version 3, donc il devrait y avoir peu d'impact sur les scripts. Tâche : pour plus d'informations, consultez Python intégré dans Alteryx. |
Nouveautés / Notes de publication
Version | Actions à effectuer lors de la mise à niveau vers cette version ou une version ultérieure. |
|---|---|
2024.1 | Fonctionnalité administrative : possibilité de transférer la propriété des ressources via l'interface utilisateur et l'API Les administrateurs peuvent transférer la propriété des workflows et des planifications entre les utilisateurs via l'interface utilisateur Server ou à l'aide de points de terminaison de l'API Server V3. Impact :
Note
|
2024.1 | Nouvelle fonctionnalité : nouvelle option de base de données ajoutée (SQL DB) La base de données SQL Server gérée par l'utilisateur peut être utilisée à la place de MongoDB. Actuellement, la seule version officiellement prise en charge de SQL est MSSQL Server 2019 et 2022. Impact : |
2024.1 CRITIQUE | Mise à niveau de Python : mises à niveau de Python intégré de 3.8.16 à 3.10.13 Impact : Le message d'erreur suivant s'affiche si une version incompatible d'un connecteur est utilisée dans Designer : « La version 3.8 n'a pas été trouvée dans notre distribution Alteryx. Sélectionnez une autre version. Erreur interne - Blocage détecté. » Tâche :
|
2024.1 CRITIQUE | Modification du champ de date et heure MongoDB (horodatages de service convertis au format UTC dans les bases de données Server) Impact : nous avons converti tous les champs de date et heure en UTC pour améliorer la gestion des fuseaux horaires et de l'heure d'été. Pour plus d'informations, consultez les Notes de publication Server 2024.1.
Tâche : examinez comment les champs de date et heure sont gérés dans les applications qui accèdent à MongoDB ou à l'API. Ils peuvent avoir besoin d'être ajustés en fonction de la date/heure UTC. |
2024.1 | Gestion de Server Dev/Prod DCM : server Prod peut rediriger Dev DCM vers des connexions de production Impact : connexions DCM et Gestion des connexions DCM ajoutées au menu Admin. Pour plus d'informations, consultez les pages d'aide : Tâche : ajoutez des redirections DCM au Server Prod pour permettre aux workflows migrés depuis Dev d'accéder aux sources de données Prod sans modifier les workflows. |
2024.1 | Administration DCM : granularité des autorisations utilisateur Impact : nouvelles autorisations DCM ajoutées. Pour plus d'informations, consultez la page d'aide Rôles et autorisations des utilisateurs. |
2024.1 | Administration DCM : coffre-fort externe générique DCM ajouté Impact : vous pouvez configurer un coffre-fort générique pouvant récupérer des secrets à partir de n'importe quel coffre-fort avec une interface de programmation utilisant l'authentification de base. |
2024.1 | Modification administrative : partage simultané DCM Impact : vous pouvez partager la même connexion DCM pour la collaboration et, séparément, pour l'exécution. Auparavant, vous ne pouviez choisir qu'une seule option de partage. Pour plus d'informations, consultez la section Gestionnaire de connexion aux données : interface utilisateur Server. |
2024.1 | L'outil Analyse n'est plus disponible Impact : Insights n'est plus disponible dans Alteryx Server. Consultez la page FAQ pour plus d'informations. |
Nouveautés / Notes de publication
Version | Actions à effectuer lors de la mise à niveau vers cette version ou une version ultérieure. |
|---|---|
2024.2 ARRÊT TECHNIQUE CRITIQUE | Mise à niveau de la base de données MongoDB intégrée vers la version 7 Impact : dans le cadre de l'installation de Server 2024.2, MongoDB intégré sera mis à niveau vers la version 7.0. La version minimale de Server pour la mise à niveau est 23.2 (MongoDB version 6.0). Tâche : assurez-vous que la version de Server est 2023.2 ou 2024.1, puis suivez les étapes décrites dans les Notes de publication Server 2024.2. |
2024.2 | Migrer les connexions aux données et les workflows vers DCM Vous pouvez désormais migrer des connexions de données de Server partagé vers des connexions DCM. Pour ce faire, consultez Migrer les connexions aux données de Server vers DCM et Connexions aux données. |
2024.2 | Possibilité de limiter les utilisateurs d'un Studio à un utilisateur Les administrateurs ont la possibilité de désactiver les studios partagés en limitant le nombre d'utilisateurs d'un studio à un seul. En tant qu'administrateur, vous pouvez maintenant transférer facilement la propriété des ressources en transférant le workflow d'un studio à un autre. Pour limiter le nombre de membres d'un studio à un seul utilisateur, accédez à Administrateur >Paramètres >Configuration >Utilisateurs. Cochez ensuite la case Limiter Studio à un utilisateur. Pour en savoir plus, consultez la page Paramètres Alteryx Server. |
2024.2 | Restriction pour les workflows publics : paramètre global Les administrateurs peuvent désormais contrôler la façon dont les workflows sont publiés (publiquement ou non) en cochant ou en décochant la case Restreindre le workflow public (Global). Pour ce faire, accédez à Administrateur >Paramètres >Sécurité. Pour en savoir plus, consultez la page Paramètres Alteryx Server. |
2024.2 | Paramètres du proxy Designer développés Dans Designer, Options > Paramètres utilisateur > Modifier les paramètres utilisateur > Proxy > Activer les nouveaux paramètres proxy (aperçu) a été ajouté pour fournir un meilleur contrôle sur les paramètres proxy et pour autoriser les scripts PAC. Remarque : dans cette version initiale, le paramètre s'applique à plusieurs fonctionnalités (par exemple, l'outil Télécharger) mais pas à d'autres (par exemple, les connecteurs ou ODBC) dans Designer. Voir Paramètres utilisateur pour plus de détails. |
2024.2 | Le paramètre système Annuler les tâches exécutées pendant plus de (secondes) s'applique désormais à toutes les tâches Dans les versions précédentes, ce paramètre s'appliquait uniquement aux tâches planifiées. Pour permettre aux tâches manuelles de s'exécuter plus longtemps que les tâches planifiées, désactivez ce paramètre et utilisez les deux nouvelles options de l'interface utilisateur Server décrites ci-dessous. Pour en savoir plus, consultez la page Paramètres Alteryx Server. |
Option ajoutée pour annuler les exécutions de tâches manuelles de longue durée Dans Interface utilisateur Server > Administrateur > Paramètres > Ressources, une nouvelle option permet d'annuler les exécutions manuelles de tâches (y compris les exécutions de tâches API) s'exécutant plus longtemps qu'une durée spécifiée. Cela s'applique à tous les workers sauf s'ils ont défini Paramètres système Alteryx > Général >Worker > Annuler les tâches exécutées pendant plus de (secondes). Le paramètre du Worker remplace le paramètre de l'interface utilisateur Server. | |
Option ajoutée pour annuler les exécutions de tâches planifiées de longue durée Dans Interface utilisateur Server > Administrateur > Paramètres > Ressources, une nouvelle option permet d'annuler les exécutions de tâches planifiées s'exécutant plus longtemps qu'une durée spécifiée. Cela s'applique à tous les workers sauf s'ils ont défini Paramètres système Alteryx > Général >Worker > Annuler les tâches exécutées pendant plus de (secondes). Le paramètre du Worker remplace le paramètre de l'interface utilisateur Server. | |
2024.2 | Mises à jour API : |
Filtrage d'API ajouté à GET v3/workflows/{workflowID}/jobs Le point de terminaison
Tâche : examinez comment les champs de date et heure sont gérés dans les applications qui accèdent à MongoDB ou à l'API. Ils peuvent avoir besoin d'être ajustés en fonction de la date/heure UTC. | |
Nouveaux points de terminaison d'API pour les souscriptions (studios) Les administrateurs peuvent désormais gérer les souscriptions (studios) à l'aide de points de terminaison d'API Server V3. Ces points de terminaison vous permettent de modifier les souscriptions en masse et de déplacer des utilisateurs individuels vers des studios individuels. Pour en savoir plus sur ces points de terminaison, consultez la page Points de terminaison de souscription. | |
Mises à jour d'API pour les points de terminaison de workflow
Pour plus d'informations, consultez les Notes de publication Server 2024.2 et Points de terminaisons de workflow. | |
Nouveau point de terminaison d'API pour permettre la mise à jour des paramètres de planification individuels Utilisez le nouveau point de terminaison d'API | |
Mises à jour des points de terminaison des tâches
Pour en savoir plus, consultez Points de terminaison des planifications. |