La mise à niveau de 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 vers 11.3, vous devez également mettre à niveau ArcGIS Notebook Server.
Le paquetage d’installation de ArcGIS Notebook Server 11.3 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 11.3.
Au cours de la procédure de mise à niveau, vous devez réautoriser le logiciel ArcGIS Notebook Server pour la version 11.3 si vous avez procédé à la mise à niveau 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 runtimes des notebooks 11.3 à 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 une nouvelle fonctionnalité dans 11.3, ils doivent mettre à jour l’exécution de leurs notebooks. Les runtimes de notebooks qui correspondent à 11.3 sont à la version 10.0 (options ArcGIS Notebook Server Standard 10.0 et ArcGIS Notebook Server Advanced 10.0).
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 de ArcGIS Enterprise. Un runtime de notebook sera retiré en même temps que la version associée de 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 comportant plusieurs ordinateurs sont pris en charge par les versions 10.7.1 et ultérieures. 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 permettant de joindre des machines supplémentaires à un site à l’issue de la mise à niveau vers 11.3.
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 11.3, suivez la procédure ci-dessous.
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 11.3
- Pour que ArcGIS Notebook Server fonctionne correctement, sa version doit correspondre à celle du portail avec lequel il est fédéré.
- Si Notebook Server est actuellement en mode de lecture seule, désactivez ce mode avant d’exécuter la mise à niveau.
- Mettez à niveau Docker vers la version 23.0 ou ultérieure.
- Pour mettre à niveau votre déploiement ArcGIS Enterprise, procédez comme suit :
- Mettez à niveau Portal for ArcGIS.
- Mettez à niveau ArcGIS Web Adaptor (pour le portail).
- Mettez à niveau le site ArcGIS Server qui fait office de serveur d’hébergement du portail.
- Mettez à niveau ArcGIS Web Adaptor (pour Server).
- Mettez à niveau ArcGIS Data Store (d’abord l’ordinateur principal, puis l’ordinateur de secours).
- Mettez à niveau les autres serveurs éventuels, dont ArcGIS Notebook Server.
- Installer des 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 Notebook Server 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 de 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.
- Connectez-vous au portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.
- Cliquez sur l’onglet Settings (Paramètres).
- Cliquez sur Directories (Répertoires).
- Déterminez si le chemin d’accès actuel au répertoire arcgisworkspace se trouve dans le répertoire d’installation de ArcGIS Notebook Server.
<installdir>/arcgis/notebook/directories/arcgisworkspace
Si le répertoire arcgisworkspace se trouve dans le répertoire d’installation de ArcGIS Notebook Server, vous devez placer le répertoire de l’espace de travail dans un emplacement en dehors du répertoire d’installation pour pouvoir effectuer la mise à niveau.
Si le répertoire arcgisworkspace ne se trouve pas dans le répertoire d’installation de ArcGIS Notebook Server, vous pouvez ignorer les étapes suivantes de cette section.
- Cliquez sur Edit (Mettre à jour) pour le répertoire arcgisworkspace.
- 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
- Cliquez sur Save (Enregistrer).
- Copiez manuellement l’ensemble du contenu de l’ancien répertoire arcgisworkspace dans le nouveau répertoire arcgisworkspace.
Effectuer une sauvegarde du déploiement
Avant la mise à niveau, il est recommandé d’effectuer des sauvegardes du déploiement.
Les notebooks sont inclus dans les sauvegardes du portail effectuées à l’aide de l’utilitaire webgisdr.
Vous pouvez utiliser l’opération exportSite dans le répertoire administrateur de ArcGIS Notebook Server pour effectuer une sauvegarde du 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 :
- 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.
- Accédez à site > Export Site (Exporter un site).
- Entrez le chemin d’accès complet à l’emplacement sur votre machine dans lequel exporter le fichier.
Le site doit pouvoir accéder à ce répertoire.
- Cliquez sur Exporter.
À l’issue de l’exportation, 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 11.3. 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 :
- Exécutez ./Setup à partir de l’emplacement dans lequel ArcGIS Notebook Server a été extrait, puis suivez les invites pour effectuer 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 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 de ArcGIS Notebook Server et installe la version mise à niveau de ArcGIS Notebook Server.
- À la fin de l’exécution de l’utilitaire de mise à niveau, vous devez autoriser de nouveau votre logiciel ArcGIS Notebook Server pour la version 11.3. Utilisez l’assistant d’autorisation logiciel pour finaliser le processus d’autorisation.
- 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.
- 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 :
- Pour lancer la mise à niveau, exécutez ./Setup à partir du dossier d’extraction de ArcGIS Notebook Server, avec l’argument indiqué dans l’exemple ci-dessous, et conformez-vous aux invites pour terminer la mise à niveau.
Cette option désinstalle la version précédente de ArcGIS Notebook Server et installe la version mise à niveau de ArcGIS Notebook Server.
<untar directory>/Setup -l yes -m silent - À la fin de l’exécution de l’utilitaire de mise à niveau, vous devez autoriser de nouveau votre logiciel ArcGIS Notebook Server pour la version 11.3. Exécutez l’autorisation du logiciel avec la syntaxe ci-dessous pour autoriser ArcGIS Notebook Server en mode silencieux :
<ArcGIS Notebook Server install directory>/tools/authorizeSoftwareExécutez la commande suivante pour afficher toutes les options d’autorisation :
<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --helpRemarque :
Reportez-vous à la section Autoriser dans un environnement déconnecté pour en savoir plus sur l’autorisation des installations de ArcGIS Notebook Server dans un environnement déconnecté. - Mettez le site à niveau à l’aide de l’utilitaire de ligne de commande upgradesite.
Cet 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.
Par défaut, l’utilitaire upgradesite est disponible depuis ${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 -sL’utilitaire affiche des rapports de progression et s’arrête une fois la mise à niveau terminée.
- 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
Une fois que l’utilitaire de mise à niveau est arrivé à son terme, vous devez à nouveau autoriser le logiciel ArcGIS Notebook Server pour la version 11.3.
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<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 est généré pour l’envoi à Esri pour terminer la procédure.
- À 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> - Une fois le fichier contenant les informations en sortie créé, procédez de l’une des manières suivantes :
- Accédez au site en libre-service Esri. 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 dans un message électronique.
- 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 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
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 de 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 :
- Ouvrez un terminal à l’aide du compte d’installation de ArcGIS Notebook Server.
- Accédez au dossier des outils ArcGIS Notebook Server. Par défaut, le chemin est ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
- Pour consulter l’aide de l’utilitaire, s’il y a lieu, exécutez la commande suivante : ./PostInstallUtility.sh -h
- ArcGIS Notebook Server requiert l’installation de Docker Engine sur votre machine. Pour déterminer si Docker est actif sur votre machine, exécutez la commande suivante : ./PostInstallUtility.sh -d
- Si Docker Desktop n’est pas installé, installez-le maintenant.
- Installez votre image Notebooks 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 et de Docker Desktop, exécutez la commande deux fois pour installer les images des conteneurs Standard et Advanced téléchargées sur My Esri.
Remarque :
Vérifiez que votre machine dispose d’au moins 75 Go d’espace disque disponible.
Exécutez la commande suivante : ./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.
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.
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 des exemples de données ArcGIS Notebook Server, procédez comme suit :
- Ouvrez une interface de commande (shell) en tant qu’utilisateur appelé à exécuter ArcGIS Notebook Server. Accédez au répertoire dans lequel vous avez téléchargé le fichier ArcGIS Notebook Server des exemples de données tar.gz à partir de My Esri.
- Décompressez le fichier tar.gz avec la commande suivante :
tar -xvzf ArcGIS_Notebook_Server_Samples_Data_Linux_.tar.gz - Accédez à <install directory>/notebookserver/License et lisez l’accord de licence.
- À partir du répertoire, exécutez le script.
./ArcGISNotebookServerSamplesData-Setup.sh - Modifiez les répertoires pour utiliser le dossier d’outils de ArcGIS Notebook Server.
Par défaut, le chemin est ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
- Pour consulter l’aide de l’utilitaire, s’il y a lieu, exécutez la commande suivante :
> ./PostInstallUtility.sh -h - Exécutez l’utilitaire de post-installation pour extraire les exemples de données dans le répertoire arcgisworkspace du site Notebook Server.
> ./PostInstallUtility.sh -x
Remplacer les instances ArcGIS Web Adaptor
Pour remplacer des instances ArcGIS Web Adaptor, procédez comme suit :
- Annulez l’enregistrement de l’instance précédente de ArcGIS Web Adaptor sur le site et désinstallez-la.
- Connectez-vous au répertoire d’administration de ArcGIS Notebook Server.
- Sélectionnez System (Système) > > Web Adaptors > > ordinateur enregistré.
- Cliquez sur Unregister Web Adaptor (Annuler l’enregistrement de Web Adaptor)
- Installez une nouvelle instance de ArcGIS Web Adaptor 11.3 et configurez-la avec ArcGIS Notebook Server.
- Si vous mettez à niveau une version 10.8 ou antérieure, procédez comme suit pour programmer les notebooks sur votre portail :
- Si vous le souhaitez, mettez à niveau les rôles personnalisés qui possèdent des privilèges concernant les notebooks pour ajouter le nouveau privilège Schedule Notebooks (Planifier des notebooks).
- Informez les auteurs de notebooks qu’ils doivent mettre à jour le runtime de chacun de leurs notebooks s’ils veulent utiliser la fonction de planification.
Seuls les notebooks utilisant le runtime 10.8.1 (version 4.0) ou une version ultérieure peuvent faire l’objet d’une programmation.
Le site ArcGIS Notebook Server 11.3 est maintenant prêt à héberger ArcGIS Notebooks.
Vous avez un commentaire à formuler concernant cette rubrique ?