Mettre à niveau un site ArcGIS Notebook Server sur AWS

La façon dont vous procédez à la mise à niveau dépend de la façon dont vous avez créé le site ArcGIS Notebook Server sur Amazon Web Services (AWS) et du moment auquel vous l’avez créé.

• Vous pouvez mettre à niveau n’importe quel site ArcGIS Notebook Server sur AWS en suivant une procédure de mise à niveau manuelle. Si vous avez créé le site avant la version 10.8, vous devez utiliser la procédure manuelle pour effectuer la mise à niveau.
• Si vous avez créé le site ArcGIS Notebook Server à l’aide d’un modèle Esri Amazon Web Services CloudFormation de version 10.8 ou 10.8.1, vous pouvez effectuer la mise à niveau avec des scripts Chef.
• Si vous avez créé le site ArcGIS Notebook Server à l’aide d’un modèle Esri CloudFormation 10.9, vous pouvez utiliser un modèle CloudFormation 10.9.1 pour le mettre à niveau.
• Si vous avez créé le site ArcGIS Notebook Server avec ArcGIS Enterprise Cloud Builder for Amazon Web Services 10.9, vous pouvez utiliser ArcGIS Enterprise Cloud Builder for AWS 10.9.1 pour le mettre à niveau.

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 :

• Si vous effectuez la mise à niveau depuis la version 10.8.1 ou une version antérieure, vous aurez besoin d’un nouveau fichier de licence pour procéder à la mise à niveau vers 10.9.1.
• 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.
• Si vous utilisez des procédures manuelles ou un script Chef pour effectuer la mise à niveau, 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 (le cas échéant) avant de pouvoir mettre à niveau le 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.

 

1.  

      

2.  
3.  
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

Si vous avez créé le site ArcGIS Notebook Server à l’aide d’un modèle Esri Amazon Web Services CloudFormation de version 10.8 ou 10.8.1, vous pouvez effectuer la mise à niveau avec des 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

 

1.  

      

2.  
3.  
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.    
   • Chef : sudo curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v 16.16.13
   • Client Cinc : sudo curl -L https://omnitruck.cinc.sh/install.sh | sudo bash -s -- -v 16.16.13
3. Téléchargez les versions 10.9.1 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_1091_180226.tar.gz
   • ArcGIS_Notebook_Server_Samples_Data_Linux_1091_180232.tar.gz
   • ArcGIS_Notebook_Docker_Advanced_1091_180091.tar.gz
   • ArcGIS_Notebook_Docker_Standard_1091_180090.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.  
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.1/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.1/linux/notebook-server-webadaptor.json

Effectuer la mise à niveau à l’aide d’un modèle CloudFormation

Si vous avez utilisé un modèle de déploiement CloudFormation 10.9 fourni par Esri pour créer un site ArcGIS Notebook Server, vous pouvez utiliser le modèle de mise à niveau 10.9.1 correspondant pour le mettre à niveau.

Le tableau suivant répertorie les modèles de déploiement et de mise à niveau correspondants, et fournit des liens permettant d’accéder aux instructions d’utilisation des modèles de mise à niveau.

Modèle de déploiement 10.9	Modèle de mise à niveau 10.9.1	Instructions d’utilisation du modèle de mise à niveau
arcgis-notebook-server-singlemachine.template.json	arcgis-notebook-server-singlemachine-upgrade.template.json	Mettre à niveau un site ArcGIS Notebook Server à une seule machine avec CloudFormation
arcgis-notebook-server-ha.template.json	arcgis-notebook-server-ha-upgrade.template.json	Mettre à niveau un site ArcGIS Notebook Server à plusieurs machines avec CloudFormation