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.8.1, vous devez également mettre à niveau ArcGIS Notebook Server.

Le paquetage d’installation de ArcGIS Notebook Server 10.8.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.8.1.

Lors de la procédure de mise à niveau, vous devez réautoriser votre logiciel ArcGIS Notebook Server pour la version 10.8.1 si la mise à niveau concernait la version 10.7.1 ou une version antérieure. Si vous effectuez la mise à niveau de la version 10.8 vers la version 10.8.1, vous n’avez pas besoin de réautoriser votre logiciel.

Vous devez également installer les nouvelles images de conteneur d’Esri, en indiquant les exécutions des notebooks 10.8.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.8.1, ils doivent mettre à jour l’exécution de leurs notebooks. Les exécutions des notebooks correspondant à la version 10.8.1 appartiennent à la version 4.0 (ArcGIS Notebook Server Standard 4.0 et ArcGIS Notebook Server Advanced 4.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.8.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.8.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.8.1.
• Pour que ArcGIS Notebook Server fonctionne correctement, sa version doit correspondre à celle du portail avec lequel il est fédéré.
• 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.
• Ne désinstallez pas l’instance existante de ArcGIS Notebook Server. 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 par la ligne de commande ou l’utilitaire de configuration. Choisissez l’une des 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.

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 :

Nous vous conseillons d’utiliser le fichier de configuration pour mettre à niveau ArcGIS Notebook Server vers 10.8.1. Si des restrictions de l’organisation vous empêchent d’utiliser le fichier de configuration, vous pouvez appeler l’opération de mise à niveau du site dans le répertoire de l’administrateur de ArcGIS Notebook Server à l’aide d’un script.

Si vous utilisez un site comportant plusieurs ordinateurs, suivez les étapes 1 à 5 pour un ordinateur, puis répétez ces étapes pour chaque ordinateur du site.

1. Pendant l’installation, vous serez invité à lire le contrat principal et à l’accepter ou à quitter l’assistant si vous n’êtes pas d’accord avec les termes.

   Le programme d’installation affiche les fonctionnalités qui seront installées, ainsi que l’espace disque nécessaire sur votre disque dur.

2. Dans la boîte de dialogue suivante, spécifiez les identifiants de connexion du compte ou fournissez un fichier de configuration.

   Le compte ArcGIS Notebook Server utilisé par votre installation existante est prérenseigné dans la zone ArcGIS Server Account (Compte ArcGIS Server). Indiquez le mot de passe du compte ArcGIS Notebook Server. Il s'agit généralement du mot de passe que vous avez défini lors de l'installation du logiciel.

   Si le mot de passe n’est pas validé, un message d’erreur s’affiche pour indiquer que le mot de passe est incorrect. Si vous n’êtes pas sûr du mot de passe du compte ArcGIS Notebook Server, contactez l’administrateur système ou réinitialisez le mot de passe à partir du répertoire administrateur ArcGIS Notebook Server.

   Si vous fournissez un fichier de configuration, les identifiants de connexion contenus dans le fichier de configuration de serveur doivent être identiques à ceux utilisés par votre site ArcGIS Notebook Server existant.

3. Si vous avez sélectionné Specify the account name and password (Spécifiez le nom du compte et le mot de passe) et que vous avez saisi manuellement les informations du compte ArcGIS Notebook Server, vous pouvez exporter un fichier de configuration de serveur dans la boîte de dialogue qui s’affiche. Si vous ne souhaitez pas exporter de fichier de configuration, cliquez sur Suivant et acceptez l'option par défaut Ne pas exporter le fichier de configuration. Si vous souhaitez exporter un fichier de configuration de serveur pour des installations ultérieures, cliquez sur Export configuration file (Exporter le fichier de configuration), accédez à un dossier sécurisé, puis donnez un nom au fichier de configuration.

   Remarque :

   Vous pouvez exporter un fichier de configuration de serveur si vous avez besoin d’effectuer l’une des opérations suivantes :

   • Créez le même compte ArcGIS Notebook Server lors d’une installation sur plusieurs ordinateurs.
   • Stocker le compte à utiliser lors d'une mise à niveau vers une version plus récente.
   • Effectuer une installation en mode silencieux pour laquelle le nom d’utilisateur et le mot de passe sont chiffrés.

   Attention :

   Lors de l’exportation d’un fichier de configuration de serveur vers un partage réseau, le compte Système local sur l’ordinateur sur lequel ArcGIS Notebook Server est installé doit disposer d’autorisations d’accès en écriture sur le partage réseau. Si les autorisations ne sont pas définies, il se peut que le fichier de configuration du serveur ne soit pas exporté avec succès. Si vous n’êtes pas sûr de la façon dont sont définies les autorisations pour le partage réseau, contactez l’administrateur système ou exportez le fichier de configuration de serveur localement et copiez-le sur le partage réseau.

4. Pour terminer l'installation, suivez les instructions à l'écran.
5. À la fin de l’installation, l’assistant de configuration s’affiche dans un navigateur. Pour finaliser la mise à niveau, suivez les instructions fournies dans l’assistant de configuration.
6. Si votre site comporte plusieurs ordinateurs, continuez de suivre les étapes 1 à 5 pour les autres ordinateurs de votre site. Si votre site ne comporte qu’un seul ordinateur et que vous envisagez une mise à niveau vers un site comportant plusieurs ordinateurs, vous pouvez dès maintenant joindre les ordinateurs supplémentaires au site. Vous devez également modifier les chemins des répertoires de serveur et du stockage de configuration pour utiliser des emplacements partagés accessibles sur chaque ordinateur.

Mettre à niveau à partir de la ligne de commande

Vous pouvez également mettre à niveau ArcGIS Notebook Server à partir de la ligne de commande à l’aide de l’utilitaire upgradesite à compter de la version 10.8.

Cet utilitaire ne comporte que 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.

Par défaut, l’utilitaire upgradesite se trouve sur ${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. Si vous utilisez plusieurs ordinateurs sur votre site, répétez cette commande sur chaque ordinateur, puis passez aux étapes de la section suivante.

Autoriser en mode silencieux

Une fois l’utilitaire de mise à niveau exécuté, vous devez réautoriser votre logiciel ArcGIS Notebook Server pour la version 10.8.1 si la mise à niveau concernait la version 10.7.1 ou une version antérieure. Si vous effectuez la mise à niveau de la version 10.8 vers la version 10.8.1, vous n’avez pas besoin de réautoriser votre logiciel.

Exécutez l’autorisation logicielle 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 de 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 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 :

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -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.

2. 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 des conteneurs Standard et Advanced téléchargées sur My Esri. > ./PostInstallUtility.sh -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.

3. 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’administrateur 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)
4. Installez une nouvelle instance de ArcGIS Web Adaptor 10.8.1 et enregistrez-le avec ArcGIS Notebook Server.
5. Une fois la mise à niveau du déploiement terminée, vous pouvez tirer parti des fonctionnalités de 10.8.1. Pour permettre la programmation des notebooks dans 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 des notebooks utilisant l’exécution 10.8.1 (version 4.0) peuvent être programmés.

Votre site ArcGIS Notebook Server 10.8.1 est maintenant prêt à héberger ArcGIS Notebooks.