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, passez en revue la configuration système requise.

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.

Remarques postérieures à la mise à niveau

Tenez compte des points suivants après une mise à niveau :

  • Étant donné que les composants du backup store sous-jacents ont changé, vous devez créer un nouveau backup store après avoir procédé à la mise à niveau à la version 11.0. Si vous ne le faites pas et avez besoin d’inscrire un backup store à l’aide d’un volume persistant préexistant, vous ne serez pas en mesure d’accéder aux sauvegardes de la version précédente de votre organisation. Si nécessaire, l’ancien backup store peut être utilisé pour rétablir la version antérieure de votre organisation.
  • Lorsque la mise à niveau est validée, les nouvelles sauvegardes doivent être stockées dans le backup store qui vient d’être inscrit. Vous pouvez annuler l’inscription de l’ancien backup store et le supprimer ainsi que le volume persistant pour récupérer les ressources dans le cluster.
  • Si vous avez configuré les services de calcul d’itinéraire en les publiant à l’aide de votre jeu de données réseau, il est recommandé de reconfigurer vos services de calcul d’itinéraire après une mise à niveau afin de pouvoir utiliser les dernières fonctionnalités. Pour republier les services de calcul d’itinéraire à l’aide de votre jeu de données réseau, procédez comme suit :
    1. Connectez-vous en tant qu’administrateur par défaut ou que rôle personnalisé disposant des privilèges appropriés pour gérer les paramètres du portail.
    2. En haut du site, cliquez sur Organization (Organisation), puis sur Settings (Paramètres).
    3. Cliquez sur Utility services (Services utilitaires) dans la partie gauche de la page.
    4. Cliquez sur Directions and Routing (Feuille de route et itinéraire) sur le côté droit de la page.
    5. Cliquez sur le bouton Update routing services (Mettre à jour les services de calcul d’itinéraire) et choisissez A network dataset that I'd like to publish (Un jeu de données réseau que je souhaite publier).
    6. Suivez la procédure présentée ici pour configurer les services de calcul d’itinéraire à l’aide de votre jeu de données réseau.

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.