Skip to main content

Mettre à niveau ArcGIS Notebook Server

La mise à niveau d’ArcGIS Notebook Server permet d’offrir à votre organisation les dernières fonctionnalités et améliorations du logiciel, tout en préservant la version existante d’ArcGIS Notebooks. Si vous effectuez une mise à niveau de votre déploiement ArcGIS Enterprise, vous devez également mettre à niveau ArcGIS Notebook Server vers la même version.

Le paquetage d’installation d’ArcGIS Notebook Server détecte si une version antérieure d’ArcGIS Notebook Server est déjà installée sur votre ordinateur. Si c’est le cas, il peut mettre à niveau le logiciel.

Vous devez également installer les nouvelles images de conteneur d’Esri, en indiquant les runtimes de notebook appropriés à vos utilisateurs. Les runtimes des notebooks de la version précédente restent sur le site. Les utilisateurs peuvent continuer d’exécuter les notebooks à l’aide de ces runtimes. Cependant, si vos utilisateurs souhaitent utiliser les fonctionnalités prises en charge dans la version la plus récente, ils doivent mettre à jour le runtime de leurs notebooks.

Remarque :

Si des notebooks utilisaient des runtimes personnalisés, vous devez recréer et réinscrire les runtimes personnalisés sur le Notebook Server Windows et mettre à jour les paramètres de runtime des éléments de notebook associés.

Remarque :

Des runtimes de notebooks seront retirés à la fin du cycle de vie d’ArcGIS Enterprise. Un runtime de notebook sera retiré en même temps que la version associée d’ArcGIS Enterprise. Les notebooks ne doivent pas utiliser de runtimes retirés et doivent être mis à jour avec un runtime pris en charge.

La mise à niveau du portail ArcGIS Enterprise met également à jour les exemples de notebooks disponibles dans la bibliothèque du site.

Les sites ArcGIS Notebook Server à plusieurs machines sont pris en charge. Si votre site comprend une seule machine et que vous voulez étendre votre site ArcGIS Notebook Server à plusieurs machines après la mise à niveau, suivez la procédure visant à joindre des machines supplémentaires à un site à l’issue de la mise à niveau.

La procédure de mise à niveau d’ArcGIS Notebook Server est une mise à niveau sans déplacement des données, qui n’implique pas de désinstaller et de réinstaller le logiciel. Le site sera hors service pendant la procédure de mise à niveau, et les utilisateurs ne pourront pas y accéder ou exécuter des notebooks tant que la mise à niveau n’est pas terminée.

Pour mettre à niveau ArcGIS Notebook Server, suivez la procédure ci-après.

Préparer la mise à niveau

Avant la mise à niveau, prenez connaissance des informations suivantes :

  • Avant de procéder à la mise à niveau, vous pouvez accéder à tous les fichiers nécessaires dans My Esri, notamment les images de conteneur les plus récentes.

  • Pour qu’ArcGIS Notebook Server fonctionne correctement, sa version doit correspondre à celle du portail avec lequel il est fédéré.

  • Si votre serveur de notebook est actuellement en mode de lecture seule, désactivez ce mode avant d’exécuter la mise à niveau.

  • Installez un moteur de conteneurisation pour ArcGIS Notebook Server.

  • Mettez à niveau votre déploiement ArcGIS Enterprise.

  • Mettez à niveau tous les autres serveurs, y compris ArcGIS Notebook Server.

  • Ne désinstallez pas l’instance d’ArcGIS Notebook Server existante. Les programmes d’installation via la ligne de commande et l’utilitaire de configuration d’ArcGIS Notebook Server sont conçus pour détecter et mettre à niveau une installation existante des composants ArcGIS Notebook Server.

  • Évitez d’annuler la fédération de votre site Notebook Server sur le portail ou de supprimer sa désignation de serveur de notebooks du portail au cours de la procédure de mise à niveau. Cela a un impact négatif sur les notebooks existants hébergés par le portail.

  • Vous pouvez mettre à niveau ArcGIS Notebook Server à l’aide du programme d’installation ou de l’utilitaire d’installation via la ligne de commande. Choisissez l’une de ces méthodes pour la mise à niveau.

  • Avant la mise à niveau, effacez le cache de tous les navigateurs Web utilisés sur l’ordinateur ArcGIS Notebook Server.

Déplacer le répertoire de l’espace de travail

