De nombreuses méthodes s’offrent à vous pour déployer ArcGIS Enterprise et ArcGIS Server sur Amazon Web Services (AWS). Cette page 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
Il existe deux dossiers sous le dossier Logs à l’emplacement où vous avez extrait ArcGIS Enterprise Cloud Builder for Amazon Web Services et ses fichiers associés.
Le dossier Logs contient les deux sous-dossiers suivants :
- Log : ce dossier contient les journaux de console, qui sont créés chaque fois que vous exécutez l’utilitaire. Le dossier Log contient également les journaux d’événements CloudFormation pour chaque pile que vous créez dans le cadre du déploiement à chaque exécution de la commande CREATE avec l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS ou à l’ajout du déploiement dans l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services.
- ErrorLog : ce dossier contient les fichiers journaux pour enregistrer chaque erreur qui survient lorsque vous exécutez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS ou l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services. Consultez ces journaux d’erreur pour une résolution efficace des problèmes.
Consultez les deux sections suivantes pour en savoir plus sur les erreurs spécifiques que vous pourriez rencontrer lors de l’exécution de l’application Cloud Builder ou de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS. L’application comme l’utilitaire lancent les piles CloudFormation de sorte que vous devez également lire la section sur la résolution des problèmes liés à la création de pile CloudFormation pour permettre d’identifier et de 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 nombre des valeurs fournies comme vous utilisez l’application. Des informations supplémentaires sont disponibles aux emplacements de fichier journal mentionnés à la section précédente.
Je reçois un message indiquant que mon nom de domaine n’est pas valide.
Diverses raisons peuvent expliquer pourquoi Cloud Builder ne peut pas valider votre nom de domaine, mais il est fort probable que cela soit lié à un défaut de mappage ou à un mappage erronné 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 vérifier si le nom de domaine fourni dans Cloud Builder est correctement mappé, utilisez la commande nslookup dans une invite de commande Microsoft Windows sur la même machine que celle où vous exécutez l’application Cloud Builder.
Si vous pensez que le mappage de votre nom de domaine est juste, essayez d’effacer le cache du DNS local sur la machine où vous exécutez Cloud Builder, puis validez à 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 peut pas créer votre déploiement, des messages d’erreur sont affichés sur la page d’exécution 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 une erreur générique du type Received FAILURE signal with UniqueId <unique-id> (Signal d’échec reçu avec l’ID unique <id-unique>) s’affiche, consultez les journaux Amazon CloudWatch en cliquant sur les URL associées dans la section View AWS CloudWatch Logs (Afficher les journaux AWS CloudWatch) de la page de résumé de Cloud Builder. Cela ouvre le journal CloudWatch approprié dans votre navigateur Web par défaut, où vous pouvez afficher les journaux pour chaque instance Amazon Elastic Compute Cloud (EC2) dans votre déploiement et déterminer la raison de l’échec.
Une fois que vous déterminez ce qui a provoqué l’échec, vous pouvez cliquer sur Back (Retour) dans l’application Cloud Builder pour corriger le paramètre requis et essayer à nouveau le 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 ne cesse de planter et renvoie une erreur indiquant que ArcGIS Enterprise Cloud Builder for AWS a arrêté de fonctionner.
Si l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services plante et renvoie le message d’erreur suivant : ArcGIS Enterprise Cloud Builder for AWS has stopped working (ArcGIS Enterprise Cloud pour AWS a cessé de fonctionner.) Un problème a fait que le programme a cessé de fonctionner correctement. Windows will close the program and notify you if a solution is available (Windows va fermer le programme et vous avertira si une solution est disponible.), il est probable que votre machine n’ait pas le pack redistribuable Microsoft Visual C++. Consultez les conditions préalables Cloud Builder pour en savoir plus et obtenir un lien pour télécharger le pack.
Où puis-je trouver les journaux CloudWatch pour les déploiements que je crée avec l’application ArcGIS Enterprise Cloud Builder for Amazon Web Services ?
Si l’application Cloud Builder ne peut pas créer votre déploiement, elle renvoie des messages d’erreur sur la page d’exécution 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 rencontrées lors de l’utilisation de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS
Ci-après vous trouverez certains des messages ou problèmes communs que vous pouvez rencontrer lors de l’utilisation de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS et des suggestions sur la manière de les corriger.
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 avoir un accès en écriture récursive aux dossiers Logs et Output. Vérifiez que ces droits ont été accordés.
J’ai reçu le message Fichier <nom_fichier> introuvable.
Vous devez placer les fichiers de configuration dans le dossier Configuration ou un de ses sous-dossiers dans votre répertoire de travail ; ne placez pas les fichiers de configuration JSON dans le dossier Configuration disponible dans le répertoire d’installation. Si vos fichiers de configuration n’étaient pas dans le dossier Configuration dans votre répertoire de travail, déplacez les fichiers ici et exécutez à nouveau l’utilitaire.
Je reçois le message Invalid deployment configuration file extension. It must be ’.json’ (Extension de fichier de configuration du déploiement non valide. Elle doit être « .json »).
Le fichier de configuration que vous utilisez doit avoir une 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.
Conseil :
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.
Veillez à avoir des identifiants de connexion AWS valides dans le fichier de configuration JSON de telle sorte que l’utilitaire puisse se connecter à AWS. Si les identifiants de connexion sont valides, veillez à ce que votre compte soit accessible depuis la machine où vous exécutez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS.
Je reçois une erreur indiquant que l’accès est refusé lorsque j’exécute 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, veillez à avoir les autorisations appropriées pour accéder et écrire vers le paquet.
Lorsque j’ouvre le fichier sortant 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 souhaités.
Le fichier sortant créé lorsque vous utilisez la commande CREATE contient les en-têtes pour chaque composant que l’utilitaire a créé 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 inclure un nœud pour chaque partie du déploiement que vous souhaitez 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 pour un site ArcGIS GIS Server dans le nœud "Default" et placer un nœud "Server" vide dans le fichier de configuration. Si vous y parvenez, l’utilitaire ne créera pas de 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. Consultez les paramètres ArcGIS Enterprise Cloud Builder CLI for AWS pour une liste des paramètres requis pour chaque nœud dans le fichier de configuration.
Lorsque j’exécute l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS, l’invite de commande semble arrêter l’exécution.
Si vous pensez que l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS ou tout autre utilitaire que vous exécutez dans une fenêtre de commande Microsoft Windows cesse de s’exécuter, désactivez QuickEdit Mode (Mode Modification rapide) pour la fenêtre de commande.
Résoudre les problèmes liés à la création de la 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 détecter tout échec de la création de pile. Connectez-vous à la AWS CloudFormation (qui fait partie de la AWS Management Console) et ouvrez l’onglet Événements pour trouver des informations sur la création, la mise à jour et la suppression de piles. En cas d’échec de la création de la pile, les informations de l’onglet Événements vous permettent souvent d’en comprendre la raison.
Les outils de déploiement ArcGIS Enterprise on Amazon Web Services créent également des fichiers journaux sur les machines virtuelles pour vous aider à résoudre les problèmes. Pour veiller à ce que les fichiers soient préservés même en cas d’échec du lancement de votre déploiement, connectez-vous à la console AWS CloudFormation et désactivez l’option Restaurer en cas d’échec.
Lorsque vous créez un déploiement à l’aide des modèles CloudFormation fournis par Esri, tous les journaux de déploiement sont exportés vers le service de journalisation Amazon CloudWatch. Pour plus d’informations sur la consultation des journaux de déploiement, reportez-vous aux instructions figurant dans la section Afficher les journaux dans la console CloudWatch de la page Afficher les journaux AWS CodeDeploy dans la console Amazon CloudWatch, dans l’aide sur AWS.
Les journaux de déploiement sont stockés en tant que groupe de journaux dans le service de journalisation Amazon CloudWatch. Ce groupe de journaux contient plusieurs flux de journaux portant des noms qui se terminent par /stderr et /stdout. Consultez tous les flux pour identifier la cause de l’échec.
Ces journaux sont également stockés dans l’instance EC2. Dans les instances Microsoft Windows, ces journaux se trouvent dans les dossiers C:\cinc. Dans les instances Ubuntu Server, ces journaux se trouvent dans le répertoire /var/logs.
Où puis-je trouver les journaux CloudWatch pour les déploiements que je crée avec les outils de déploiement ArcGIS Enterprise on Amazon Web Services ?
Pour accéder aux journaux CloudWatch pour les déploiements que vous créez avec les outils de déploiement ArcGIS Enterprise on Amazon Web Services, connectez-vous à la console CloudFormation, qui fait partie de la AWS Management Console. Consultez la rubrique Afficher les journaux CloudFormation dans la console sur le site Web AWS.
Erreurs rencontrées lors du lancement d’une pile AWS CloudFormation
Ci-après vous trouverez certains des messages ou problèmes communs que vous pouvez rencontrer lors du déploiement avec le modèle d’utilitaire AWS CloudFormation et des suggestions sur la manière de les corriger.
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 provenant 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 demandant une instance dans une autre zone de disponibilité ou en laissant EC2 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 Unable to connect to WebAdaptor URL : https://agsportalssl.esri.com/server/webadaptor (Impossible de se connecter à l’URL WebAdaptor : https://agsportalssl.esri.com/server/webadaptor) dans le fichier journal catalina.out ?
Si vous voyez ce message dans le fichier journal catalina.out sur une instance Ubuntu, veillez à ce que le certificat SSL dans le paquet S3 du déploiement soit valide et au 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 journal ?
Si ce message apparaît dans le fichier journal 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.
Vous avez un commentaire à formuler concernant cette rubrique ?