Mettre à niveau un site ArcGIS Notebook Server sur AWS

Vous pouvez mettre à niveau un site ArcGIS Notebook Server sur Amazon Web Services (AWS) en exécutant les procédures de mise à niveau manuelles ou, si vous avez créé le déploiement avec les modèles Esri Amazon Web Services CloudFormation 10.8 ou 10.8.1, vous pouvez mettre à niveau avec les scripts Chef.

Avant de procéder à la mise à niveau

Quelle que soit la méthode de mise à niveau que vous choisissez, passez en revue les informations suivantes avant de mettre votre déploiement à niveau :

• Vous avez besoin d’un nouveau fichier de licence pour la mise à niveau vers 10.9.
• Effectuez une sauvegarde du site ArcGIS Notebook Server avant de procéder à la mise à niveau.
• Vous devez mettre à niveau le portail ArcGIS Enterprise avec lequel ArcGIS Notebook Server est fédéré avant la mise à niveau du site ArcGIS Notebook Server.
• Vous devez supprimer les instances Amazon Elastic Compute Cloud (EC2) sur le site ArcGIS Notebook Server depuis le groupe de mise à l’échelle automatique AWS avant de pouvoir procéder à la mise à niveau du site. Une fois la mise à niveau effectuée, vous ne pouvez pas remettre les instances dans le groupe de mise à l’échelle automatique. Par conséquent, vous devez ajouter manuellement des instances vers ou supprimer des instances depuis le site ArcGIS Notebook Server, le cas échéant, et vous ne pouvez pas utiliser les fonctions Lambda créées avec les modèles Amazon Web Services CloudFormation fournis par Esri pour arrêter et démarrer ces instances.

  Si vous ne supprimez pas les instances ou si vous placez les instances à nouveau dans le groupe de mise à niveau de l’échelle automatique après avoir fait la mise à niveau, les instances ajoutées au site ArcGIS Notebook Server par le groupe de mise à l’échelle automatique exécuteront l’ancienne version du logiciel. Vous ne pouvez pas avoir de mélange de versions ArcGIS Server sur un site, sous peine de corrompre votre déploiement.

Mettre à niveau avec des procédures de mise à niveau manuelle

La procédure de mise à niveau manuelle pour une site ArcGIS Notebook Server sur AWS est similaire à la mise à niveau d’un site sur site. La différence sur AWS est que si le site ArcGIS Notebook Server et les instances Amazon Elastic Compute Cloud sont déployées dans un groupe de mise à l’échelle automatique AWS, vous devez les supprimer du groupe de mise à l’échelle automatique avant de procéder à la mise à niveau.

Procédez comme suit pour supprimer toutes les instances EC2 depuis le groupe de mise à l’échelle automatique.

1. Connectez-vous à AWS Management Console et trouvez le groupe de mise à l’échelle automatique associé à votre site ArcGIS Notebook Server.

   Le groupe de mise à l’échelle automatique inclut le nom de la pile CloudFormation. Vous pouvez également ouvrir la gestion des instances pour le groupe et confirmer que les instances EC2 du groupe participent à votre site.

2. Modifiez les propriétés de capacité minimale et maximale du groupe de mise à l’échelle automatique sur 0.
3. Supprimez toutes les instances EC2 de votre groupe de mise à l’échelle automatique.
4. Modifiez la propriété de capacité souhaitée du groupe de mise à l’échelle automatique sur 0.

Une fois que vous supprimez toutes les instances EC2, supprimez le groupe de mise à l’échelle automatique pour empêcher quiconque d’ajouter à nouveau les instances une fois le site ArcGIS Notebook Server mis à niveau.

Maintenant vous pouvez suivre les instructions dans le guide d’installation ArcGIS Notebook Server pour mettre à niveau le site ArcGIS Notebook Server. Lisez les instructions spécifiques au système d’exploitation sur vos instances EC2 :

• Guide d’installation ArcGIS Notebook Server (Linux)
• Guide d’installation ArcGIS Notebook Server (Windows)

Mettre à niveau avec les scripts Chef

Supprimez les instances ArcGIS Notebook Server EC2 depuis le groupe de mise à l’échelle automatique AWS. Ensuite, procédez à la mise à niveau du site ArcGIS Notebook Server, puis mettez à niveau le ArcGIS Web Adaptor du site.

Ajuster les paramètres du groupe de mise à l’échelle automatique

Procédez comme suit pour supprimer toutes les instances EC2 depuis le groupe de mise à l’échelle automatique.

1. Connectez-vous à AWS Management Console et trouvez le groupe de mise à l’échelle automatique associé à votre site ArcGIS Notebook Server.

   Le groupe de mise à l’échelle automatique inclut le nom de la pile CloudFormation. Vous pouvez également ouvrir la gestion des instances pour le groupe et confirmer que les instances EC2 du groupe participent à votre site.

2. Modifiez les propriétés de capacité minimale et maximale du groupe de mise à l’échelle automatique sur 0.
3. Supprimez toutes les instances EC2 de votre groupe de mise à l’échelle automatique.
4. Modifiez la propriété de capacité souhaitée du groupe de mise à l’échelle automatique sur 0.

Une fois que vous supprimez toutes les instances EC2, supprimez le groupe de mise à l’échelle automatique pour empêcher quiconque d’ajouter à nouveau les instances une fois le site ArcGIS Notebook Server mis à niveau.

Mettre à niveau ArcGIS Notebook Server

1. En tant qu’utilisateur ubuntu, effectuez une connexion SSH à la première instance EC2 du site ArcGIS Notebook Server.
2. Utilisez une des commandes suivantes pour télécharger et installer Chef ou client Cinc 15. Si vous avez installé une version antérieure de Chef, mettez-la à jour avec la version 15.
   • Chef : sudo curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v 15.14.0
   • Client Cinc : sudo curl -L https://omnitruck.cinc.sh/install.sh | sudo bash -s -- -v 15.14.0
