Plusieurs méthodes sont disponibles pour déployer ArcGIS Enterprise et ArcGIS Server sur 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 Command Line Interface for Amazon Web Services
Le dossier Logs de l’emplacement dans lequel vous avez extrait l’utilitaire et les fichiers ArcGIS Enterprise Cloud Builder CLI for AWS 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 les piles créées dans le cadre du déploiement, à chaque fois que vous exécutez la commande CREATE.
- ErrorLog : ce dossier contient des fichiers journaux répertoriant les erreurs qui se produisent lors de l’exécution de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS. Pour une résolution efficace des problèmes, consultez ces journaux.
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 informations d’identification 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 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 l'état 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 la console de gestion AWS) et ouvrez l'onglet Evénements pour trouver des informations sur la création, la mise à jour et la suppression 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 CloudFormation Esri 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 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 récupérer 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 récupérer 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 la console de gestion AWS. Si la création de la pile échoue, accédez à la liste Ressources de CloudFormation dans la console de gestion AWS 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 CloudFormation AWS
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 CloudFormation AWS, 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 d'Amazon EC2 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ésolution des problèmes liés à la console de gestion AWS
Lors de l’utilisation de la console de gestion AWS et d’AMI 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 qu'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 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 la console de gestion AWS, 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é qu'Amazon doit remplacer. Si vous voyez ce message, vous devez arrêter votre site et le redémarrer.
Sachez que si vous avez utilisé ArcGIS Server Cloud Builder on Amazon Web Services pour créer votre site, utilisez Cloud Builder pour arrêter et redémarrer le site.
Une fois que vous avez redémarré le site, le message devrait avoir disparu.
Résoudre les problèmes sur ArcGIS Server Cloud Builder on Amazon Web Services
Si vous rencontrez des problèmes lorsque vous utilisez ArcGIS Server Cloud Builder on Amazon Web Services, vous pouvez créer un fichier texte qui capture les journaux d'erreurs et d'autres informations afin de vous aider à résoudre les problèmes.
Pour activer la journalisation au niveau du débogage dans ArcGIS Server Cloud Builder on Amazon Web Services, procédez comme suit :
- Si ArcGIS Server Cloud Builder on Amazon Web Services est en cours d'exécution, fermez-le.
- Créez un fichier de texte brut nommé loglevel dans le dossier %USERPROFILE%\documents\ArcGISCloudBuilder sur la machine où ArcGIS Server Cloud Builder on Amazon Web Services est installé.
N’ajoutez aucune extension au nom de fichier ; par exemple, le nom du fichier doit être loglevel, et non loglevel.txt.
- Ouvrez le fichier dans un éditeur de texte et saisissez DEBUG sur la première ligne.
- Enregistrez et fermez le fichier.
- Redémarrez ArcGIS Server Cloud Builder on Amazon Web Services et répétez les étapes qui ont mené au problème que vous essayez de résoudre.
Des journaux de débogage seront désormais consignés dans un fichier journal. Lorsqu'ArcGIS Server Cloud Builder on Amazon Web Services écrit dans le fichier journal, la date est ajoutée à la fin du nom de fichier, au format AAA-MM-JJ.
Un nouveau fichier journal est créé chaque jour d'utilisation d'ArcGIS Server Cloud Builder on Amazon Web Services. Veillez à supprimer les anciens fichiers journaux.
Erreurs liées à l’utilisation d’ArcGIS Server Cloud Builder on Amazon Web Services
Vous trouverez ci-dessous des messages ou problèmes courants susceptibles d’être générés lorsque vous créez un site ArcGIS Server à l’aide d’ArcGIS Server Cloud Builder on Amazon Web Services, ainsi que des suggestions permettant de les résoudre.
Pourquoi ne puis-je pas établir de connexion Bureau à distance au site ArcGIS Server que je viens de créer sous Windows ?
Tout d'abord, donnez du temps au site pour qu'il se lance. Si vous avez utilisé ArcGIS Server Cloud Builder on Amazon Web Services pour créer le site, attendez que toutes les informations du site apparaissent dans la fenêtre Mes sites, et des boutons seront disponibles pour arrêter, mettre à jour et supprimer un site, par exemple.
Si vous avez lancé le site manuellement via la console de gestion AWS ou un modèle CloudFormation, cliquez avec le bouton droit sur l'instance de la console de gestion AWS, et cliquez sur Récupérer le journal système. Lorsqu'un message indiquant que Windows est prêt à être utilisé apparaît, patientez 5 autres minutes environ avant d'essayer de vous connecter.
Vérifiez ensuite que vous avez ajouté une règle au groupe de sécurité de votre site pour permettre des connexions Bureau à distance via le port 3389. Cette procédure est décrite dans la rubrique Ouvrir un groupe de sécurité Amazon EC2 pour ArcGIS.
ArcGIS Server Cloud Builder on Amazon Web Services affiche le message suivant lorsque je suis connecté : Impossible d’obtenir la liste des modèles de configuration personnalisée. Interdit. Qu\'est-ce que cela signifie ?
Bien que ce message puisse avoir de multiples causes, il semble que votre système n'est pas synchronisé sur l'heure actuelle réelle. Par exemple, si vous vivez dans une région où l’horloge avance d’une heure pendant les mois d’été, et si l’horloge de votre ordinateur n’est pas synchronisée sur ce changement, ArcGIS Server Cloud Builder on Amazon Web Services ne peut pas réaliser certaines opérations avec Amazon EC2.
Vous avez un commentaire à formuler concernant cette rubrique ?