Cette opération est nécessaire pour les déploiements d’ArcGIS Notebook Server sur une seule machine sous Linux dont le répertoire de l’espace de travail se trouve dans le répertoire d’installation de Notebook Server.

Remarque :

Vous pouvez ignorer cette étape si le répertoire de l’espace de travail se trouve déjà hors du répertoire d’installation d’ArcGIS Notebook Server.

  1. Connectez-vous au portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.

  2. Cliquez sur l’onglet Settings (Paramètres).

  3. Cliquez sur Directories (Répertoires).

  4. Déterminez si le chemin d’accès actuel au répertoire arcgisworkspace se trouve dans le répertoire d’installation d’ArcGIS Notebook Server.

    <installdir>/arcgis/notebook/directories/arcgisworkspace

    Si le répertoire arcgisworkspace se trouve dans le répertoire d’installation d’ArcGIS Notebook Server, vous devez placer le répertoire de l’espace de travail dans un emplacement en dehors du répertoire d’installation avant d’effectuer la mise à niveau.

    Si le répertoire arcgisworkspace ne se trouve pas dans le répertoire d’installation d’ArcGIS Notebook Server, vous pouvez ignorer les étapes suivantes de cette section.

  5. Cliquez sur Edit (Mettre à jour) pour le répertoire arcgisworkspace.

  6. Remplacez la valeur de chemin d’accès au répertoire existant par le nouveau chemin d’accès au répertoire arcgisworkspace situé en dehors du répertoire d’installation.

    <installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace

  7. Cliquez sur Save (Enregistrer).

  8. Copiez manuellement l’ensemble du contenu de l’ancien répertoire arcgisworkspace dans le nouveau répertoire arcgisworkspace.

Mettre à jour l’emplacement du configuration store

Cette opération est nécessaire pour les déploiements d’ArcGIS Notebook Server Linux dont le configuration store se trouve dans le répertoire d’installation de Notebook Server. Pour plus d’informations, reportez-vous à la rubrique Spécifier l’emplacement du configuration store.

Remarque :

Vous pouvez ignorer cette étape si le site utilise un configuration store basé sur le Cloud ou si le configuration store se trouve déjà hors du répertoire d’installation de Notebook Server.

  1. Connectez-vous au portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.

  2. Cliquez sur l’onglet Settings (Paramètres).

  3. Cliquez sur Configuration store.

  4. Vérifiez si le configuration store se trouve dans le répertoire d’installation de Notebook Server.

    Exemple de répertoire : /installation_directory/arcgis/notebookserver/usr/config-store.

  5. Si le configuration store se trouve dans le répertoire d’installation de Notebook Server, déplacez la configuration vers un emplacement externe en procédant comme suit :

    1. Remplacez le chemin par le nouvel emplacement.

      Exemple de répertoire : /installation_directory/arcgisnotebookserver/usr/config-store.

    2. Cliquez sur Yes (Oui) pour déplacer la configuration actuelle.

    3. Cliquez sur Save (Enregistrer).

Mettre à jour les répertoires de serveur

Cette opération est nécessaire pour les déploiements d’ArcGIS Notebook Server Linux dont les répertoires de serveur se trouve dans le répertoire d’installation de Notebook Server.

Remarque :

Il est inutile d’accomplir cette étape si le répertoire de serveur se trouve déjà hors du répertoire d’installation de Notebook Server.

  1. Connectez-vous au portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.

  2. Cliquez sur l’onglet Settings (Paramètres).

  3. Cliquez sur Directories (Répertoires).

  4. Vérifiez si les répertoires arcgisoutput, arcgisjobs et arcgissystem se trouvent dans le répertoire d’installation.

    /installation_directory/arcgis/notebookserver/usr/directories

  5. Si c’est le cas, procédez comme suit pour chaque répertoire.

    1. Cliquez sur Modifier.

    2. Remplacez le chemin par le nouvel emplacement.

      Exemple de répertoire : /installation_directory/arcgisnotebookserver/usr/directories/<server directory>.

    3. Cliquez sur Save (Enregistrer).

Mettre à jour le répertoire des journaux

Cette opération est nécessaire pour les déploiements d’ArcGIS Notebook Server Linux dont le répertoire des journaux se trouve dans le répertoire d’installation de Notebook Server.

Remarque :

