Mettre à niveau ArcGIS Notebook Server

Lors de la mise à niveau de ArcGIS Notebook Server, votre organisation bénéficie des 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 vers 10.9.1, vous devez également mettre à niveau ArcGIS Notebook Server.

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

Au cours de la procédure de mise à niveau, vous devez autoriser de nouveau votre logiciel ArcGIS Notebook Server pour la version 10.9.1 si vous migrez depuis la version 10.8.1 ou une version antérieure.

Vous devez également installer les nouvelles images de conteneur d’Esri, en indiquant les exécutions des notebooks 10.9.1 à vos utilisateurs. Les exécutions des notebooks de la version précédente restent sur le site. Les utilisateurs peuvent exécuter les notebooks à l’aide de ces exécutions. Cependant, si vos utilisateurs souhaitent utiliser une nouvelle fonctionnalité dans 10.9.1, ils doivent mettre à jour l’exécution de leurs notebooks. Les runtimes des notebooks 10.9.1 correspondent à la version 6.0 (ArcGIS Notebook Server Standard 6.0 et ArcGIS Notebook Server Advanced 6.0).

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 comportant plusieurs ordinateurs sont pris en charge par les versions 10.7.1 et ultérieures. Si votre site comprend un seul ordinateur et que vous voulez étendre votre site ArcGIS Notebook Server à plusieurs ordinateurs après la mise à niveau, procédez comme suit pour joindre des ordinateurs supplémentaires au site à l’issue de la mise à niveau vers 10.9.1.

La procédure de mise à niveau de ArcGIS Notebook Server est une mise à niveau sur place, 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 vers 10.9.1, suivez la procédure ci-dessous.

Préparer la mise à niveau

Avant la mise à niveau, étudiez soigneusement les 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 10.9.1.
• Pour que ArcGIS Notebook Server fonctionne correctement, sa version doit correspondre à celle du portail avec lequel il est fédéré.
• Mettre à niveau Docker vers une version prise en charge
• Pour mettre à niveau votre déploiement ArcGIS Enterprise, procédez comme suit :
  1. Mettez à niveau Portal for ArcGIS.
  2. Mettez à niveau ArcGIS Web Adaptor (pour le portail).
  3. Mettez à niveau le site ArcGIS Server qui fait office de serveur d’hébergement du portail.
  4. Mettez à niveau ArcGIS Web Adaptor (pour Server).
  5. Mettez à niveau ArcGIS Data Store (d’abord l’ordinateur principal, puis l’ordinateur de secours).
  6. Mettez à niveau les autres serveurs éventuels, dont ArcGIS Notebook Server.
  7. Installer les exemples de données ArcGIS Notebook Server
• Ne désinstallez pas l’instance ArcGIS Notebook Server existante. Les programmes d’installation via la ligne de commande et l’utilitaire de configuration de 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 ArcGIS Notebook Server sur le portail ou de supprimer sa désignation de serveur de notebooks du portail à un moment de la procédure de mise à niveau. Cela a un impact négatif sur les notebooks ArcGIS existants hébergés par le portail.
• Vous pouvez mettre à niveau ArcGIS Notebook Server à l’aide du programme d’installation via la ligne de commande ou l’utilitaire de configuration. 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.
• Le compte de service Windows de votre site ArcGIS Notebook Server [son compte d’identification (Exécuter en tant que)] doit rester identique pendant la mise à niveau.

Sauvegarder votre déploiement

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

Héritage :

Dans la version 10.7, vous devez sauvegarder manuellement le magasin de configurations du site et les répertoires du serveur.

Les notebooks seront inclus dans les sauvegardes du portail à l’aide de l’utilitaire webgisdr.

Vous pouvez utiliser l’opération exportSite dans le répertoire administrateur de ArcGIS Notebook Server pour sauvegarder un magasin de configurations d’un site, comme indiqué ci-dessous. Outre la sauvegarde de la configuration de ce site, envisagez d’effectuer des sauvegardes manuelles de votre système de fichiers.

Pour exécuter l’opération de sauvegarde, procédez comme suit :

1. Ouvrez le répertoire administrateur ArcGIS Notebook Server et connectez-vous en tant qu’utilisateur doté de privilèges d’administration. L’URL est généralement la suivante : https://notebookserver.domain.com:11443/arcgis/admin.
2. Accédez à site > Export Site (Exporter un site).
3. Saisissez le chemin complet de l’emplacement où vous souhaitez exporter le fichier sur votre machine. Le site doit pouvoir accéder à ce répertoire.
4. Cliquez sur Exporter.
5. Une fois l’exportation terminée, le répertoire fournit un lien vers l’emplacement du fichier de sauvegarde sur le serveur. Téléchargez le fichier, dont l’extension est .agssite, le plus tôt possible.

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

