Plusieurs méthodes sont disponibles pour déployer ArcGIS Enterprise et ArcGIS Server sur Amazon Web Services (AWS). Cette rubrique décrit comment résoudre les problèmes pouvant être rencontrés avec chaque option de déploiement.
Résoudre les problèmes sur ArcGIS Enterprise Cloud Builder for Amazon Web Services
Le dossier Logs à l’emplacement où vous avez extrait ArcGIS Enterprise Cloud Builder for Amazon Web Services et ses fichiers associés comprend deux sous-dossiers.
Le dossier Logs comprend les deux sous-dossiers suivants :
- Log : ce dossier contient les journaux de la console, créés lors de chaque exécution de l’utilitaire. Le dossier Log contient également des journaux d’événements CloudFormation pour chaque pile que vous créez dans le cadre du déploiement chaque fois que vous exécutez la commande CREATE avec l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS ou que vous ajoutez un déploiement dans l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services.
- ErrorLog : ce dossier contient les fichiers journaux permettant d’enregistrer les erreurs se produisant lors de l’exécution de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS ou de l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services. Pour une résolution efficace des problèmes, consultez ces journaux.
Consultez les deux sections suivantes pour obtenir des informations sur les erreurs spécifiques susceptibles de se produire lorsque vous exécutez l’application Cloud Builder ou l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS. L’application et l’utilitaire lancent tous deux des piles CloudFormation, il est donc également conseillé de lire la section Résoudre les problèmes de création d’une pile CloudFormation pour identifier et corriger les problèmes de déploiement.
Erreurs rencontrées lors de l’exécution de l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services
L’application ArcGIS Enterprise Cloud Builder for Amazon Web Services valide un grand nombre de valeurs que vous indiquez au fur et à mesure que vous utilisez l’application. Des informations supplémentaires sont disponibles dans les emplacements des fichiers journaux mentionnés dans la section précédente.
Je reçois un message indiquant que mon nom de domaine n’est pas valide.
Plusieurs causes peuvent empêcher Cloud Builder de valider votre nom de domaine, mais la plus probable est liée à un appariement manquant ou incorrect du nom de domaine dans votre serveur de nom de domaine (DNS). Le nom de domaine peut ainsi ne pas être apparié dans votre DNS ou être incorrectement apparié.
Vérifiez que le nom de domaine fourni est résolu en enregistrement CNAME ou A dans votre DNS. Pour savoir si le nom de domaine indiqué dans Cloud Builder est correctement apparié, utilisez la commande nslookup dans une invite de commande Microsoft Windows sur la machine sur laquelle vous exécutez l’application Cloud Builder.
Si vous pensez que l’appariement de votre nom de domaine est correct, essayez de vider le cache local du DNS sur la machine sur laquelle vous exécutez Cloud Builder, puis de valider à nouveau le nom de domaine dans l’application Cloud Builder.
Si votre nom de domaine n’est toujours pas validé, contactez votre administrateur informatique pour obtenir de l’aide.
La création de mon déploiement a échoué.
Si l’application Cloud Builder ne parvient pas à créer votre déploiement, des messages d’erreur s’affichent sur la page de fin de la tâche Cloud Builder. Pour afficher plus de détails sur les erreurs, cliquez sur View Process Log (Afficher le journal du traitement) et sur View Error Log (Afficher le journal des erreurs) sur la page de fin de la tâche.
Si vous voyez une erreur générique, telle que Wait condition received failed message: ’Chef run failed. (la condition d’attente a reçu le message d’échec : ‘l’exécution de Chef a échoué.) Voir 'c:\\chef\chef-run.log’ pour plus de détails', vérifiez les journaux Amazon CloudWatch en cliquant sur les URL des journaux dans la section View AWS CloudWatch Logs (Afficher les journaux AWS CloudWatch) de la page récapitulative de Cloud Builder. Cela ouvre le journal CloudWatch approprié dans votre navigateur par défaut et vous permet de visualiser les journaux de chaque instance Amazon Elastic Compute Cloud (EC2) de votre déploiement afin de déterminer la cause de l’échec.
Une fois que vous avez trouvé la cause, vous pouvez cliquer sur Back (précédent) dans l’application Cloud Builder pour résoudre le paramètre requis et faire une nouvelle tentative de déploiement. Vous pouvez aussi supprimer le déploiement en échec et en créer un nouveau.
L’application ArcGIS Enterprise Cloud Builder for Amazon Web Services se bloque constamment et renvoie une erreur indiquant que ArcGIS Enterprise Cloud Builder for AWS ne fonctionne plus.
Si l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services se bloque et renvoie le messages d’erreur suivant : ArcGIS Enterprise Cloud Builder for AWS a cessé de fonctionner. Un problème a fait que le programme a cessé de fonctionner correctement. Windows va fermer ce programme et vous indiquer si une solution est disponible., il se peut que le paquetage distribuable Microsoft Visual C++ requis soit manquant sur votre machine. Pour plus d’informations et pour avoir un lien de téléchargement du paquetage, reportez-vous à la rubrique Conditions requises pour Cloud Builder.
Où puis-je trouver les journaux CloudWatch pour les déploiements que je crée à l’aide de l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services ?
Si l’application Cloud Builder ne parvient pas à créer votre déploiement, des messages d’erreur sont renvoyés sur la page de fin de la tâche. Pour afficher plus de détails sur les erreurs, cliquez sur View Process Log (Afficher le journal du traitement) et sur View Error Log (Afficher le journal des erreurs) sur la page de fin de la tâche.
Erreurs liées à l’utilisation de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS
Vous trouverez ci-dessous des messages ou problèmes courants susceptibles d’être générés lors de l’utilisation de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS, ainsi que des suggestions permettant de les résoudre.
J’ai reçu une erreur liée aux autorisations.
L’utilisateur qui exécute l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS doit disposer d’un accès en écriture récursif aux dossiers Logs et Output. Vérifiez que ces droits ont été accordés.
J’ai reçu le message Fichier <nom_fichier> introuvable.
À partir de la version 10.8.1, vous devez placer les fichiers de configuration JSON dans le dossier Configuration ou dans l’un de ses sous-dossiers dans votre répertoire de travail ; ne placez pas les fichiers de configuration JSON dans le répertoire Configuration qui se trouve dans le répertoire d'installation. Si vos fichiers de configuration ne se trouvent pas dans le dossier Configuration de votre répertoire de travail, déplacez les fichiers dans ce dossier et exécutez à nouveau l’utilitaire.
Pour les versions 10.8 et les versions antérieures, vous devez placer les fichiers de configuration JSON dans le dossier Configuration ou dans l’un de ses sous-dossiers dans le répertoire d’installation. Si vos fichiers de configuration ne se trouvent pas à cet emplacement, déplacez-les dans le dossier Configuration et exécutez à nouveau l’utilitaire.
J’ai reçu le message Extension de fichier de configuration de déploiement non valide. L’extension doit être .json.
Le fichier de configuration utilisé doit porter l’extension .json. Si tel n’est pas le cas, renommez-le en ajoutant cette extension de fichier et réexécutez l’utilitaire.
J’ai reçu le message Format JSON non valide pour le fichier <nom_fichier>.
Vérifiez que le fichier de configuration présente un format JSON valide.
Astuce :
Vous pouvez utiliser un validateur JSON tel que JSONLint pour valider le format.
J’ai reçu le message Impossible d’accéder au compte AWS avec les informations d’identification fournies.
Vérifiez que vous avez indiqué des identifiants de connexion AWS valides dans le fichier de configuration JSON de sorte que l’utilitaire puisse se connecter à AWS. Si les informations d’identification sont valides, assurez-vous que votre compte est accessible depuis la machine sur laquelle vous exécutez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS.
J’ai reçu une erreur indiquant un refus d’accès lors de l’exécution de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS avec la commande PREP.
Si vous utilisez un paquet Amazon Simple Storage Service (S3) existant pour vos fichiers de déploiement, vérifiez que vous disposez des autorisations appropriées pour accéder au paquet et y écrire des données.
Lorsque j’ouvre le fichier en sortie après l’exécution de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS avec la commande CREATE, je ne vois pas tous les composants attendus.
Le fichier en sortie créé à l’aide de la commande CREATE contient des en-têtes pour chaque composant créé par l’utilitaire sur AWS. Ces en-têtes correspondent aux nœuds figurant dans le fichier de configuration JSON. Ces nœuds indiquent à l’utilitaire les composants qui doivent être créés. Si vous omettez un nœud, l’utilitaire ne peut pas créer le composant correspondant.
Chaque nœud figurant dans le fichier de configuration doit contenir au moins un paramètre. Même si vous définissez tous les paramètres sous le nœud "Default", vous devez ajouter un nœud pour chaque partie du déploiement à créer et ce nœud doit contenir au moins un paramètre et une valeur. Si un nœud est présent dans le fichier de configuration, mais sans paramètre, l’utilitaire ignore ce nœud. Par exemple, vous ne pouvez pas définir les paramètres d’un site ArcGIS GIS Server dans le nœud "Default" et placer un nœud "Server" vide dans le fichier de configuration. Si vous le faites, l’utilitaire ne crée pas le site ArcGIS GIS Server.
Vérifiez dans le fichier de configuration que vous avez ajouté tous les nœuds requis et au moins un paramètre pour chaque composant du déploiement. Reportez-vous à la rubrique Paramètres d’ArcGIS Enterprise Cloud Builder CLI for AWS pour connaître la liste des paramètres requis pour chaque nœud du fichier de configuration.
Lorsque j’exécute l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS, l’invite de commande semble ne plus s’exécuter.
Si vous trouvez que l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS ou un utilitaire que vous exécutez dans une fenêtre de commande Microsoft Windows arrête de s’exécuter, désactivez QuickEdit Mode (Mode d’édition rapide) pour la fenêtre de commande.
Résoudre les problèmes de création d’une pile AWS CloudFormation
Les outils de déploiement ArcGIS Enterprise on Amazon Web Services créent des piles AWS CloudFormation. Utilisez la console AWS CloudFormation pour surveiller le statut de votre pile AWS CloudFormation et constater l’échec de la création de la pile, le cas échéant. Connectez-vous à la console AWS CloudFormation (qui fait partie de AWS Management Console) et ouvrez l’onglet Events (Événements) pour trouver des informations sur la création, les mises à jour et les suppressions de piles. Si la création de la pile échoue, les informations de l'onglet Events (Événements) vous permettent souvent de comprendre l’origine du problème.
Les outils de déploiement ArcGIS Enterprise on Amazon Web Services créent également des fichiers journaux sur les machines virtuelles afin de vous aider à résoudre les problèmes. Pour être certain que les fichiers sont conservés même en cas d’échec d’un lancement de déploiement, connectez-vous à la console AWS CloudFormation et désactivez l’option Rollback on failure (Restauration en cas d’échec).
Si votre déploiement échoue lorsque le lancement est effectué à l’aide d’un outil de déploiement ArcGIS Enterprise on Amazon Web Services, réalisez une connexion de bureau à distance ou SSH avec l’instance Amazon Elastic Compute Cloud (EC2) pour visualiser les journaux. Les types de journaux et emplacements sont indiqués dans le tableau suivant :
| Type d’instance EC2 | Fichier journal et emplacement sur une instance EC2 | Description du fichier journal |
|---|---|---|
Ubuntu | /var/log/cfn-init.log | Fichier journal du script d’assistance CloudFormation utilisé pour extraire et interpréter les métadonnées de la ressource, installer des paquetages, créer des fichiers et démarrer des services |
/var/log/chef-run.log | Fichier journal de l'outil de gestion de la configuration de Chef | |
/var/lib/tomcat7/logs/catalina.out | Fichier journal du serveur d’applications Apache Tomcat | |
Windows | C:\cfn\log\cfn-init.log | Fichier journal du script d’assistance CloudFormation utilisé pour extraire et interpréter les métadonnées de la ressource, installer des paquetages, créer des fichiers et démarrer des services |
C:\chef\chef-run.log | Fichier journal de l'outil de gestion de la configuration de Chef |
Remarque :
Si la création de la pile CloudFormation aboutit, les paramètres en sortie de la pile fournissent un lien vers le groupe de journaux dans AWS Management Console. Si la création de la pile échoue, accédez à la liste Resources (Ressources) de CloudFormation dans AWS Management Console pour trouver le groupe de journaux. Si la création de la pile échoue avant qu’une instance soit lancée, il est possible que le groupe de journaux ne soit pas créé.
Où puis-je trouver les journaux CloudWatch des déploiements que je crée à l’aide des outils de déploiement ArcGIS Enterprise on Amazon Web Services ?
Pour accéder aux journaux CloudWatch des déploiements créés à l’aide des outils de déploiement ArcGIS Enterprise on Amazon Web Services, connectez-vous à la console CloudFormation, faisant partie de AWS Management Console. Consultez la rubrique Afficher les journaux CloudFormation de la console sur le site Web AWS.
Pourquoi ne puis-je pas trouver les journaux CloudWatch du déploiement que j’ai créé à l’aide des outils de déploiement ArcGIS Enterprise on Amazon Web Services ?
À partir de la version 10.8.1, ArcGIS Enterprise Cloud Builder for AWS utilise la version 2 (V2) du service de métadonnées d’instance (IMDS) Amazon lors de la création des déploiements. À compter de la version 10.8.1, les modèles CloudFormation fournis par Esri utilisent également par défaut la version V2 du service de métadonnées d’instance (IMDS). Actuellement, l’agent de journal CloudWatch installé par AWS sur les instances EC2 n’est pas compatible avec IMDS V2. Il s'agit d’une limitation connue.
Tant que AWS n’aura pas corrigé cette limitation, vous devrez suivre la procédure suivante pour voir les journaux décrivant les problèmes rencontrés en cas d’échec du lancement de votre pile :
- Connectez-vous à la console CloudFormation dans AWS Management Console.
- Accédez à la pile CloudFormation dont le lancement a échoué et vérifiez l’onglet Events (Événements) afin d’identifier l’origine du problème.
- Si un message similaire à Received FAILURE signal with UniqueId <instanceid> (Signal d’Échec reçu avec UniqueId <instanceid>) s’affiche, utilisez le Bureau à distance ou SSH et l’ID d’instance du message pour accéder à l’instance EC2 concernée.
- Vérifiez les journaux de Chef pour identifier la raison de l’échec du lancement de la pile. Les journaux de Chef se trouvent à l’un des emplacements suivants, en fonction du système d'exploitation de l’instance EC2 :
- Microsoft Windows : C:\chef\chef-run.log
- Ubuntu : /var/log/chef-run.log
Astuce :
Si vous utilisez les modèles CloudFormation fournis par Esri pour que votre déploiement utilise la version IMDS 1 (V1) afin d’éviter la limitation connue de l’agent de journal CloudWatch. Le service IMDS V1 étant moins sécurisé que le service IMDS V2, cette solution n’est pas recommandée.
Erreurs liées au lancement d’une pile AWS CloudFormation
Vous trouverez ci-dessous des messages ou problèmes courants susceptibles d’être générés lors du déploiement à l’aide d’un modèle AWS CloudFormation, ainsi que des suggestions permettant de les résoudre.
Pourquoi un message d'erreur indique-t-il que la capacité est insuffisante lorsque je clique sur Démarrage pour lancer une instance ?
Cette erreur émanant de Amazon Elastic Compute Cloud signifie que la capacité disponible est insuffisante pour répondre à votre demande d’une nouvelle instance. Si l’architecture de votre déploiement le permet, vous pouvez contourner cette erreur en faisant appel à une instance située dans une autre zone de disponibilité ou en permettant à EC2 de choisir à votre place la zone de disponibilité. Vous pouvez également essayer de lancer une autre taille d'instance ou de lancer l'instance ultérieurement.
Que signifie le message Erreur détectée lors de la création de la configuration : échec de l’extraction de https:// .s3.amazonaws.com/ dans cfn-init.log ?
Si ce message apparaît dans le fichier cfn-init.log, vérifiez que le nom du paquet S3 du déploiement est correct et que le nom de clé d’objet S3 des fichiers d’autorisations et des certificats SSL sont corrects.
Que signifie le message Unable to connect to WebAdaptor URL (Connexion impossible à l’URL WebAdaptor) : https://agsportalssl.esri.com/server/webadaptor dans le fichier journal catalina.out ?
Si ce message apparaît dans le fichier journal catalina.out d’une instance Ubuntu, vérifiez que le certificat SSL du paquet S3 du déploiement est valide et qu’il respecte le format PKCS 12. Vérifiez également que le mot de passe du certificat SSL est correct.
Que signifie le message OpenSSL::PKCS12::PKCS12Error: PKCS12_parse : échec de vérification mac dans le fichier chef-run.log ?
Si ce message apparaît dans le fichier chef-run.log d’une instance Windows, vérifiez que le certificat SSL du paquet S3 du déploiement est valide et qu’il respecte le format PKCS 12. Vérifiez également que le mot de passe du certificat SSL est correct.
Résoudre les problèmes sur AWS Management Console
Lors de l’utilisation de AWS Management Console et des images virtuelles Amazon Esri pour créer manuellement votre site, l’une des erreurs suivantes risque de se produire :
Pourquoi est-ce que je reçois un message indiquant No password was found (Aucun mot de passe n’a été trouvé) lorsque j’essaie de récupérer le mot de passe d’administrateur de mon instance EC2 sous Windows ?
Ce message peut s’afficher si vous essayez d’utiliser Get Windows Password (Récupérer le mot de passe Windows) après avoir arrêté et démarré une instance EC2. Pour éviter cette erreur, lors de votre première connexion, modifiez le mot de passe d’administrateur en un mot de passe plus facilement mémorisable.
Dans AWS Management Console, un message indiquant que mon instance doit être retirée apparaît. Qu’est-ce que cela signifie ?
Ce message peut apparaître si votre instance s’exécute sur un matériel dégradé que Amazon doit remplacer. Si vous voyez ce message, vous devez arrêter votre site et le redémarrer.
Une fois que vous avez redémarré le site, le message devrait avoir disparu.
Vous avez un commentaire à formuler concernant cette rubrique ?