Il est inutile d’accomplir cette étape si le répertoire des journaux se trouve déjà hors du répertoire d’installation de Notebook Server.

  1. Connectez-vous au portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.

  2. Cliquez sur l’onglet Settings (Paramètres).

  3. Cliquez sur Logs (Journaux).

  4. Vérifiez si le répertoire des journaux se trouve dans le répertoire d’installation.

    /installation_directory/arcgis/notebookserver/usr/directories

  5. Si c’est le cas, procédez comme suit pour le déplacer vers un emplacement externe.

    1. Remplacez le chemin par le nouvel emplacement.

      Exemple de répertoire : /installation_directory/arcgisnotebookserver/logs.

    2. Cliquez sur Save (Enregistrer).

    3. Copiez manuellement tout le contenu de l’ancien répertoire des journaux dans le nouvel emplacement.

Effectuer une sauvegarde du déploiement

Avant la mise à niveau, il est recommandé d’effectuer des sauvegardes du déploiement.

Pour plus d’informations, reportez-vous à la rubrique Sauvegarder et restaurer ArcGIS Notebook Server.

Mettre à niveau le moteur de conteneurisation

Mettez à niveau votre moteur de conteneurisation vers une version prise en charge.

Remarque :

Sur un site Notebook Server à plusieurs machines, effectuez cette étape sur chaque machine.

Mettre à niveau à l’aide du programme d’installation

Remarque :

Utilisez le fichier d’installation pour mettre à niveau ArcGIS Notebook Server. Après la mise à niveau du programme d’installation, vous pouvez mettre à niveau le site ArcGIS Notebook Server à l’aide de l’assistant de configuration ou de l’utilitaire de mise à niveau du site.

Si votre site est constitué de plusieurs ordinateurs, appliquez les étapes 1 à 3 pour un ordinateur et renouvelez ces opérations pour chaque ordinateur du site.

ArcGIS Notebook Server est conçu pour détecter et mettre à niveau une installation existante des composants ArcGIS Notebook Server.

Pour procéder à la mise à niveau à l’aide du programme d’installation, procédez comme suit :

  1. Exécutez ./Setup à partir de l’emplacement dans lequel ArcGIS Notebook Server a été extrait, puis conformez-vous aux invites pour terminer la mise à niveau.

    L’installation doit être effectuée avec le compte d’utilisateur ayant installé les composants ArcGIS Notebook Server existants. Au cours de l’installation, le programme d’installation identifie l’installation existante et vous êtes invité à confirmer que vous souhaitez bien procéder à la mise à niveau. Saisissez le choix y pour poursuivre l’installation.

    Cette option désinstalle la version précédente d’ArcGIS Notebook Server et installe la version mise à niveau d’ArcGIS Notebook Server.

  2. À la fin de l’exécution de l’utilitaire de mise à niveau, autorisez de nouveau le logiciel ArcGIS Notebook Server. Utilisez l’assistant d’autorisation logiciel pour finaliser le processus d’autorisation.

  3. Ouvrez l’assistant de configuration à l’aide de l’URL mentionnée à la fin de la mise à niveau de l’installation et suivez les instructions affichées à l’écran pour mettre à niveau le site.

  4. Pour un site à plusieurs ordinateurs, appliquez les étapes 1 à 3 pour chacun des ordinateurs du site.

Mettre à niveau à partir de la ligne de commande

