Mettre à niveau un site ArcGIS GeoEvent 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 GeoEvent Server sur Amazon Web Services (AWS) et du moment auquel vous l’avez créé.

• Vous pouvez mettre à niveau n’importe quel site ArcGIS GeoEvent 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 GeoEvent 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 GeoEvent Server à l’aide d’un modèle Esri CloudFormation 10.9, 10.9.1 ou 11.0, vous pouvez utiliser le modèle CloudFormation 11.1 pour le mettre à niveau.
• Si vous avez créé le site ArcGIS GeoEvent Server avec ArcGIS Enterprise Cloud Builder for Amazon Web Services 10.9, 10.9.1 ou 11.0, vous pouvez utiliser ArcGIS Enterprise Cloud Builder for AWS 11.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 :

• Vous avez besoin d’un nouveau fichier de licence ArcGIS GeoEvent Server pour la mise à niveau vers 11.1.
• Exportez la configuration du site ArcGIS GeoEvent Server avant de procéder à la mise à niveau.
• Si le site ArcGIS GeoEvent Server est fédéré avec un portail ArcGIS Enterprise, vous devez mettre à niveau le portail avant de mettre à niveau ce serveur fédéré.
• Les sites ArcGIS GeoEvent Server 10.9 et versions ultérieures sur AWS ne peuvent contenir qu’une seule instance Amazon Elastic Compute Cloud (EC2).

  Lorsque vous utilisez des procédures manuelles ou un script Chef pour effectuer la mise à niveau, vous devez supprimer les instances EC2 sur le site ArcGIS GeoEvent Server depuis le groupe de mise à l’échelle automatique AWS (le cas échéant) et supprimer toutes les instances EC2 sauf une du site. Les sites multi-machines ArcGIS GeoEvent Server ne sont plus pris en charge sur AWS.

  À l’issue de la mise à niveau, ne placez pas l’instance restante à nouveau dans le groupe de mise à l’échelle automatique, car le site ne peut contenir qu’une seule instance.

  Vous ne pouvez pas utiliser les fonctions Lambda créées à l’aide des modèles Amazon Web Services CloudFormation par Esri pour arrêter et lancer l’instance restante après la mise à niveau.

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

La procédure de mise à niveau manuelle pour un site ArcGIS GeoEvent Server sur AWS exige que vous supprimiez toutes les instances, hormis une, du site. Si les instances 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. Une fois ces étapes terminées, vous pouvez suivre la même procédure de mise à niveau que pour un site ArcGIS GeoEvent Server en local.

Consultez le guide d’installation ArcGIS GeoEvent Server pour mettre à niveau les instructions :

• Mettre à niveau GeoEvent Server (Linux)
• Mettre à niveau GeoEvent Server (Windows)

Mettre à niveau avec les scripts Chef

Si vous avez créé le site ArcGIS GeoEvent 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.

Lorsque vous utilisez les scripts Chef pour mettre à niveau un site ArcGIS GeoEvent Server sur AWS créé avec un modèle Esri Amazon Web Services CloudFormation 10.8.x, vous devez réduire le site ArcGIS GeoEvent Server vers une seule instance EC2 plus l’instance de serveur de fichier, car les sites multi-machines ArcGIS GeoEvent Server ne sont plus compatibles sur AWS.

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 site sur Windows

Vous ne pouvez plus utiliser le groupe de mise à l’échelle automatique avec le site ArcGIS GeoEvent Server, et vous allez tout supprimer, sauf l’instance du serveur de fichier et une instance ArcGIS GeoEvent Server EC2 unique depuis la pile ArcGIS GeoEvent Server. L’instance restante sur le site doit être ajoutée au programme d’équilibrage de charge du site ; vous pourrez ensuite procéder à la mise à niveau de ArcGIS GeoEvent Server.

Modifier et supprimer le groupe de mise à l’échelle automatique

Tout d’abord, supprimez les instances ArcGIS GeoEvent Server EC2 depuis le groupe de mise à l’échelle automatique AWS et supprimez le groupe.

