Présentation des mises à jour et des mises à niveau

Une fois que vous avez déployé ArcGIS Enterprise on Kubernetes, vous pouvez mettre à jour ou mettre à niveau le logiciel pour que votre organisation bénéficie des améliorations et fonctionnalités ArcGIS Enterprise les plus récentes , afin de garantir sa sécurité, sa fiabilité et ses performances.

Les différences entre les mises à jour et les mises à niveau sont les suivantes :

• Le champ d’application d'une mise à jour est plus étroit et peut se limiter au traitement des problèmes en matière de performance, de sécurité, de fonctionnalités et à la résolution de bogues. Une mise à jour n’introduit pas de nouvelles fonctionnalités ou de changements logiciels d’ordre esthétique ou ergonomique. Par exemple, une mise à jour peut migrer le logiciel de la version 10.9.0.300 à la version 10.9.0.412.
• Une mise à niveau est une nouvelle version logicielle présentant de nouvelles fonctionnalités, des fonctionnalités améliorées et parfois une esthétique différente. Par exemple, une mise à niveau peut migrer le logiciel de la version 10.9.0 à la version 10.9.1.

Exigences liées à la mise à niveau et à la mise à jour

Avant d’appliquer une mise à niveau ou une mise à jour, tenez compte des exigences suivantes :

• Vérifiez la configuration système requise, comme les valeurs de quota des ressources les plus récentes, avant de procéder à la mise à niveau.
• Pour prendre en charge une stratégie bleu-vert au cours des mises à niveau, il est nécessaire de provisionner un stockage supplémentaire.
• Si vous procédez à la mise à niveau à partir de la version 10.9 et avez configuré un proxy inverse pour votre organisation 10.9, vous devrez arrêter le proxy inverse avant de configurer ArcGIS Enterprise on Kubernetes Web Adaptor pour votre organisation 10.9.1 mise à niveau.
• Avant d’appliquer une mise à jour ou une mise à niveau à une organisation 10.9.1 qui a été configurée avec ArcGIS Enterprise on Kubernetes Web Adaptor, vous devez arrêter le serveur Web hébergeant ArcGIS Enterprise on Kubernetes Web Adaptor. Lorsque la mise à jour ou la mise à niveau est terminée, redémarrez le serveur Web.

Mise à jour requise

Une mise à jour requise inclut des exigences fonctionnelles et doit être appliquée avant la migration vers une nouvelle version logicielle. Si vous procédez à une mise à niveau vers une nouvelle version logicielle et qu’une mise à jour requise est disponible, il vous est demandé d’appliquer d’abord cette dernière.

Appliquer ou supprimer une mise à jour

Un administrateur peut appliquer des mises à jour et des mises à niveau à l'aide de ArcGIS Enterprise Manager ou API ArcGIS Enterprise Administrator. Dans ArcGIS Enterprise Manager, cette opération s'effectue à partir de la page Software updates (Mises à jour logicielles).

• Lorsqu’une nouvelle version de ArcGIS Enterprise on Kubernetes est publiée, l’option de mise à niveau apparaît en haut de la page.
• Lorsque des mises à jour logicielles sont disponibles, elles apparaissent dans la partie inférieure de la page.

La page Software updates (Mises à jour logicielles) contient les onglets suivants, qui représentent le statut des nouvelles mises à jour, indiquent celles qui ont été appliquées, ainsi que l'historique de celles qui ont été appliquées ou annulées :

• Updates (Mises à jour) : mises à jour disponibles qui ne sont pas encore appliquées à votre organisation.
• Applied (Appliquées) : mises à jour que votre organisation a appliquées. Cet onglet vous permet de supprimer manuellement une mise à jour.
• History (Historique) : mises à jour logicielles effectuées par votre organisation, y compris des correctifs appliqués ou annulés et des mises à niveau appliquées.

Mode de lecture seule

Lorsqu’une mise à jour ou une mise à niveau est en cours, ArcGIS Enterprise est défini en mode lecture seule. Dans ce mode, les membres de votre organisation peuvent voir le contenu, les utilisateurs, les groupes et les paramètres, mais ne peuvent pas les modifier. Pendant ce temps, une notification s'affiche dans la bannière supérieure de ArcGIS Enterprise Manager pour informer l'organisation.

