Mettre à niveau un déploiement ArcGIS Enterprise sur une seule machine sur AWS

Vous pouvez procéder à la mise à niveau d’un déploiement ArcGIS Enterprise sur une seule machine 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 procéder à la mise à 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 :

• Procurez-vous les licences ArcGIS nécessaires à la version logicielle actuelle. Vous pouvez les télécharger depuis My Esri.
• Acceptez les conditions d’AWS Marketplace pour la nouvelle version des images virtuelles ArcGIS Enterprise Amazon Machine Images (AMI) avant de procéder à la mise à niveau.
• Créez une sauvegarde du déploiement de façon à pouvoir le restaurer en cas de problème lors de la procédure de mise à niveau.

  Vous pouvez utiliser l’utilitaire webgisdr fourni avec Portal for ArcGIS pour créer une sauvegarde de la plupart des composants d’un déploiement ArcGIS Enterprise. Les répertoires de Big Data spatio-temporelles ne sont pas inclus dans cette sauvegarde. Donc, si votre déploiement comprend un répertoire de Big Data spatio-temporelles, faites-en une sauvegarde distincte à l’aide de l’utilitaire backupdatastore de ArcGIS Data Store.

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

La procédure de mise à niveau manuelle pour mettre à jour le logiciel sur votre déploiement ArcGIS Enterprise sur une seule machine sur Amazon Web Services est similaire à la mise à jour du logiciel sur site ; téléchargez les mises à jour logicielles My Esri sur votre instance Amazon Elastic Compute Cloud (EC2) et appliquez les mises à jour directement vers votre déploiement existant. Tous les composants ArcGIS Enterprise doivent exécuter la même version logicielle. La principale différence que présente la mise à jour sur AWS concerne la méthode utilisée pour créer une sauvegarde de votre déploiement.

1. Connectez-vous à AWS Management Console et créez une Amazon Machine Image (AMI) depuis votre instance existante.

   C'est la sauvegarde que vous pouvez utiliser pour procéder à un redéploiement en cas de problème durant la mise à niveau. Si vous devez effectuer un redéploiement, vous devez le faire avec la même URL de portail.

2. Obtenez de nouvelles licences Portal for ArcGIS et ArcGIS GIS Server depuis Esri.
3. Téléchargez de nouvelles versions de Portal for ArcGIS, ArcGIS Web Adaptor, ArcGIS Server et ArcGIS Data Store depuis My Esri.
4. Effectuez une connexion Bureau à distance (Microsoft Windows) ou SSH (Linux) à la machine sur AWS. Connectez-vous en tant qu'utilisateur arcgis. Placez tous les téléchargements logiciels sur cette machine.

   S’il s’agit de votre première mise à niveau d’un déploiement sur une instance Windows AWS, modifiez le mot de passe de l’utilisateur arcgis.

   Si vous avez déployé ArcGIS Enterprise sur cette machine avec la AWS Management Console, veillez à ce que la machine soit autorisée à créer des paquets Amazon Simple Storage Service (S3) dans votre compte AWS, car la procédure de mise à niveau de Portal for ArcGIS crée un paquet S3 pour le stockage temporaire du répertoire de contenu. Si vous avez effectué le déploiement à l’aide d’un modèle CloudFormation fourni par Esri, le modèle a déjà configuré ceci.

5. Suivez les étapes dans la rubrique Mettre à niveau Portal for ArcGIS pour mettre à jour votre portail et son adaptateur web, et mettez à jour votre licence Portal for ArcGIS.
6. Suivez la procédure du site avec une machine dans la rubrique Mettre à niveau ArcGIS Server pour mettre à jour ArcGIS Server et son adapteur web et mettez à jour votre site ArcGIS Server avec une licence ArcGIS GIS Server.

Remarque :

Vous devez mettre à niveau ArcGIS Server avant la mise à niveau de ArcGIS Data Store.

