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 que vous créez à l’aide des modèles CloudFormation fournis par Esri comportent une option de restauration en cas d’échec qui est activée. Lorsque l’option est activée, toutes les machines virtuelles du déploiement sont préservées même en cas d’échec du lancement de déploiement. Cette option contribue à résoudre les problèmes. Toutefois, si cette fonction ne présente pas d’intérêt à vos yeux, vous pouvez vous connecter à la console AWS CloudFormation et désactiver l’option Rollback on failure (Restauration 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. Vous trouverez ci-dessous une synthèse des modalités d’affichage des journaux relatifs au déploiement :
- Connectez-vous à la console AWS CloudFormation et accédez au service CloudFormation.
- Cliquez sur la pile CloudFormation dont vous voulez afficher les journaux.
- Cliquez sur l’onglet Resources (Ressources) et recherchez l’ID logique DeploymentLogs.
- Cliquez sur lien du journal de déploiement (Physical Log ID [ID de journal physique]) figurant à côté de DeploymentLogs.
Le lien ouvre les journaux CloudWatch dans un nouvel onglet du navigateur.
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.
Pour plus d’informations sur la consultation des journaux de déploiement, reportez-vous aux instructions figurant dans la section View logs in the CloudWatch console (Afficher les journaux dans la console CloudWatch) de la page Afficher les journaux CodeDeploy AWS dans la console Amazon CloudWatch, dans l’aide sur AWS.
Conseil :
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 le résumé ci-dessus et la section View CloudFormation Logs in the 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 ?