Lorsqu’une mise à niveau ou une mise à jour est terminée, le mode lecture seule est désactivé et les opérations normales peuvent reprendre dans l'organisation.

Processus de mise à jour et de mise à niveau

Les processus de mise à jour et de mise à niveau sont intégrés au logiciel. Vous pouvez accéder aux améliorations et aux nouvelles fonctionnalités sans installer de logiciel supplémentaire. Les administrateurs peuvent utiliser ArcGIS Enterprise Manager ou API ArcGIS Enterprise Administrator pour déterminer lorsqu'une mise à jour ou une mise à niveau est disponible.

Lorsqu'une mise à jour est disponible, elle est représentée sous la forme d'une nouvelle image de conteneur ou d'un ensemble d'images et est intégrée dans l'hôte du registre de conteneur (docker.io, par exemple). API ArcGIS Enterprise Administrator utilise une URL connue pour identifier un manifeste de version publié par Esri afin de déterminer si une mise à jour est disponible. L'identification du manifeste permet de développer une stratégie de mise à niveau et de mettre à disposition l'option de mise à jour ou de mise à niveau.

Les mises à niveau et les mises à jour suivent généralement les deux modèles décrits ci-dessous.

Bleu-vert

Les nouveaux déploiements Kubernetes sont démarrés à l'aide des nouvelles images de conteneur pour mettre à niveau et migrer les données sous-jacentes, le cas échéant. Les instances de stockage de données secondaires ou d'autres réplicas sont ensuite ajoutés au stockage de données. Une fois que le nouveau stockage de données est considéré comme sain, l'ancien stockage de données est arrêté, pour laisser uniquement une instance saine du nouveau stockage de données. Par exemple, cette stratégie peut être utilisée lors de la mise à jour des stockages de données hébergés.

Annulation

Au fur et à mesure que les nouveaux pods activés par de nouvelles images de conteneur sont déployés, les anciens pods sont arrêtés par annulation. Ce processus réduit la durée d'indisponibilité. Cette stratégie peut, par exemple, être utilisée lors de la mise à jour de services SIG.

Dépanner

En cas d’échec lors d’une mise à jour ou d’une mise à niveau, identifiez et résolvez les problèmes en procédant comme suit :

• Pendant une mise à jour ou une mise à niveau, affichez l’onglet History (Historique) pour identifier une éventuelle erreur. Lorsque des messages de statut sont renvoyés, l’option permettant d’afficher les journaux est également disponible et peut fournir des indications sur les actions requises. Il est recommandé de filtrer le niveau de consignation sur le statut grave pour afficher des journaux spécifiques pendant la mise à jour.
• Si vous rencontrez un message concernant un déploiement qui ne parvient pas à actualiser un déploiement particulier, procédez comme suit :
  • Sur la page Logs (Journaux) de ArcGIS Enterprise Manager, cliquez sur Manage columns (Gérer les colonnes).
  • Activez l’option Stack trace (Trace de la pile d’appels) pour afficher cette colonne.
  • Si vous rencontrez une erreur de délai d’expiration dans la trace de la pile, comme Timing out patch operation (Expiration de l’opération de correctif), il se peut que la durée de démarrage d’un ou de plusieurs conteneurs ait dépassé les temps d’attente et de délai d’expiration attendus, entraînant l’échec de la mise à niveau. Pour résoudre ce problème, augmentez la valeur de containerStartUpTimeoutSeconds dans API ArcGIS Enterprise Administrator, dans System (Système) > Properties (Propriétés). La nouvelle valeur doit être supérieure à la valeur par défaut, égale à 1800 secondes. Une fois la valeur augmentée, exécutez à nouveau la mise à niveau.
• Si des membres ne peuvent pas accéder à l’organisation après une mise à niveau, par exemple, si des administrateurs ou d’autres comptes de membre ne parviennent pas à se connecter à ArcGIS Enterprise Manager ou au portail, il se peut que le data store relationnel subisse un problème. Dans ce cas, procédez comme suit :
  • Dans Lens ou un autre outil de surveillance de cluster Kubernetes, localisez les pods arcgis-relational-store. Si un ou plusieurs de ces pods ne sont pas en cours d’exécution, restaurez le système à partir de votre sauvegarde.