1. Connectez-vous à votre compte AWS Management Console et accédez au groupe de mise à l’échelle automatique associé au site ArcGIS GeoEvent Server.
2. Modifiez la propriété de capacité minimale du groupe de mise à l’échelle automatique sur 0.
3. Modifiez les propriétés de capacité maximale et souhaitée du groupe de mise à l’échelle automatique sur 1.

   Cela laisse une seule instance GeoEvent Server. Les sites multi-machines ArcGIS GeoEvent Server ne sont plus pris en charge.

4. Une fois toutes les instances du groupe, sauf une, terminées, détachez l’instance ArcGIS GeoEvent Server EC2 restante du groupe de mise à l’échelle automatique.

   Consultez la rubrique Détacher EC2 les instances de votre groupe de mise à l’échelle automatique dans la documentation AWS pour en savoir plus.

5. Une fois l’instance détachée, modifiez les propriétés de capacité maximale et souhaitée du groupe de mise à l’échelle automatique de la pile sur 0.
6. Enregistrez l’ID d’instance de l’instance EC2 restante.
7. Supprimez le groupe de mise à l’échelle automatique pour empêcher quiconque d’ajouter à nouveau les instances une fois le stockage des données mis à niveau.

Ajouter l’instance restante aux groupes cibles du programme d’équilibrage de charge.

Vous devez ajouter l’instance EC2 restante au programme d’équilibrage de charge, car les instances ont été supprimées du groupe de mise à l’échelle automatique.

Procédez comme suit pour ajouter l’instance ArcGIS GeoEvent Server EC2 qui a été détachée du groupe de mise à l’échelle automatique à l’étape 4 de la section précédente vers les quatre groupes cibles associés au programme d’équilibrage de charge.

1. Ouvrez AWS EC2 dans la AWS Management Console.
2. Cliquez sur Programmes d’équilibrage de la charge pour afficher les programmes d’équilibrage de la charge dans votre compte.
3. Sélectionnez le programme d’équilibrage utilisé pour votre site ArcGIS GeoEvent Server.
4. Cliquez sur l’onglet Listeners (Écouteurs) et prenez note des quatre groupes cibles sous Default action (Action par défaut).
5. Cliquez sur Target Groups (Groupes cibles) pour accéder aux groupes cibles de telle sorte que vous puissiez ajouter l’instance ArcGIS GeoEvent Server restante à chacun des groupes cibles enregistrés à la sous-étape d ci-dessus.
6. Enregistrez l’ID d’instance de l’instance ArcGIS GeoEvent Server restante dans chacun des quatre groupes cibles.

   Consultez la documentation AWS pour en savoir plus sur la manière d’enregistrer une instance avec les groupes cibles.

Mettre à niveau ArcGIS GeoEvent Server

Maintenant vous pouvez mettre à niveau le ArcGIS GeoEvent Server.

1. Établissez une connexion Bureau à distance avec l’instance EC2 restante sur le site ArcGIS GeoEvent Server.
2. Téléchargez et installez Chef ou Cinc Client 16.16.13. Si une version antérieure de Chef est installée, mettez-la à jour vers la version 16.16.13.
3. Téléchargez les fichiers d’installation 11.1 suivants depuis votre compte dans My Esri et importez-les dans le dossier C:\Software\Archives sur l’instance  EC2:

   • ArcGIS_Server_Windows_111_185208.exe
   • ArcGIS_GeoEvent_Server_111_185251.exe