Pour effectuer la mise à niveau à partir de la ligne de commande, procédez comme suit :

  1. Pour lancer la mise à niveau, exécutez ./Setup à partir du dossier dans lequel ArcGIS Notebook Server a été extrait, avec l’argument indiqué dans l’exemple ci-dessous, et conformez-vous aux invites pour effectuer la mise à niveau.

    Cette option désinstalle la version précédente d’ArcGIS Notebook Server et installe la version mise à niveau d’ArcGIS Notebook Server.

    <untar directory>/Setup -l yes -m silent

  2. À la fin de l’exécution de l’utilitaire de mise à niveau, autorisez de nouveau le logiciel ArcGIS Notebook Server. Exécutez l’autorisation du logiciel en utilisant la syntaxe suivante pour autoriser ArcGIS Notebook Server en mode silencieux :

    <ArcGIS Notebook Server install directory>/tools/authorizeSoftware

    Exécutez la commande suivante pour afficher toutes les options d’autorisation :

    <ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

    Remarque :

    Reportez-vous à la section Autoriser dans un environnement déconnecté ci-dessous pour en savoir plus sur l’autorisation des installations d’ArcGIS Notebook Server dans un environnement déconnecté.

  3. Mettez le site à niveau à l’aide de l’utilitaire de ligne de commande upgradesite.

    Cet utilitaire comporte deux paramètres :

    • -s : s’il est inclus dans la commande, ce paramètre invite l’utilitaire à procéder à la mise à niveau. La mise à niveau n’est pas exécutée sans -s. Ce paramètre possède une visée protectrice pour s’assurer que vous n’exécutez la mise à niveau que lorsque vous être prêt.

    • -h : affiche l’aide relative à l’outil. Lorsque la commande est exécutée sans -s, l’aide s’affiche également.

    Par défaut, l’utilitaire upgradesite est disponible dans ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh.

    Avant la mise à niveau, consultez les informations de préparation au début de cette rubrique. Lorsque vous êtes prêt pour la mise à niveau, ouvrez un terminal de commande sur l’ordinateur que vous mettez à niveau. Accédez au répertoire de stockage de l’utilitaire et exécutez la commande suivante :

    > ./upgradesite.sh -s

    L’utilitaire affiche des rapports de progression et s’arrête une fois la mise à niveau terminée.

  4. Pour un site comportant plusieurs ordinateurs, appliquez les étapes 1 à 3 pour chaque ordinateur et passez aux étapes de la section suivante.

Autoriser en mode silencieux

À la fin de l’exécution de l’utilitaire de mise à niveau, vous devez autoriser de nouveau le logiciel ArcGIS Notebook Server.

Exécutez l’autorisation du logiciel en utilisant la syntaxe suivante pour autoriser ArcGIS Notebook Server en mode silencieux :

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware

Exécutez la commande suivante pour afficher toutes les options d’autorisation :

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

Autoriser dans un environnement déconnecté

Vous pouvez autoriser ArcGIS Notebook Server dans un environnement déconnecté au moyen d’un fichier d’approvisionnement (.prvc). Pendant la procédure, un fichier à transmettre à Esri est généré afin de finaliser la procédure.

  1. À l’invite, exécutez la commande fournie ci-dessous une fois la mise à niveau d’ArcGIS Notebook Server terminée.

    <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>

  2. Une fois le fichier contenant les informations en sortie créé, procédez de l’une des manières suivantes :

    • Accédez au site Esri en libre-service. Suivez les instructions à l’écran pour charger le fichier contenant les informations d’autorisation et téléchargez le fichier d’autorisation .ecp.

    • Envoyez le fichier d’informations d’autorisation par courrier électronique à l’adresse authorize@esri.com. Esri vous adressera un fichier d’autorisation .ecp par retour de courrier dans un message électronique.

  3. Lorsque vous recevez le fichier d’autorisation .ecp après avoir utilisé l’une des deux méthodes présentées ci-dessus, réexécutez le script authorizeSoftware pour le traiter et terminer la procédure d’autorisation du serveur :

    <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>

Répétez ce processus pour chaque machine sur laquelle fonctionne ArcGIS Notebook Server.

Étapes après la mise à niveau

Pour pouvoir utiliser le site ArcGIS Notebook Server mis à niveau et réautorisé, vous devez exécuter l’utilitaire post-installation pour ajouter de nouvelles images de conteneur Docker au site. Vous devez également remplacer les instances d’ArcGIS Web Adaptor enregistrées sur le site conformément à la nouvelle version.

Exécuter l’utilitaire post-installation

Pour exécuter l’utilitaire post-installation, procédez comme suit :

  1. Ouvrez un terminal à l’aide du compte d’installation d’ArcGIS Notebook Server.

  2. Redéfinissez le répertoire de travail sur le dossier des outils ArcGIS Notebook Server.

    Par défaut, ce chemin est ${HOME}/arcgis/notebookserver/tools/postInstallUtility.

  3. Pour consulter l’aide de l’utilitaire, s’il y a lieu, exécutez la commande suivante :

    ./PostInstallUtility.sh -h

  4. ArcGIS Notebook Server nécessite l’installation d’un moteur de conteneurisation sur la machine. Déterminez si un moteur de conteneurisation est actif sur la machine en exécutant la commande suivante :

    ./PostInstallUtility.sh -d

    1. Si les conditions requises pour l’installation de Docker ne sont pas remplies, installez-le à ce stade.

  5. Téléchargez les images de runtime nécessaires à l’installation depuis My Esri :

    • Image de conteneur Python ArcGIS Notebook Server (Standard)

    • Image de conteneur Python ArcGIS Notebook Server (Advanced)

      Remarque :

      Le runtime Advanced est nécessaire uniquement si vous disposez d’une licence ArcGIS Notebook Server Advanced.

  6. Installez l’image ou les images de runtime en spécifiant le chemin d’accès à leur fichier.

    Remarque :

    L’image doit être compressée au format .tar.gz.

    Remarque :

    Vérifiez que votre machine dispose d’au moins 75 Go d’espace disque disponible.

    Remarque :

    Si vous disposez d’une licence Advanced, veillez à installer les deux images de conteneur, car les utilisateurs peuvent toujours avoir besoin de l’exécution Standard.

    Exécutez la commande suivante :

    ./PostInstallUtility.sh -l <path of .tar.gz Docker image>