Remarque :

Utilisez le fichier d’installation pour mettre à niveau ArcGIS Notebook Server et passer à la version 10.9.1. 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.

1. ArcGIS Notebook Server est conçu pour détecter et mettre à niveau une installation existante des composants ArcGIS Notebook Server. Pour lancer la mise à niveau, exécutez ./Setup à partir du dossier d’extraction de ArcGIS Notebook Server, puis conformez-vous aux invites pour terminer la mise à niveau. La configuration doit être réalisée par le biais du compte d’utilisateur qui a installé l’instance ArcGIS Notebook Server existante. Au cours de l’installation, le programme d’installation identifiera l’installation existante et vous serez invité à confirmer que vous souhaitez bien procéder à la mise à niveau. Saisissez le choix y pour poursuivre l’installation.

   Cette option va désinstaller la version précédente de ArcGIS Notebook Server et installer la version mise à niveau de ArcGIS Notebook Server.

2. Une fois que l’utilitaire de mise à niveau est arrivé à son terme, vous devez autoriser de nouveau votre logiciel ArcGIS Notebook Server pour la version 10.9.1. 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 votre 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

1. Pour lancer la mise à niveau, exécutez la commande d’installation de Notebook Server avec l’argument indiqué dans l’exemple figurant ci-dessous. Cette option va désinstaller la version précédente de ArcGIS Notebook Server et installer la version mise à niveau de ArcGIS Notebook Server. Assurez-vous d’utiliser le même compte ArcGIS Notebook Server que celui utilisé par votre installation existante.

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password>

2. Utilisez l’utilitaire upgradesite et finalisez la mise à niveau en exécutant la commande suivante. Par défaut, l’utilitaire upgradesite se trouve sur C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat

   upgradesite.bat -s

   L’utilitaire affiche des rapports de progression et s’arrête une fois la mise à niveau terminée. L’utilitaire comporte deux paramètres :

   • -s : lorsqu’il est inclus dans la commande, ce paramètre invite l’utilitaire à procéder à la mise à niveau. La mise à niveau ne sera pas effectué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.

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

Autoriser en mode silencieux

Une fois que l’utilitaire de mise à niveau est arrivé à terme, vous devez autoriser de nouveau votre logiciel ArcGIS Notebook Server pour la version 10.9.1 si vous avez migré de la version 10.8.1 ou d’une version antérieure.

Exécutez SoftwareAuthorization.exe en utilisant la syntaxe suivante pour autoriser ArcGIS Notebook Server en mode silencieux. Avant d’exécuter le fichier, vous devez disposer de toutes les informations utilisateur dans le fichier d’autorisation ou d’approvisionnement.

Si vous disposez d’un fichier d’autorisation et que votre ordinateur est connecté à Internet, exécutez le code suivant :

<System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /S /Ver 10.7 /LIF <full path and name of authorization file>

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 de ArcGIS Notebook Server terminée :

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /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 Web du service client Esri sur https://service.esri.com/drm. Suivez les instructions à l’écran pour charger votre fichier contenant les informations d’autorisation et téléchargez votre fichier d’autorisation .ecp.
   • Envoyez le fichier d’informations d’autorisation par courrier électronique à [e-mail]. Esri vous renverra le fichier d’autorisation .ecp dans un message électronique.
3. Une fois que vous avez reçu votre fichier d’autorisation .ecp en suivant l’une des deux méthodes mentionnées ci-dessus, exécutez de nouveau le script authorizeSoftware pour le traiter et terminer le processus d’autorisation du serveur :

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .ecp file>

Répétez ce processus pour chaque ordinateur sur lequel ArcGIS Notebook Server doit être installé.

Étapes après la mise à niveau

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

Exécuter l’utilitaire de post-installation