7. Si votre déploiement se produit sur une instance Windows sur AWS, procédez comme suit dans la rubrique Mettre à niveau ArcGIS Data Store pour mettre à jour le stockage de données.
8. Si vous effectuez la mise à niveau d’un déploiement 10.5 ou ultérieur sur Linux sur AWS, procédez comme suit dans la rubrique Mettre à niveau ArcGIS Data Store pour mettre à jour le stockage de données.
9. Si vous exécutez la mise à niveau d’un déploiement 10.3.1, 10.4, ou 10.4.1 sur Linux sur AWS, vous devez faire une copie du fichier hostidentifier.properties avant de commencer la mise à niveau. Procédez comme suit pour copier le fichier et mettre à niveau ArcGIS Data Store :
   1. Modifiez les répertoires avec <ArcGIS Data Store installation directory>/arcgis/datastore/framework/etc.
   2. Effectuez une copie du fichier hostidentfier.properties et placez-la dans un autre répertoire.
   3. Installez la nouvelle version de ArcGIS Data Store, mais n’exécutez pas Data Store Configuration wizard (Assistant de configuration du stockage des données).
   4. Exécutez la commande stopdatastore.sh pour interrompre ArcGIS Data Store.

      La commande se situe dans <ArcGIS Data Store installation directory>/arcgis/datastore.

   5. Remplacez le fichier hostidentfier.properties dans <ArcGIS Data Store installation directory>/arcgis/datastore/framework/etc avec la copie du fichier effectuée à l’étape b.
   6. Exécutez la commande startdatastore.sh pour démarrer ArcGIS Data Store.

      La commande se situe dans <ArcGIS Data Store installation directory>/arcgis/datastore.

   7. Ouvrez l’assistant Data Store Configuration (Configuration ArcGIS Data Store) ou exécutez l’utilitaire de commande configuredatastore pour mettre à niveau le Data Store.
10. Après avoir mis à niveau et testé votre déploiement à jour, vous pouvez supprimer la sauvegarde de votre image AMI.

Mettre à niveau avec les scripts Chef

Les étapes de mise à niveau sont différentes pour les déploiements sur Microsoft Windows et Ubuntu. Suivez les instructions propres au système d’exploitation de votre déploiement.

Mettre à niveau un déploiement ArcGIS Enterprise sur une seule machine sur Windows

Procédez comme suit pour utiliser Chef pour mettre à niveau ArcGIS Enterprise sur une seule instance Amazon Elastic Compute Cloud (EC2).

1. Établissez une connexion Bureau à distance avec l’instance EC2.
2. Téléchargez et installez Chef ou client Cinc 15. Si vous avez installé une version antérieure de Chef, mettez-la à jour avec la version 15.
3. Téléchargez les fichiers d’installation 10.9 depuis votre compte dans My Esri et importez les fichiers vers un dossier sur l’instance EC2 :

   • ArcGIS_Web_Adaptor_for_Microsoft_IIS_109_177789.exe
   • Portal_for_ArcGIS_Windows_109_177787.exe
   • ArcGIS_Server_Windows_109_177775.exe
   • ArcGIS_DataStore_Windows_109_177788.exe
   • Portal_for_ArcGIS_Web_Styles_Windows_109_177786.exe

4. Obtenir le fichier d’autorisation Portal for ArcGIS 10.9 (.json) et ArcGIS Server avec licence pour ArcGIS GIS Server (.epc ou .prvc) et placez-les sur l’instance EC2.
5. Téléchargez ArcGIS Cookbook version 3.7.0 (arcgis-3.7.0-cookbooks.zip) vers l’instance EC2, décompressez le fichier et placez son contenu dans le dossier C:\chef.
6. Supprimez les dossiers suivants :

   • C:\chef\nodes
   • C:\Users\Administrator\.chef\local-mode-cache

