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 susceptibles de se produire avec chaque type d’option de déploiement.
Résoudre les problèmes sur ArcGIS Enterprise Cloud Builder for Amazon Web Services
Le dossier Logs de l’emplacement dans lequel vous avez extrait ArcGIS Enterprise Cloud Builder for Amazon Web Services et les fichiers 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.
Dépanner 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 est 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é.) See ’c:\\chef\chef-run.log’ for details’ (Voir ‘c:\\chef\chef-run.log’ pour plus de détails’), vérifiez les journaux AWS 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.
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.
Vous devez placer les fichiers de configuration JSON dans le dossier Configuration ou l’un de ses sous-dossiers. Si votre fichier de configuration ne se trouvait pas dans cet emplacement, déplacez-le vers le dossier Configuration et réexécutez 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éé lors de l’utilisation 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 "Default" et placer un nœud "Server" vide dans le fichier de configuration. Le cas échéant, l’utilitaire ArcGIS GIS Server ne crée pas le site.
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
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 Evénements vous permettent souvent d'en comprendre la raison.
Les modèles Esri CloudFormation 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 lors du lancement à partir d’un modèle Esri, 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 avec le lancement d'une instance, la création d'un groupe de journaux n'est pas garantie.
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 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 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 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 ?