Dispone de muchos métodos para implementar ArcGIS Enterprise y ArcGIS Server en Amazon Web Services (AWS). En este tema se describe cómo resolver los problemas que puede encontrarse con cada opción de implementación.
Solución de problemas de ArcGIS Enterprise Cloud Builder for Amazon Web Services
Existen dos carpetas en la carpeta Logs en la ubicación de la que extrajo ArcGIS Enterprise Cloud Builder for Amazon Web Services y sus archivos asociados.
La carpeta Logs contiene estas dos subcarpetas:
- Log: esta carpeta contiene los registros de consola, que se crean cada vez que se ejecuta la utilidad. La carpeta Log también contiene los registros de evento de CloudFormation para cada pila que cree como parte de la implementación cada vez que se ejecuta el comando CREATE con la utilidad de ArcGIS Enterprise Cloud Builder CLI for AWS o agrega una implementación a la aplicación ArcGIS Enterprise Cloud Builder for Amazon Web Services.
- ErrorLog: esta carpeta contiene los archivos de registro para registrar los errores que se produzcan al ejecutar la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS o la aplicación ArcGIS Enterprise Cloud Builder for Amazon Web Services. Lea estos registros de errores para una solución eficaz de problemas.
Consulte las dos secciones siguientes para obtener información sobre errores específicos que podría encontrarse al ejecutar la aplicación Cloud Builder o utilidad ArcGIS Enterprise Cloud Builder CLI for AWS. La aplicación y la utilidad inician pilas de CloudFormation, por lo que siempre debe leer la sección en solucionar problemas de la creación de la pila de CloudFormation como ayuda para identificar y corregir problemas de la implementación.
Errores encontrados al ejecutar la aplicación ArcGIS Enterprise Cloud Builder for Amazon Web Services
La aplicación ArcGIS Enterprise Cloud Builder for Amazon Web Services valida muchos de los valores que proporciona a medida que utiliza la aplicación. Hay información adicional disponible en las ubicaciones de los archivos de registro mencionados en la sección anterior.
Recibo un mensaje que me indica que mi nombre de dominio no es válido.
Existen varias razones por las que Cloud Builder no puede validar su nombre de dominio, pero la causa más probable está relacionada con la falta o la incorrección de una asignación del nombre de dominio en su servidor de nombre de dominio (DNS). Por ejemplo, es posible que el nombre de dominio no se haya asignado en su DNS o no se haya asignado correctamente.
Asegúrese de que el nombre de dominio proporcionado resuelve a CNAME o un registro de su DNS. Para comprobar si el nombre de dominio proporcionado en Cloud Builder se ha asignado correctamente, utilice el comando nslookup en una ventana de comando de Microsoft Windows del mismo equipo en el que va a ejecutar la aplicación Cloud Builder.
Si piensa que su asignación de nombre de dominio es correcta, intente borrar la caché DNS local del equipo en el que va a ejecutar Cloud Builder y, a continuación, valide de nuevo el nombre de dominio de la aplicación Cloud Builder.
Si su nombre de dominio aún no se valida, póngase en contacto con su administrador de TI para obtener más soporte.
Error al crear Mi implementación.
Si la aplicación Cloud Builder no puede crear su implementación, se muestran mensajes de error en la página de finalización del trabajo Cloud Builder. Puede consultar más detalles sobre los errores haciendo clic en Visualizar registro del proceso y Visualizar registro de errores en la página de finalización del trabajo.
Si visualiza un error genérico, como Condición de espera recibió un mensaje de error: 'Error en la ejecución de Chef. Consulte 'c:\\chef\chef-run.log' para obtener más información', compruebe los registros de Amazon CloudWatch haciendo clic en las URL de registro de la sección Visualizar registros de AWS CloudWatch de la página de resumen de Cloud Builder. Así se abre el registro de CloudWatch adecuado en su navegador web predeterminado, en el que puede visualizar los registros de cada instancia de Amazon Elastic Compute Cloud (EC2) de su implementación y determinar el motivo del error.
Una vez que haya determinado qué causó el error, puede hacer clic en Atrás en la aplicación Cloud Builder para arreglar el parámetro requerido y volver a intentar crear la implementación. Alternativamente, puede eliminar la implementación fallida y crear una nueva.
La aplicación ArcGIS Enterprise Cloud Builder for Amazon Web Services se bloquea continuamente y devuelve un error que indica que ArcGIS Enterprise Cloud Builder for AWS ha dejado de funcionar
Si la aplicación ArcGIS Enterprise Cloud Builder for Amazon Web Services se bloquea y devuelve el siguiente mensaje de error: ArcGIS Enterprise Cloud Builder for AWS ha dejado de funcionar. Un problema ha provocado que el programa deje de funcionar correctamente. Windows cerrará el programa y le notificará si hay una solución disponible., es probable que a su equipo le falte el paquete de Microsoft Visual C++ Redistributable requerido. Consulte Requisitos previos de Cloud Builder para obtener más información y un vínculo para descargar el paquete.
¿Dónde puedo encontrar los registros de CloudWatch para implementaciones que haya creado usando la aplicación ArcGIS Enterprise Cloud Builder for Amazon Web Services?
Si la aplicación Cloud Builder no puede crear su implementación, se muestran mensajes de error en la página de finalización del trabajo. Puede ver más detalles sobre los errores haciendo clic en Visualizar registro del proceso y Visualizar registro de errores en la página de finalización del trabajo.
Errores encontrados al usar la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS
A continuación se muestran varios mensajes o problemas habituales que puede encontrarse al usar la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS, además de sugerencias sobre cómo corregirlos.
Recibo un error de permisos.
El usuario que ejecuta la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS debe tener acceso de escritura recursivo a las carpetas Logs y Output. Compruebe que se hayan concedido estos permisos.
Recibo el mensaje No se puede encontrar el archivo <nombre_archivo>.
Empezando con 10.8.1, debe colocar los archivos de configuración JSON en la carpeta Configuration o en una de sus subcarpetas en su directorio de trabajo; no coloque los archivos de configuración JSON en la carpeta Configuration disponible en el directorio de instalación. Si sus archivos de configuración no estuvieran en la carpeta Configuration en su directorio de trabajo, mueva los archivos aquí y vuelva a ejecutar la utilidad.
Para 10.8 y anteriores, debe colocar los archivos de configuración JSON en la carpeta Configuration o en una de sus subcarpetas en el directorio de instalación. Si sus archivos de configuración no estuvieran en esta ubicación, muévalos a la carpeta Configuration y vuelva a ejecutar la utilidad.
Recibo el mensaje Extensión de archivo de configuración de implementación no válida. Debe ser '.json'.
El archivo de configuración que utilice debe tener la extensión .json. De no ser así, cámbiele el nombre para incluir esta extensión de archivo y vuelva a ejecutar la utilidad.
Recibo el mensaje Formato JSON no válido para el archivo <nombre_archivo>.
Asegúrese de que el archivo de configuración contenga un formato JSON válido.
Sugerencia:
Puede utilizar un validador de JSON, por ejemplo JSONLint, para validar el formato.
Recibo el mensaje Error al acceder a la cuenta de AWS con las credenciales proporcionadas.
Asegúrese de haber introducido las credenciales de AWS válidas en el archivo de configuración JSON para que la utilidad se pueda conectar a AWS. Si las credenciales son válidas, asegúrese de que su cuenta sea accesible desde el equipo en el que ejecuta la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS.
Recibo un mensaje de error de acceso denegado cuando ejecuto la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS con el comando PREP.
Si utiliza un bucket de Amazon Simple Storage Service (S3) para sus archivos de implementación, asegúrese de contar con los permisos adecuados para acceder a y escribir en el bucket.
Cuando abro el archivo de salida después de ejecutar la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS con el comando CREATE, no veo todos los componentes que esperaba.
El archivo de salida creado con el comando CREATE contiene encabezados para cada componente que la utilidad haya creado en AWS. Estos encabezados corresponden a los nodos que usted incluyó en su archivo de configuración JSON. Los nodos del archivo de configuración le indican a la utilidad los componentes que debe de crear. Si excluye algún nodo del archivo de configuración, la utilidad no creará ese componente.
Cada nodo que incluya en el archivo de configuración debe contener al menos un parámetro. Incluso si configura todos los parámetros en el nodo "Default", debe incluir un nodo para cada parte de la implementación que desee crear, y ese nodo debe contener al menos un parámetro y un valor. Si un nodo aparece en el archivo de configuración, pero no incluye ningún parámetro, la utilidad omite ese nodo. Por ejemplo, no puede configurar parámetros para un sitio de ArcGIS GIS Server en el nodo "Default" y colocar un nodo "Server" vacío en el archivo de configuración. Si lo hace, la utilidad no creará el sitio de ArcGIS GIS Server.
Revise el archivo de configuración para asegurarse de haber agregado todos los nodos necesarios y al menos un parámetro para cada componente de la implementación. Consulte Parámetros de ArcGIS Enterprise Cloud Builder CLI for AWS para obtener una lista de los parámetros necesarios para cada nodo del archivo de configuración.
Cuando ejecuto la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS, parece que la línea de comandos deja de funcionar.
Si descubre que la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS o cualquier otra utilidad que ejecute en una ventana de comandos de Microsoft Windows deja de funcionar, deshabilite el modo QuickEdit en la ventana de comandos.
Solución de problemas con la creación de pilas de AWS CloudFormation
Las herramientas de implementación de ArcGIS Enterprise on Amazon Web Services crean pilas de AWS CloudFormation. Use la Consola de AWS CloudFormation para supervisar el estado de la pila de AWS CloudFormation y detectar si se produce algún error en la creación de pilas. Inicie sesión en la consola de AWS CloudFormation (que forma parte de AWS Management Console) y abra la pestaña Eventos para buscar información sobre la creación de pilas, las actualizaciones y las eliminaciones. Si la pila no se crea, la información de la pestaña Eventos suele dar una idea general de lo que ha salido mal.
Las herramientas de implementación de ArcGIS Enterprise on Amazon Web Services también crean archivos de registro en equipos virtuales para ayudarle a solucionar problemas. Para asegurarse de que los archivos se van a conservar incluso cuando la implementación falla al iniciarse, inicie sesión en la consola de AWS CloudFormation y deshabilite la opción Reversión en caso de error.
Si la implementación falla al iniciarse desde una herramienta de implementación de ArcGIS Enterprise on Amazon Web Services, cree una conexión a escritorio remoto o SSH a la instancia de Amazon Elastic Compute Cloud (EC2) para ver los registros. Los tipos y las ubicaciones de los archivos de registro se indican en la siguiente tabla:
| Tipo de instancia de EC2 | Archivo de registro y ubicación en la instancia de EC2 | Descripción del archivo de registro |
|---|---|---|
Ubuntu | /var/log/cfn-init.log | Archivo de registro del script del asistente de CloudFormation para recuperar e interpretar los metadatos del recurso, instalar paquetes, crear archivos e iniciar servicios |
/var/log/chef-run.log | Archivo de registro de la herramienta de administración de la configuración de Chef | |
/var/lib/tomcat7/logs/catalina.out | Archivo de registro del servidor de aplicaciones de Apache Tomcat | |
Windows | C:\cfn\log\cfn-init.log | Archivo de registro del script del asistente de CloudFormation para recuperar e interpretar los metadatos del recurso, instalar paquetes, crear archivos e iniciar servicios |
C:\chef\chef-run.log | Archivo de registro de la herramienta de administración de la configuración de Chef |
Nota:
Si la creación de pilas de CloudFormation se completa correctamente, los parámetros de salida de la pila proporcionan un vínculo al grupo de registro de AWS Management Console. Si la creación de pilas falla, vaya a la lista Resources de CloudFormation de la AWS Management Console para buscar el grupo de registros. Si la creación de la pila falla antes de que se inicie una instancia, es posible que no se cree un grupo de registros.
¿Dónde puedo encontrar los registros de CloudWatch para implementaciones que haya creado usando herramientas de implementación de ArcGIS Enterprise on Amazon Web Services?
Para acceder a los registros de CloudWatch para implementaciones que haya creado con herramientas de implementación de ArcGIS Enterprise on Amazon Web Services, inicie sesión en la consola de CloudFormation, que forma parte de AWS Management Console. Consulte Visualizar registros de CloudFormation en la consola en el sitio web de AWS.
¿Por qué no puedo encontrar los registros de CloudWatch para la implementación que he creado usando herramientas de implementación de ArcGIS Enterprise on Amazon Web Services?
Comenzando con 10.8.1, ArcGIS Enterprise Cloud Builder for AWS utiliza la versión 2 (V2) del servicio de metadatos de instancia (IMDS) de Amazon al crear implementaciones. Empezando con 10.8.1, las plantillas de Esri CloudFormation también utilizan IMDS V2 de forma predeterminada. Actualmente, el agente de registro de CloudWatch AWS que se instala en instancias de EC2 no es compatible con IMDS V2. Se trata de una limitación conocida.
Hasta que AWS corrija esta limitación, debe hacer lo siguiente si su pila no se inicia y desea ver registros para la solución de problemas:
- Inicie sesión en la consola de CloudFormation en AWS Management Console.
- Acceda a la pila de CloudFormation que falló y active la pestaña Eventos para encontrar el motivo del fallo.
- Si viera un mensaje similar a Señal de FALLO recibida con Id. único<instanceid>, utilice el escritorio remoto o SSH y el Id. de la instancia del mensaje para acceder a la instancia de EC2 afectada.
- Compruebe los registros de Chef para identificar por qué motivo no se inició la pila. Puede encontrar registros de Chef en una de las siguientes ubicaciones, en función del sistema operativo de la instancia de EC2:
- Microsoft Windows: C:\chef\chef-run.log
- Ubuntu: /var/log/chef-run.log
Sugerencia:
Si utiliza plantillas de CloudFormation de Esri para su nueva implementación, utilice IMDS versión 1 (V1) y, por lo tanto, evite la limitación conocida del agente de registro de CloudWatch. No obstante, ya que IMDS V1 es menos segura que IMDS V2, esta no es una alternativa recomendada.
Errores encontrados al iniciar una pila de AWS CloudFormation
A continuación, se muestran varios mensajes o problemas habituales que puede encontrarse al realizar implementaciones con una plantilla de AWS CloudFormation, además de sugerencias sobre cómo corregirlos.
¿Por qué aparece un error de memoria insuficiente al hacer clic en Iniciar para iniciar una instancia?
Se trata de un error de Amazon Elastic Compute Cloud que indica que no tiene capacidad disponible para satisfacer su petición de una nueva instancia. Si la arquitectura de la implementación lo permite, deberá poder abordar este error solicitando una instancia en una zona de disponibilidad diferente, o bien dejando que EC2 seleccione automáticamente la zona. Otras opciones consisten en intentar iniciar un tamaño diferente de la instancia, o esperar a iniciarla más tarde.
¿Qué significa el mensaje Error encontrado al crear la configuración: Imposible recuperar https:// .s3.amazonaws.com/ en cfn-init.log?
Si ve este mensaje en el archivo cfn-init.log, asegúrese de que el nombre del bucket de S3 de la implementación sea correcto y que el nombre de la clave del objeto de S3 de los archivos de autorización y los certificados SSL sea correcto.
¿Qué significa el mensaje No se pudo conectar a la URL de WebAdaptor https://agsportalssl.esri.com/server/webadaptor en el archivo de registro de catalina.out?
Si ve este mensaje en el archivo de registro de catalina.out de una instancia de Ubuntu, asegúrese de que el certificado SSL del bucket de S3 de la implementación sea válido y esté en formato PKCS 12. Compruebe también que la contraseña del certificado SSL proporcionada es correcta.
¿Qué significa el mensaje OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: mac verify failure que aparece en el archivo chef-run.log?
Si ve este mensaje en el archivo chef-run.log en una instancia de Windows, asegúrese de que el certificado SSL del bucket de S3 de la implementación sea válido y esté en formato PKCS 12. Compruebe también que la contraseña del certificado SSL proporcionada es correcta.
Solución de problemas de AWS Management Console
Es posible que aparezca alguno de los siguientes mensajes de error al utilizar AWS Management Console y las Amazon Machine Images de Esri para crear manualmente el sitio:
¿Por qué aparece el mensaje No se ha encontrado ninguna contraseña cuando intento recuperar la contraseña de administrador de mi instancia de EC2 en Windows?
Este mensaje puede aparecer si se intenta utilizar Obtener contraseña de Windows después de haber detenido e iniciado una instancia de EC2. Para evitar este error, la primera vez que inicie sesión cambie la contraseña de Administrador por otra que pueda recordar más fácilmente.
En AWS Management Console aparece un mensaje que indica que mi instancia tiene programada su retirada. ¿Qué significa esto?
Es posible que aparezca este mensaje si la instancia se está ejecutando en un hardware obsoleto que Amazon necesite reemplazar. Si aparece este mensaje, debe detener el sitio y reiniciarlo.
Después de reiniciar el sitio, el mensaje debería desaparecer.