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 producen cuando ejecuta 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 error para obtener una solución eficaz a los 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 la 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 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 introducidos a medida que utiliza la aplicación. La información adicional está disponible en las ubicaciones del archivo de registro mencionadas 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 ve un error genérico, como Se recibió señal de FALLO con UniqueId <unique-id>, 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 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 recurrente a las carpetas Logs y Output. Compruebe que se hayan concedido estos permisos.
Recibo el mensaje No se puede encontrar el archivo <nombre_archivo>.
Debe colocar los archivos de configuración JSON de la carpeta Configuration o de 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.
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 depósito 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 depósito.
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 ha 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 deArcGIS 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 permite hacerse una idea 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.
Cuando crea una implementación con plantillas de CloudFormation proporcionadas por Esri, todos los registros de implementación se exportan al servicio de registro de Amazon CloudWatch. Consulte las instrucciones de la sección Visualizar registros de la consola CloudWatch de Ver registros de AWS CodeDeploy en la consola de Amazon CloudWatch en la Ayuda de AWS para obtener información sobre la visualización de los registros de implementación.
Los registros de implementación se almacenan como un grupo de registros en el servicio de registros de Amazon CloudWatch. En el grupo de registros, encontrará varias secuencias de registros con nombres que terminan en /stderr y /stdout. Consulte todas las secuencias de registros para averiguar la causa del fallo.
Estos registros también se almacenan en la instancia de EC2. En las instancias de Microsoft Windows, puede encontrar estos registros en la carpeta C:\cinc. En las instancias de Ubuntu Server, puede encontrar estos registros en el directorio /var/logs.
¿Dónde puedo encontrar los registros de CloudWatch para implementaciones que he 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.
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 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 depósito 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 de registro?
Si ve este mensaje en el archivo de registro 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 Esri Amazon Machine Images 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.