4. Obtenez un fichier d’autorisation ArcGIS GeoEvent Server 11.1 (.epc ou .prvc) et placez-le dans un dossier local dans l’instance EC2 ou dans un partage de fichiers auquel vous pouvez accéder depuis l’instance EC2.
5. Téléchargez ArcGIS Cookbook version 4.1.0 (arcgis-4.1.0-cookbooks.zip) dans l’instance EC2, décompressez le fichier et placez son contenu dans le dossier C:\chef.
6. Créez une copie du fichier C:\chef\node.json d’origine et renommez-la vers upgrade-geoevent-server.json.
7. Ouvrez upgrade-geoevent-server.json dans un éditeur de texte et modifiez les paramètres suivants :

   • Définissez 11.1 comme version d’ArcGIS.

     "arcgis" : {
         "version": "11.1",

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

     "arcgis" : {
         "server": {
         "authorization_file" : "<drive>\\<folder>"

   • Ajoutez le nœud du référentiel d’archive et définissez-le sur le dossier où vous avez placé les fichiers d’installation logicielle sur l’instance EC2.

     "arcgis" : {
         "repository": {
     	   "archives": "C:\\Software\\Archives"

   • Supprimez les éléments suivants de la liste d’exécution :

     "recipe[arcgis-enterprise::system]",
     "recipe[arcgis-enterprise::post_install]"

   • Modifiez l’élément "recipe[arcgis-enterprise::server_node]", sur "recipe[arcgis-enterprise::server]".

   La liste d’exécution doit maintenant contenir les actions suivantes :

       "run_list"  : [
   "recipe[arcgis-enterprise::server]",
   "recipe[arcgis-geoevent]"
   ]

8. Enregistrez et fermez le fichier upgrade-geoevent-server.json.
9. 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-geoevent-server.json.
10. Importez la configuration du site ArcGIS GeoEvent Server à l’aide du fichier que vous avez exporté avant de commencer la mise à niveau.

Mettre à niveau un site sur Ubuntu

Vous ne pouvez plus utiliser le groupe de mise à l’échelle automatique avec le site ArcGIS GeoEvent Server, et vous allez tout supprimer, sauf l’instance du serveur de fichier et une instance ArcGIS GeoEvent Server EC2 unique depuis la pile ArcGIS GeoEvent Server. L’instance restante sur le site doit être ajoutée au programme d’équilibrage de charge du site ; vous pourrez ensuite procéder à la mise à niveau de ArcGIS GeoEvent Server.

Modifier et supprimer le groupe de mise à l’échelle automatique

Tout d’abord, supprimez les instances ArcGIS GeoEvent Server EC2 depuis le groupe de mise à l’échelle automatique AWS et supprimez le groupe.

1. Connectez-vous à votre compte AWS Management Console et accédez au groupe de mise à l’échelle automatique associé au site ArcGIS GeoEvent Server.
2. Modifiez la propriété de capacité minimale du groupe de mise à l’échelle automatique sur 0.
3. Modifiez les propriétés de capacité maximale et souhaitée du groupe de mise à l’échelle automatique sur 1.

   Cela laisse une seule instance GeoEvent Server. Les sites multi-machines ArcGIS GeoEvent Server ne sont plus pris en charge.

4. Une fois toutes les instances du groupe, sauf une, terminées, détachez l’instance ArcGIS GeoEvent Server EC2 restante du groupe de mise à l’échelle automatique.

   Consultez la rubrique Détacher EC2 les instances de votre groupe de mise à l’échelle automatique dans la documentation AWS pour en savoir plus.

5. Une fois l’instance détachée, modifiez les propriétés de capacité maximale et souhaitée du groupe de mise à l’échelle automatique de la pile sur 0.
6. Enregistrez l’ID d’instance de l’instance EC2 restante.
7. Supprimez le groupe de mise à l’échelle automatique pour empêcher quiconque d’ajouter à nouveau les instances une fois le stockage des données mis à niveau.

Ajouter l’instance restante aux groupes cibles du programme d’équilibrage de charge.

Vous devez ajouter l’instance EC2 restante au programme d’équilibrage de charge, car les instances ont été supprimées du groupe de mise à l’échelle automatique.

Procédez comme suit pour ajouter l’instance ArcGIS GeoEvent Server EC2 qui a été détachée du groupe de mise à l’échelle automatique à l’étape 4 de la section précédente vers les quatre groupes cibles associés au programme d’équilibrage de charge.

1. Ouvrez AWS EC2 dans la AWS Management Console.
2. Cliquez sur Programmes d’équilibrage de la charge pour afficher les programmes d’équilibrage de la charge dans votre compte.
3. Sélectionnez le programme d’équilibrage utilisé pour votre site ArcGIS GeoEvent Server.
4. Cliquez sur l’onglet Listeners (Écouteurs) et prenez note des quatre groupes cibles sous Default action (Action par défaut).
5. Cliquez sur Target Groups (Groupes cibles) pour accéder aux groupes cibles de telle sorte que vous puissiez ajouter l’instance ArcGIS GeoEvent Server restante à chacun des groupes cibles enregistrés à la sous-étape d ci-dessus.
6. Enregistrez l’ID d’instance de l’instance ArcGIS GeoEvent Server restante dans chacun des quatre groupes cibles.

   Consultez la documentation AWS pour en savoir plus sur la manière d’enregistrer une instance avec les groupes cibles.

Mettre à niveau ArcGIS GeoEvent Server

Maintenant vous pouvez mettre à niveau le ArcGIS GeoEvent Server.

1. En tant qu’utilisateur ubuntu, effectuez une connexion SSH à l’instance EC2 restante dans le site ArcGIS GeoEvent Server.
2. Utilisez l’une des commandes ci-après pour télécharger et installer Chef ou Cinc Client 16.16.13. Si une version antérieure de Chef est installée, mettez-la à jour vers la version 16.16.13.
   • 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 fichiers d’installation 11.1 suivants depuis votre compte dans My Esri et importez-les dans le dossier /opt/software/archives sur l’instance EC2 restante :

   • ArcGIS_Server_Linux_111_185292.tar.gz
   • ArcGIS_GeoEvent_Server_111_185315.tar.gz

4. Obtenez un fichier d’autorisation ArcGIS GeoEvent Server 11.1 (.epc ou .prvc) et placez-le dans un dossier local dans l’instance EC2 ou dans un partage de fichiers auquel vous pouvez accéder depuis l’instance EC2.
5. Téléchargez ArcGIS Cookbook version 4.1.0 (arcgis-4.1.0-cookbooks.tar.gz) dans l’instance EC2, décompressez le fichier et placez son contenu dans le répertoire /var/chef.
6. Supprimez le répertoire nodes sous /var/chef/, puis supprimez le répertoire local-mode-cache sous /etc/chef/.
7. Créez une copie du fichier /etc/chef/node.json d’origine et renommez-la vers upgrade-geoevent-server.json.
8. Ouvrez upgrade-geoevent-server.json dans un éditeur de texte et modifiez les paramètres suivants :

   • Définissez 11.1 comme version d’ArcGIS.

     "arcgis" : {
         "version": "11.1",

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

     "arcgis" : {
         "server": {
         "authorization_file" : "/<folder>/subfolder"

   • Ajoutez le nœud du référentiel d’archive et définissez-le sur le dossier où vous avez placé les fichiers d’installation logicielle sur l’instance EC2.

     "arcgis" : {
         "repository": {
     	   "archives": "/opt/software/archives"

   • Supprimez les éléments suivants de la liste d’exécution :

     "recipe[arcgis-enterprise::system]",
     "recipe[arcgis-enterprise::post_install]"

   • Modifiez l’élément "recipe[arcgis-enterprise::server_node]", sur "recipe[arcgis-enterprise::server]".

   La liste d’exécution doit maintenant contenir les actions suivantes :

       "run_list"  : [
   "recipe[arcgis-enterprise::server]",
   "recipe[arcgis-geoevent]"
   ]

9. Enregistrez et fermez le fichier upgrade-geoevent-server.json.
10. En tant qu’utilisateur ubuntu, exécutez la commande suivante : chef-client -z -j /etc/chef/upgrade-geoevent-server.json.
11. Importez la configuration du site ArcGIS GeoEvent Server à l’aide du fichier que vous avez exporté avant de commencer la mise à niveau.

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

Si vous avez utilisé un modèle de déploiement CloudFormation 10.9, 10.9.1 ou 11.0 fourni par Esri (arcgis-geoevent-server-singlemachine.template.json) pour créer un site ArcGIS GeoEvent Server, vous pouvez utiliser le modèle de mise à niveau 11.1 correspondant (arcgis-geoevent-server-singlemachine-upgrade.template.json) pour le mettre à niveau. Pour obtenir les instructions d’utilisation du modèle de mise à niveau, reportez-vous à la rubrique Mettre à niveau un site ArcGIS GeoEvent Server à une seule machine avec CloudFormation.