Mettre à niveau un ArcGIS Data Store à une seule machine avec CloudFormation

Le modèle Esri Amazon Web Services (AWS) CloudFormation arcgis-datastore-singlemachine-upgrade.template.json met à niveau ArcGIS Data Store 10.9 sur une instance Amazon Elastic Compute Cloud (EC2) que vous avez créée avec le modèle décrit dans la rubrique Déployer ArcGIS Data Store sur une machine avec CloudFormation.

Le modèle arcgis-datastore-singlemachine-upgrade.template.json met à niveau ArcGIS Data Store sur une instance EC2.

Conditions requises

Les prérequis peuvent être regroupés en fonction des éléments (par exemple, fichiers et comptes) que vous devez vous procurer et des tâches que vous devez effectuer avant d’exécuter le modèle CloudFormation.

Éléments requis

Vous avez besoin des éléments suivants avant d’exécuter ce modèle :

• Compte Amazon Web Services avec accès au déploiement à mettre à niveau.
• Un déploiement ArcGIS Data Store à une seule machine existant que vous avez créé avec le modèle Esri Amazon Web Services CloudFormation arcgis-datastore-singlemachine.template.json.
• Le modèle CloudFormation de mise à niveau, arcgis-datastore-singlemachine-upgrade.template.json.

Remarque :

Pour mettre à niveau votre déploiement, exécutez ce modèle CloudFormation de mise à niveau qui crée une nouvelle pile CloudFormation. Ne mettez pas à jour la pile CloudFormation existante du déploiement 10.9 avec ce modèle.

Tâches requises

Effectuez les tâches suivantes avant d’exécuter ce modèle :

• Vous devez mettre à niveau le site ArcGIS GIS Server (serveur d’hébergement) auprès duquel ce Data Store est inscrit avant de mettre à niveau ArcGIS Data Store.
• Configurez des mots de passe dans AWS Secrets Manager (facultatif mais recommandé).

  Vous pouvez configurer les mots de passe des comptes (par exemple, le nom d’utilisateur de l’administrateur du site et le mot de passe de l’utilisateur arcgis Windows) dans AWS Secrets Manager. Vous obtenez alors un nom de ressource Amazon (ARN) secret. Utilisez l’ARN à la place d’un mot de passe dans les paramètres de modèle lorsque vous lancez une pile. Si vous n’utilisez pas AWS Secrets Manager pour stocker des mots de passe, vous devez saisir les mots de passe en texte brut dans le paramètre de modèle au lancement de la pile.

  Remarque :

  Lorsque vous créez un ARN secret dans AWS Secrets Manager pour un mot de passe à utiliser avec des modèles Esri CloudFormation, vous devez utiliser le type de secret Other types of secrets (Autres types de secret) et l’option Plaintext (Texte brut). Pour plus d’informations sur la création d’un nom de ressource Amazon pour les mots de passe, voir AWS CloudFormation et ArcGIS.

Conseil :

Par défaut, CloudFormation supprime les ressources partiellement créées si la création de la pile échoue. Cela est utile car les déploiements inutilisables sont alors supprimés de votre déploiement, mais il peut être difficile d’en corriger les problèmes. Pour conserver la pile dans son état d’échec, désactivez l’option de création de pile CloudFormation Rollback on failure (Restauration en cas d’échec) avant de lancer la pile. Pour plus d’informations, reportez-vous à la rubrique Définition d’options AWS CloudFormation de l’aide AWS.

Paramètres

Reportez-vous aux tableaux ci-dessous pour obtenir la description des paramètres utilisés dans ce modèle CloudFormation. Les tableaux sont regroupés par type de paramètre.

ArcGIS Data Store Configuration

Nom de paramètre	Obligatoire	Description du paramètre
Platform Type	Requis	Sélectionnez le type de plateforme de votre déploiement ArcGIS Data Store existant. Windows Linux
ArcGIS Data Store EC2 Instance ID (ID d’instance ArcGIS Data Store EC2)	Requis	Sélectionnez l’ID de l’instance EC2 dans le déploiement ArcGIS Data Store existant. Si vous avez créé le déploiement existant avec un modèle Esri CloudFormation ou Cloud Builder, vous trouverez l’ID d’instance dans la section Resources (Ressources) de la pile CloudFormation existante dans AWS Management Console. L’ID logique de la ressource est ArcGIS DatastoreEC2Instance.
Type	Requis	Sélectionnez le type de Data Store du déploiement ArcGIS Data Store existant. Les valeurs valides sont relational, tileCache et spatiotemporal.
Windows arcgis user password	Conditions	Ce mot de passe n’est obligatoire qu’en cas de déploiement sur Windows. Indiquez le mot de passe de l’utilisateur arcgis de votre déploiement existant. Vous pouvez entrer un mot de passe en texte simple ou l’ARN de votre ID secret AWS Secrets Manager. Il est recommandé de gérer vos mots de passe dans AWS Secrets Manager. Pour plus d’informations sur la création d’un nom de ressource Amazon pour les mots de passe, voir AWS CloudFormation et ArcGIS.

ArcGIS Server Configuration

Nom de paramètre	Obligatoire	Description du paramètre
Site Administrator User Name	Requis	Indiquez le nom d’utilisateur de l’administrateur principal du site ArcGIS Server existant.
Site Administrator User Password	Requis	Indiquez un mot de passe pour l’administrateur principal du site ArcGIS Server. Vous pouvez entrer un mot de passe en texte simple ou l’ARN de votre ID secret AWS Secrets Manager. Pour plus d’informations sur la création d’un nom de ressource Amazon pour les mots de passe, voir AWS CloudFormation et ArcGIS. Le mot de passe ou ID secret indiqué doit correspondre à celui de l’administrateur de site principal.
ArcGIS Server EC2 Instance ID	Requis	Sélectionnez un ID d’instance EC2 à partir du site ArcGIS Server avec lequel le Data Store est configuré. Remarque : Si le Data Store est inscrit auprès d’un site ArcGIS Server à plusieurs machines, vous pouvez sélectionner n’importe quel ID d’instance EC2 à partir du site ArcGIS Server. Ne choisissez pas une instance EC2 de serveur de fichiers.

Sorties

Une fois votre pile créée, les paramètres en sortie ci-dessous s’affichent dans l’onglet Outputs (Sorties) de la pile CloudFormation dans AWS Management Console.

Nom en sortie	Description de la sortie
DeploymentLogsURL	URL où sont stockés les journaux de déploiement de Amazon CloudWatch. Consultez ces journaux à des fins de dépannage en cas d’échec du déploiement.

Éléments à prendre en compte

Les aspects suivants sont des points importants à prendre en compte après la création d’une pile CloudFormation contenant des déploiements ArcGIS :

• Une fois votre pile créée (à savoir lorsque son statut est CREATE_COMPLETE), le déploiement ArcGIS Data Store est mis à niveau avec succès. Pour le confirmer, connectez-vous à ArcGIS Server Manager et vérifiez le data store.
• En cas d’échec de la création de la pile CloudFormation (en d’autres termes, si son statut est CREATE_FAILED), vous pouvez résoudre l’erreur en suivant la procédure décrite dans la page accessible à partir de la section Dépannage ci-dessous. Après avoir identifié la principale cause de l’erreur et avoir pris les actions requises, vous pouvez supprimer la pile défaillante et en créer une nouvelle pour mettre à niveau le déploiement ArcGIS Data Store existant.

Dépannage

Si des erreurs se produisent lors de la création de cette pile CloudFormation, reportez-vous à la rubrique Résoudre les problèmes de déploiement ArcGIS dans AWS.