1. Ouvrez la fenêtre d’invite de commande en tant qu’administrateur.
2. Accédez au dossier des outils ArcGIS Notebook Server. Par défaut, le chemin est C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.
3. Pour consulter l’aide de l’utilitaire, s’il y a lieu, exécutez la commande suivante : > PostInstallUtility.bat -h
4. ArcGIS Notebook Server requiert l’installation de Docker Engine Community Edition sur votre machine. Pour déterminer si Docker est actif sur votre machine, exécutez la commande suivante : > PostInstallUtility.bat -d
5. Si Docker n’est pas installé, installez-le maintenant.

   ArcGIS Notebook Server utilise des conteneurs Linux dans Docker, et non des conteneurs Windows. Lorsque vous installez Docker, veillez à spécifier des conteneurs Linux et ne cliquez pas sur l’option Switch to Windows containers (Utiliser des conteneurs Windows).

6. Modifiez chacun des paramètres ci-dessous dans Docker :
   1. Cliquez avec le bouton droit sur le bouton Docker dans la barre d’état système et cliquez sur Settings (Paramètres). Sous General (Général), cochez la case Expose daemon on tcp://localhost:2375 without TLS (Exposer le démon sur tcp://localhost:2375 sans TLS).

      Vous allez utiliser Docker Remote API, qui implique d’utiliser le port 2375.

   2. Cliquez avec le bouton droit sur le bouton Docker dans la barre d’état système et cliquez sur Settings (Paramètres). Dans le menu Settings (Paramètres), cliquez sur Resources (Ressources) > File sharing (Partage de fichiers) et ajoutez le répertoire de lecteur qui sera utilisé comme répertoire de configuration ArcGIS Notebook Server.

      Remarque :

      Docker for Windows prend uniquement en charge les répertoires locaux sur Windows à partager avec des conteneurs Linux.

7. Installez votre image Docker en spécifiant le chemin d’accès à son fichier. L’image doit être compressée au format .tar.gz. Si vous disposez d’une licence Advanced, exécutez la commande deux fois pour installer les images de conteneur Standard et Advanced que vous avez téléchargées depuis My Esri. Exécutez la commande suivante : > PostInstallUtility.bat -l <path of .tar.gz Docker image>

   Remarque :

   Veillez à installer les images des deux conteneurs. Même si vous disposez d’une licence Advanced, vos utilisateurs peuvent toujours avoir besoin de l’exécution Standard.

Installer et configurer les exemples de données ArcGIS Notebook Server

Pour la configuration d’un site ArcGIS Notebook Server à plusieurs machines, vous devez installer et configurer les exemples de données uniquement sur la première machine où vous avez installé Notebook Server et créé le site.

Pour installer et configurer les exemples de données, procédez comme suit :

1. Exécutez l’assistant d’installation des exemples de données ArcGIS Notebook Server que vous avez téléchargés à partir de My Esri.

   Les exemples de données seront installés dans le répertoire d’installation de ArcGIS Notebook Server.

2. Ouvrez la fenêtre d’invite de commande en tant qu’administrateur.
3. Modifiez les répertoires pour utiliser le dossier d’outils de ArcGIS Notebook Server.

   Par défaut, le chemin est C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.

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

    > PostInstallUtility.bat -h

5. Exécutez l’utilitaire de post-installation pour extraire les exemples de données dans le répertoire arcgisworkspace du site Notebook Server :

    PostInstallUtility.bat -x

Remplacer les instances ArcGIS Web Adaptor

1. Annulez l’enregistrement de l’instance précédente de ArcGIS Web Adaptor sur votre site et désinstallez-la.
   1. Connectez-vous au répertoire d’administration de ArcGIS Notebook Server.
   2. Sélectionnez System (Système) > Web Adaptors > ordinateur enregistré.
   3. Cliquez sur Unregister Web Adaptor (Annuler l’enregistrement de Web Adaptor)
2. Installez une nouvelle instance de ArcGIS Web Adaptor 10.9.1 et enregistrez-le avec ArcGIS Notebook Server.
3. Une fois la mise à niveau du déploiement terminée, vous pouvez tirer parti des fonctionnalités de 10.9.1. Si vous mettez à niveau une version 10.8 ou antérieure, procédez comme suit pour programmer les notebooks sur votre portail :

   • Mettez à niveau vos rôles personnalisés qui comporte des privilèges concernant les notebooks pour ajouter le nouveau privilège Schedule Notebooks (Programmer des notebooks), si vous le souhaitez.
   • Indiquez aux auteurs de notebooks de mettre à niveau l’exécution de chacun de leurs notebooks s’ils veulent utiliser la fonction de programmation. Seuls les notebooks utilisant le runtime 10.8.1 (version 4.0) ou une version ultérieure peuvent faire l’objet d’une programmation.

Votre site ArcGIS Notebook Server 10.9.1 st maintenant prêt à héberger ArcGIS Notebooks.