Skip to main content

Préparer la mise à niveau

En procédant à la mise à niveau vers une nouvelle version d’ArcGIS Enterprise on Kubernetes, votre organisation bénéficie de nouvelles fonctionnalités et de fonctions améliorées. Découvrez les nouvelles fonctionnalités et identifiez les changements susceptibles d’affecter les membres de votre organisation.

Avant toute mise à niveau, assurez-vous que votre environnement satisfait la configuration requise. Certaines exigences sont nécessaires pour tous les environnements et il existe des exigences spécifiques à chaque environnement que vous devrez peut-être satisfaire selon votre configuration.

Conseil :

Vous pouvez définir ou modifier l’affinité des nœuds et les tolérances des pods qui sont utilisés pendant les mises à jour ou les mises à niveau. Une fois créée, la politique de placement s’applique à chaque fois qu’une tâche de mise à niveau est créée. Les valeurs que vous définissez sont conservées pour toutes les mises à jour et mises à niveau ultérieures jusqu’à ce qu’elles soient réinitialisées. Pour plus de détails, reportez-vous à la rubrique Mettre à jour (configuration des mises à niveau).

Exigences liées à la mise à niveau

Les conditions suivantes doivent être remplies avant une mise à niveau :

  • Votre environnement doit satisfaire la configuration système requise pour cette version. La version Kubernetes prise en charge, la taille de disque du nœud worker, le stockage système requis et les autres exigences système ont pu changer dans cette version. Assurez-vous que la version Kubernetes de votre cluster est prise en charge à la fois pour votre version actuelle d’ArcGIS Enterprise on Kubernetes et pour cette version.

  • Vous devez avoir une sauvegarde de votre organisation. Il est recommandé d’effectuer une nouvelle sauvegarde avant de procéder à une mise à niveau.

  • Vous devez disposer d’une licence ArcGIS Enterprise on Kubernetes unifiée pour cette version.

  • Si une mise à jour requise est disponible, vous devez l’appliquer avant de migrer vers cette version. Consultez les notes de publication pour en savoir plus sur la dernière mise à jour requise.

  • Vous devez exécuter le script préalable à la mise à niveau. Ce script détecte et traite les exigences fonctionnelles pour se conformer à la configuration requise par la version logicielle actuelle.

  • Vous devez mettre à jour les valeurs de quota des ressources dans votre espace de noms selon la configuration requise de la version.

  • Votre environnement doit répondre aux normes de sécurité de pod, telles que les normes d’admission de sécurité de pod avant la mise à niveau.

  • Les tailles des volumes des data stores doivent correspondre aux exigences minimales requises pour la version que vous mettez à niveau. Si l’extension du volume n’est pas disponible pour le provisionneur utilisé par la classe de stockage, restaurez une sauvegarde pour configurer une nouvelle organisation avec des volumes supérieurs. Le non-respect des conditions de stockage minimales requises risque d’aboutir à des problèmes lors du chargement des éléments de votre organisation et du démarrage des services.

  • Pour mettre à niveau le store relationnel, une sauvegarde est créée dans le même volume persistant que l’instance de data store relationnel. Cette sauvegarde requiert qu’au moins 50 % de la taille de la base de données soit disponible. Par exemple, si le store relationnel utilise actuellement 100 Go de stockage, au moins 50 Go doivent être disponibles sur le volume persistant associé avant la mise à niveau, pour atteindre la taille de volume totale requise de 150 Go ou plus. Pour des instructions sur l’augmentation de la taille du volume, reportez-vous à la rubrique Gérer le stockage requis.

  • Pour tenir compte des données supplémentaires écrites lors de la mise à niveau, assurez-vous que l’object store dispose d’au moins 20 Go d’espace disponible et que le spatiotemporal store et l’index store disposent d’au moins 20 % d’espace disponible. Ainsi, les data stores ne passent pas en mode lecture seule pendant la mise à niveau.

  • Toutes les licences ArcGIS Pro hors connexion doivent être archivées par les membres de votre organisation. Vous pouvez afficher l’activité des licences pour déterminer les membres qui ont extrait leur licence ArcGIS Pro afin de l’utiliser hors connexion. Pour plus d’informations sur la manière d’archiver une licence hors connexion, reportez-vous à la rubrique Archiver une licence hors connexion.

Exigences de mise à niveau spécifiques de l’environnement

Selon la configuration de votre environnement, il se peut que vous deviez remplir des exigences supplémentaires avant de procéder à une mise à niveau :

Ajuster les volumes persistants statiques pour les mises à niveau

Avant une mise à niveau, chaque pod dans les StatefulSet rest-portal-api, in-memory-store et queue-store doit être configuré avec un volume persistant supplémentaire. Chaque volume persistant doit être configuré avec des spécifications équivalentes à celles spécifiées lors du déploiement. Reportez-vous aux exigences de taille et d’étiquette correspondantes.

Par exemple, si rest-portal-api est configuré avec deux pods, vous devez provisionner deux volumes supplémentaires qui répondent aux exigences de taille et d’étiquette pour item-packages-volume.

Une fois que la mise à niveau est terminée, rest-portal-api, in-memory-store et queue-store utilisent les volumes persistants nouvellement provisionnés, ainsi que la réclamation de volume persistant (PVC). Le jeu de volumes d’origine peut alors être supprimé. Il est fortement recommandé de supprimer tout volume persistant à l’état publié car les volumes persistants publiés lors des mises à niveau ou mises à jour précédentes ne doivent jamais être réutilisés.