3. Téléchargez les versions 10.9 des fichiers d’installation suivants depuis votre compte dans My Esri et importez-les dans le répertoire /opt/software/archives sur l’instance EC2.

   • ArcGIS_Notebook_Server_Linux_109_177908.tar.gz
   • ArcGIS_Notebook_Server_Samples_Data_Linux_109_177914.tar.gz
   • ArcGIS_Notebook_Docker_Advanced_109_177823.tar.gz
   • ArcGIS_Notebook_Docker_Standard_109_177822.tar.gz
   • ArcGIS_Web_Adaptor_Java_Linux_109_177888.tar.gz

4. Obtenez un fichier d’autorisation ArcGIS Notebook Server 10.9 et placez-le dans un dossier local sur l’instance EC2 ou un partage de fichiers auquel vous pouvez accéder depuis l’instance EC2.
5. Téléchargez ArcGIS Cookbook version 3.7.0 (arcgis-3.7.0-cookbooks.tar.gz) vers l’instance EC2, décompressez le fichier et placez son contenu dans le répertoire /opt/chef.
Le fichier notebook-server.json que vous utiliserez pour la mise à niveau est inclus dans le cookbook que vous avez téléchargé et extrait à l’étape précédente.
6. Modifiez les répertoires vers /opt/chef/templates/arcgis-notebooks/10.9/linux, ouvrez le fichier notebook-server.json dans un éditeur de texte et modifiez les paramètres suivants :

   • Définissez le répertoire d’installation sur /home.

     "arcgis" : {
         "notebook_server": {
             "install_dir": "/home"

   • Spécifiez l’emplacement où vous avez placé le fichier d’autorisation ArcGIS Notebook Server.

     "arcgis" : {
         "notebook_server": {
             "authorization_file": "/<folder>/<subfolder>",

   • Définissez le nom d’utilisateur et le mot de passe pour l’administrateur du site ArcGIS Notebook Server.

     "arcgis" : {
         "notebook_server": {
     	       "admin_username": "<username>",
             "admin_password": "<password>",

   • Définissez l’emplacement du répertoire du serveur racine sur /net/primary/gisdata/notebookserver/directories. Vous devez remplacer FILESERVER avec primary dans le texte par défaut.

     "arcgis" : {
         "notebook_server": {
         "directories_root": "/net/primary/gisdata/notebookserver/directories",

   • Définissez l’emplacement du répertoire de l’espace de travail ArcGIS Notebook Server sur /net/primary/gisdata/notebookserver/directories/arcgisworkspace. Vous devez remplacer FILESERVER avec primary dans le texte par défaut.

     "arcgis" : {
         "notebook_server": {
         "workspace": "/net/primary/gisdata/notebookserver/directories/arcgisworkspace",

   • Définissez la chaîne de connexion pour l’emplacement du répertoire de configuration ArcGIS Notebook Server sur /net/primary/gisdata/notebookserver/config-store. Notez que vous devez remplacer FILESERVER avec primary dans le texte par défaut.

     "arcgis" : {
         "notebook_server": {
         "config_store_connection_string": "/net/primary/gisdata/notebookserver/config-store",

   • Définissez le répertoire de journal sur /home/arcgis/notebookserver/usr/logs.

     "arcgis" : {
         "notebook_server": {
         "log_dir": "/home/arcgis/notebookserver/usr/logs",

7. Enregistrez et fermez le fichier notebook-server.json.
8. En tant qu’utilisateur ubuntu, modifiez le répertoire pour /opt/chef et exécutez la commande suivante : sudo chef-client -z -j /opt/chef/templates/arcgis-notebooks/10.9/linux/notebook-server.json
9. S’il y a plusieurs instances EC2 dans le site ArcGIS Notebook Server, effectuez une connexion SSH vers l’instance EC2 suivante et répétez les étapes 2 à 8 jusqu’à la mise à niveau de l’intégralité des instances.

Lorsque vous terminez la mise à niveau de ArcGIS Notebook Server sur toutes les instances EC2 du site, procédez à la mise à jour de ArcGIS Web Adaptor.

Mettre à niveau ArcGIS Web Adaptor

Utilisez le fichier notebook-server-webadaptor.json, également inclus dans le cookbook téléchargé à l’étape 5 de la précédente section, pour procéder à la mise à niveau du ArcGIS Web Adaptor du site ArcGIS Notebook Server.

1. Ouvrez le fichier notebook-server-webadaptor.json dans un éditeur de texte et modifiez les paramètres suivants :

   • Définissez l’emplacement du fichier keystore PKSC12 (.pfx) avec certificat SSL pour Apache Tomcat.

     "arcgis" : {
         "tomcat": {
         "keystore_file": "/<folder>/<subfolder>/<file name>.pfx",

   • Définissez le mot de passe du fichier keystore avec certificat SSL pour Tomcat.

     "arcgis" : {
         "tomcat": {
         "keystore_password": "<password>"

   • Définissez le nom d’utilisateur et le mot de passe pour l’administrateur du site ArcGIS Notebook Server.

     "arcgis" : {
         "mission_server": {
     	       "admin_username": "<username>",
             "admin_password": "<password>",

2. Enregistrez et fermez le fichier notebook-server-webadaptor.json.
3. En tant qu’utilisateur ubuntu, modifiez le répertoire pour /opt/chef et exécutez la commande suivante : chef-client -z -j /opt/chef/templates/arcgis-notebooks/10.9/linux/notebook-server-webadaptor.json