Remarque :

Les anciennes images ne sont pas supprimées automatiquement. Vous devez mettre à jour manuellement les runtimes associés à chaque notebook vers la version la plus récente avant de supprimer les images de runtime précédentes.

Remplacer les instances d’ArcGIS Web Adaptor

Pour remplacer des instances d’ArcGIS Web Adaptor, procédez comme suit :

  1. Annulez l’inscription de l’instance précédente d’ArcGIS Web Adaptor sur le site et désinstallez-la.

    1. Connectez-vous au répertoire d’administration d’ArcGIS Notebook Server.

    2. Sélectionnez System (Système) > Web Adaptors > registered machine (ordinateur enregistré).

    3. Cliquez sur Unregister Web Adaptor (Annuler l’enregistrement de Web Adaptor)

  2. Installez une nouvelle instance d’ArcGIS Web Adaptor et configurez-la avec ArcGIS Notebook Server.

    Une fois la mise à niveau de déploiement terminée, vous pouvez utiliser les fonctionnalités introduites avec la dernière version.

Le site ArcGIS Notebook Server est désormais prêt à héberger ArcGIS Notebooks.

Mettre à jour les runtimes de notebooks et outils Web existants

Chaque créateur de notebook doit suivre cette procédure pour mettre à niveau ses notebooks et ses outils Web de notebook de manière à utiliser les runtimes de notebook les plus récents.

  1. Suivez la procédure de la section Modifier le runtime d’un notebook pour mettre à jour le runtime de chaque élément de notebook vers le runtime de notebook le plus récent.

  2. Si un notebook est publié en tant qu’outil Web, remplacez l’outil Web après la mise à jour du runtime du notebook.

  3. Si des notebooks utilisaient des runtimes personnalisés, mettez à jour le runtime personnalisé et mettez à jour les paramètres de runtime des éléments de notebook associés.

Supprimer les runtimes de notebooks précédents

Vous pouvez également supprimer les versions précédentes de l’image des runtimes ArcGIS Notebook Server pour libérer de l’espace disque.

Attention :

Vérifiez que tous les notebooks existants ont été mis à jour pour utiliser la version la plus récente de l’image des runtimes ArcGIS Notebook Server avant de supprimer les versions précédentes.

  1. Ouvrez une invite de commande en tant qu'administrateur.

  2. Entrez la commande suivante pour obtenir la liste de vos images actuelles, puis notez l’ID d’image (IMAGE ID) de la version précédente à supprimer.

    docker images -a

  3. Entrez la commande suivante pour supprimer la version de runtime précédente.

    docker image rm <IMAGE ID>

ArcGIS Notebook Server sur des conteneurs Windows est pris en charge sous Windows Server 2022 et Windows Server 2025.

Remarque :

Si vous avez déjà installé ArcGIS Notebook Server sous Windows Server 2019, vous devez mettre à niveau le système d’exploitation avant de procéder à la mise à niveau d’ArcGIS Notebook Server sur des conteneurs Windows. Sinon, vous pouvez effectuer une installation propre d’ArcGIS Notebook Server sous Windows Server 2022 ou Windows Server 2025 et configurer ce logiciel comme serveur Notebook Server pour votre déploiement ArcGIS Enterprise.

Remarque :

Si votre serveur de notebook est actuellement en mode de lecture seule, désactivez ce mode avant d’exécuter la mise à niveau.

Effectuer une sauvegarde du déploiement