7. Créez une copie du fichier C:\chef\node.json et nommez-la upgrade_base_enterprise_allinone_windows.json.
8. Ouvrez le fichier upgrade_base_enterprise_allinone_windows.json dans un éditeur de texte et modifiez les paramètres suivants :

   • Définissez la version ArcGIS vers 10.9.

     "arcgis" : {
         "version": "10.9",

   • Définissez le référentiel d’archive ArcGIS au dossier où vous avez placé les fichiers logiciels sur l’instance EC2.

     "arcgis" : {
         "repository": {
     	  "archives": "<drive>\\<folder>"

   • Définissez l’autorisation du serveur à l’emplacement de votre fichier d’autorisation ArcGIS Server 10.9.

     "server" : {
         "authorization_file" : "<drive>:\\<folder path>\\My_New_Server.prvc"

   • Définissez l’autorisation du portail à l’emplacement de votre fichier d’autorisation Portal for ArcGIS 10.9.

     "portal" : {
         "authorization_file" : "<drive>:\\<folder path>\\my_new_portal.json",

   • Modifiez la liste d’exécution pour utiliser les actions suivantes :

     "recipe[arcgis-enterprise::install_portal]",
     	   "recipe[arcgis-enterprise::webstyles]",
     	   "recipe[arcgis-enterprise::portal]",
         "recipe[arcgis-enterprise::portal_wa]",
         "recipe[arcgis-enterprise::server]",
         "recipe[arcgis-enterprise::server_wa]",
         "recipe[arcgis-enterprise::datastore]"

9. Enregistrez et fermez le fichier upgrade_base_enterprise_allinone_windows.json.
10. Ouvrez une fenêtre de ligne de commande en tant qu’administrateur, modifiez le répertoire avec C:\chef, et exécutez la commande suivante : chef-client -z -j c:\chef\upgrade_base_enterprise_allinone_windows.json

Le script s’exécute pour mettre à niveau votre déploiement. L’opération peut prendre plusieurs heures, selon la taille de votre déploiement.

En cas d’échec de la mise à niveau du déploiement, contactez le support Esri (aux États-Unis) ou votre distributeur (en dehors des États-Unis) pour vous aider à résoudre le problème.

Mettre à niveau un déploiement ArcGIS Enterprise sur une seule machine sur Ubuntu

Procédez comme suit pour utiliser Chef pour mettre à niveau ArcGIS Enterprise sur une seule instance EC2.

1. Effectuez une connexion SSH à l’instance EC2 en tant qu’utilisateur ubuntu.
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 fichiers d’installation 10.9 depuis votre compte dans My Esri et importez les fichiers vers un dossier sur l’instance EC2 :

   • ArcGIS_Web_Adaptor_Java_Linux_109_177888.tar.gz
   • Portal_for_ArcGIS_Linux_109_177885.tar.gz
   • ArcGIS_Server_Linux_109_177864.tar.gz
   • ArcGIS_DataStore_Linux_109_177887.tar.gz
   • Portal_for_ArcGIS_Web_Styles_Linux_109_177886.tar.gz

4. Obtenir le fichier d’autorisation Portal for ArcGIS 10.9 (.json) et ArcGIS Server avec licence pour ArcGIS GIS Server (.epc ou .prvc) et placez-les sur 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 /var/chef.
6. Supprimez le répertoire /var/chef/nodes.
7. Créez une copie du fichier /etc/chef/node.json et nommez-la upgrade_base_enterprise_allinone_ubuntu.json.
8. Ouvrez le fichier upgrade_base_enterprise_allinone_ubuntu.json dans un éditeur de texte et modifiez les paramètres suivants :

   • Définissez la version ArcGIS vers 10.9.

     "arcgis" : {
         "version": "10.9",

   • Définissez le référentiel d’archive ArcGIS au dossier où vous avez placé les fichiers logiciels sur l’instance EC2.

     "arcgis" : {
         "repository": {
     	  "archives": "/<path and folder>"

   • Définissez l’autorisation du serveur à l’emplacement de votre fichier d’autorisation ArcGIS Server 10.9.

     "server" : {
         "authorization_file" : "/<path>/my_new_server.prvc"

   • Définissez l’autorisation du portail à l’emplacement de votre fichier d’autorisation Portal for ArcGIS 10.9.

     "portal" : {
         "authorization_file" : "/<path>/my_new_portal.json",

   • Modifiez la liste d’exécution pour utiliser les actions suivantes :

     "recipe[arcgis-enterprise::install_portal]",
     	   "recipe[arcgis-enterprise::webstyles]",
     	   "recipe[arcgis-enterprise::portal]",
         "recipe[arcgis-enterprise::portal_wa]",
         "recipe[arcgis-enterprise::server]",
         "recipe[arcgis-enterprise::server_wa]",
         "recipe[arcgis-enterprise::datastore]"

9. Enregistrez et fermez le fichier upgrade_base_enterprise_allinone_ubuntu.json.
10. En tant qu’utilisateur ubuntu, modifiez le répertoire pour /var/chef, et exécutez la commande suivante : sudo chef-client -z -j /etc/chef/upgrade_base_enterprise_allinone_ubuntu.json

Le script s’exécute pour mettre à niveau votre déploiement. L’opération peut prendre plusieurs heures, selon la taille de votre déploiement.

En cas d'échec de la mise à niveau du déploiement, contactez le support Esri (aux États-Unis) ou votre distributeur (en dehors des États-Unis) pour vous aider à résoudre le problème.