Avant la mise à niveau, il est recommandé d’effectuer des sauvegardes du déploiement.

Pour plus d’informations, reportez-vous à la rubrique Sauvegarder et restaurer ArcGIS Notebook Server.

Mettre à niveau ArcGIS Notebook Server installé sur un système d’exploitation Windows pris en charge

Pour mettre à niveau ArcGIS Notebook Server sur Windows Server 2022 ou Windows Server 2025, procédez selon les étapes suivantes :

  1. Mettez à niveau votre déploiement ArcGIS Enterprise.

  2. Si vous procédez à une mise à niveau depuis la version 11.3 ou une version antérieure, désinstallez les exemples de données ArcGIS Notebook Server à l’aide du programme de désinstallation des exemples de données d’ArcGIS Notebook Server ou à partir de la ligne de commande.

    Pour procéder à la désinstallation à partir de la ligne de commande, exécutez la commande suivante :

    msiexec /x {3A9E12F6-7D4B-4DA2-BA2C-C9D0E900CF94} /qb

  3. Mettez à niveau ArcGIS Notebook Server à l’aide du programme d’installation ou de la ligne de commande.

  4. Annulez l’inscription de l’instance précédente d’ArcGIS Web Adaptor sur le site.

  5. Désinstallez ArcGIS Web Adaptor.

  6. Installez une nouvelle instance d’ArcGIS Web Adaptor et configurez-la avec ArcGIS Notebook Server.

    Remarque :

    Vérifiez que le même non d’instance d’adaptateur Web est conservé.

  7. Mettez à niveau votre moteur de conteneurisation.

  8. Installez les images de conteneur Windows les plus récentes d’ArcGIS Notebook Server.

  9. Assurez-vous que le créateur de chaque notebook met à jour le runtime de ses éléments de notebook et outils Web de notebook existants vers le runtime ArcGIS Notebook Server le plus récent.

    Pour plus d’informations, reportez-vous à la section Modifier un runtime de notebook.

    Si un notebook est publié en tant qu’outil Web, vous devez remplacer cet outil Web après la mise à jour du runtime du notebook.

    Remarque :

    Si des notebooks utilisaient des runtimes personnalisés, vous devez recréer et réinscrire les runtimes personnalisés sur le Notebook Server Windows et mettre à jour les paramètres de runtime des éléments de notebook associés.

    Mettez à jour les paramètres d’utilisation de la mémoire et de l’UC configurés dans vos runtimes.

  10. Vous pouvez également supprimer la version précédente de l’image des runtimes ArcGIS Notebook Server pour libérer de l’espace disque.

    Attention :

    Vérifiez que tous les notebooks existants ont été mis à jour pour utiliser la version la plus récente de l’image du runtime ArcGIS Notebook Server.

    1. Répertoriez les images.

    docker images -a

    1. Notez l’identifiant IMAGE ID correspondant à la version précédente de l’image du runtime ArcGIS Notebook Server.

    2. Supprimez l’image.

    docker image rm <IMAGE ID>

Mettre à niveau ArcGIS Notebook Server sous Windows Server 2022 et migrer les conteneurs Linux vers les conteneurs Windows

Pour mettre à niveau ArcGIS Notebook Server sous Windows Server 2022 à partir d’une installation précédente et migrer depuis les conteneurs Linux vers les conteneurs Windows, procédez comme suit :

  1. Mettez à niveau votre déploiement ArcGIS Enterprise.

  2. Si vous procédez à une mise à niveau depuis la version 11.3 ou une version antérieure, désinstallez les exemples de données ArcGIS Notebook Server à l’aide du programme de désinstallation des exemples de données d’ArcGIS Notebook Server ou à partir de la ligne de commande.

    Pour procéder à la désinstallation à partir de la ligne de commande, exécutez la commande suivante :

    msiexec /x {3A9E12F6-7D4B-4DA2-BA2C-C9D0E900CF94} /qb

  3. Mettez à niveau ArcGIS Notebook Server à l’aide du programme d’installation ou de la ligne de commande.

  4. Annulez l’inscription de l’instance précédente d’ArcGIS Web Adaptor sur le site.

  5. Désinstallez ArcGIS Web Adaptor.

  6. Installez une nouvelle instance d’ArcGIS Web Adaptor et configurez-la avec ArcGIS Notebook Server.

    Remarque :

    Vérifiez que le même non d’instance d’adaptateur Web est conservé.

  7. Une fois que votre serveur de notebook a redémarré et que le répertoire du site administrateur est accessible, connectez-vous en tant qu’utilisateur administratif.

  8. Cliquez sur Notebooks > Runtimes.

  9. Exécutez la fonction Restore Factory Runtimes (Restaurer les runtimes d’usine).

    Les runtimes de notebooks Esri sont alors mis à jour pour utiliser les images de runtime de notebook basées sur les conteneurs Windows.

  10. Désinstallez Docker Desktop.

  11. Installez Mirantis Container Runtime ou Docker Engine à partir de binaires.

  12. Installez les images de conteneur Windows les plus récentes d’ArcGIS Notebook Server.

    Remarque :

    Pour un site à plusieurs machines, répétez les étapes 3 et 10 à 12 sur chaque machine du site.

  13. Assurez-vous que le créateur de chaque notebook met à jour le runtime de ses éléments de notebook et outils Web de notebook existants vers le runtime ArcGIS Notebook Server le plus récent.

    Pour plus d’informations, reportez-vous à la section Modifier un runtime de notebook.

    Si un notebook est publié en tant qu’outil Web, vous devez remplacer cet outil Web après la mise à jour du runtime du notebook.

    Remarque :

    Si des notebooks utilisaient des runtimes personnalisés, vous devez recréer et réinscrire les runtimes personnalisés sur le Notebook Server Windows et mettre à jour les paramètres de runtime des éléments de notebook associés.

  14. Mettez à jour les paramètres d’utilisation de la mémoire et de l’UC configurés dans vos runtimes.

Mettre à niveau ArcGIS Notebook Server sous Windows Server 2019 avec des conteneurs Linux vers ArcGIS Notebook Server sous Windows Server 2022 ou Windows Server 2025 avec des conteneurs Windows

Pour procéder à une mise à niveau vers ArcGIS Enterprise sous Windows Server 2022 ou Windows Server 2025 avec ArcGIS Notebook Server sur des conteneurs Windows à partir d’une installation précédente sous Windows Server 2019 avec des conteneurs Linux, procédez comme suit :

  1. Supprimez ArcGIS Notebook Server d’ArcGIS Enterprise en appliquant les sous-étapes suivantes :

    1. Connectez-vous à l’emplacement d’administration ArcGIS Portal Directory en tant qu’administrateur de votre organisation.

      Remarque :

      L’URL est https://webadaptorhost.domain.com/arcgis/portaladmin, où arcgis correspond au nom de l’instance Web Adaptor inscrite auprès du portail.

    2. Cliquez sur Federation (Fédération) > Servers (Serveurs).

    3. Sélectionnez le serveur de notebook dont vous souhaitez annuler la fédération.

    4. Cliquez sur Unfederate (Annuler la fédération).

  2. Mettez à niveau votre déploiement ArcGIS Enterprise.

  3. Sur la nouvelle machine de serveur de notebook, configurez les logiciels prérequis.

  4. Installez ArcGIS Notebook Server.

  5. Configurez ArcGIS Notebook Server après l’installation.

  6. Créez un site.

  7. Installez et configurez ArcGIS Web Adaptor.

  8. Pour un site à plusieurs machines, répétez les étapes 4 et 5 sur chaque machine et joignez des machines supplémentaires au site.

  9. Configurez ArcGIS Notebook Server avec le portail.

  10. Assurez-vous que le créateur de chaque notebook met à jour le runtime de ses éléments de notebook et outils Web de notebook existants vers le runtime ArcGIS Notebook Server le plus récent.

    Pour plus d’informations, reportez-vous à la section Modifier un runtime de notebook.

    Si un notebook est publié en tant qu’outil Web, vous devez remplacer cet outil Web après la mise à jour du runtime du notebook.

    Remarque :

    Si des notebooks utilisaient des runtimes personnalisés, vous devez recréer et réinscrire les runtimes personnalisés sur le Notebook Server Windows et mettre à jour les paramètres de runtime des éléments de notebook associés.

  11. Mettez à jour les paramètres d’utilisation de la mémoire et de l’UC configurés dans vos runtimes.

Configurer un déploiement en mode déconnecté

Si vous configurez ArcGIS Notebook Server dans un environnement sans accès à Internet ou dans lequel l’accès à Internet est interdit par votre organisation, reportez-vous à la rubrique Configurer un déploiement déconnecté.