Dispone de muchos métodos para implementar ArcGIS Enterprise y ArcGIS Server en AWS. En este tema se describe cómo resolver los problemas que puede encontrarse con cada tipo de opción de implementación.
Solución de problemas de ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services
Existen dos carpetas en la carpeta Logs, en la ubicación de la que extrajo la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS y los archivos.
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.
- 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. Lea estos registros de errores para una solución eficaz de problemas.
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>.
Debe guardar los archivos de configuración JSON en la carpeta Configuration o en una de sus subcarpetas. Si su archivo de configuración no estaba en esta ubicación, muévalo a 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 depósito de 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 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 "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 de la creación de la pila 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 la pila. Inicie sesión en la consola de AWS CloudFormation (que forma parte de la Consola de administración de AWS) y abra la pestaña Events para buscar información sobre la creación de la pila, las actualizaciones y las eliminaciones. Si la pila no se crea, la información de la pestaña Events da normalmente una idea de lo que ha salido mal.
Las plantillas de CloudFormation de Esri también crean archivos de registro en los equipos virtuales para ayudarle a solucionar problemas. Para asegurarse de que los archivos se van a conservar incluso cuando falle el inicio de la implementación, inicie sesión en la Consola de AWS CloudFormation y deshabilite la reversión en caso de error.
Si la implementación falla al iniciarse desde una plantilla de Esri, cree una conexión de escritorio remota o SSH a la instancia de 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 de la secuencia de comandos 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 de la secuencia de comandos 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 la pila de CloudFormation se completa correctamente, los parámetros de salida de la pila proporcionan un vínculo al grupo de registro de la Consola de administración de AWS. Si la creación de la pila falla, vaya a la lista Resources de CloudFormation de la Consola de administración de AWS para buscar el grupo de registros. Si el fallo de creación de la pila falla antes de que se inicie una instancia, es posible que no se cree un grupo de registros.
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 EC2, indicando 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 circunvalar 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 depósito de S3 de la implementación sea correcto y que el nombre de la clave del objeto 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 que aparece 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 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 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.
Solución de problemas con la Consola de administración de AWS
Es posible que aparezca alguno de los siguientes mensajes de error al utilizar la Consola de administración de AWS 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 una 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 una sesión cambie la contraseña de Administrador por otra que pueda recordar más fácilmente.
En la Consola de administración de AWS aparece un mensaje indicando que mi instancia está prevista programada para ser retirada. ¿Qué significa esto?
Es posible que aparezca este mensaje si la instancia se está ejecutando en un hardware degradado que Amazon necesite reemplazar. Si aparece este mensaje, debe detener el sitio y reiniciarlo.
Recuerde que si ha usado ArcGIS Server Cloud Builder on Amazon Web Services para crear el sitio, deberá utilizar Cloud Builder para detener e iniciar el sitio.
Después de reiniciar el sitio, el mensaje debería desaparecer.
Solución de problemas de ArcGIS Server Cloud Builder on Amazon Web Services
Si tiene algún problema al utilizar ArcGIS Server Cloud Builder on Amazon Web Services, puede crear un archivo de texto que capture registros de errores y otra información para ayudarle a solucionar el problema.
Siga estos pasos para habilitar el nivel de registro de depuración en ArcGIS Server Cloud Builder on Amazon Web Services:
- Si se está ejecutando ArcGIS Server Cloud Builder on Amazon Web Services, ciérrelo.
- Cree un archivo de texto sin formato denominado loglevel en la carpeta %USERPROFILE%\documents\ArcGISCloudBuilder en el equipo en que está instalado ArcGIS Server Cloud Builder on Amazon Web Services.
No incluya la extensión en el nombre de archivo; por ejemplo, el archivo tiene que denominarse loglevel y no loglevel.txt.
- Abra el archivo en un editor de texto y escriba DEBUG en la primera línea.
- Guarde y cierre el archivo
- Reinicie ArcGIS Server Cloud Builder on Amazon Web Services y repita los pasos que le llevaron al problema que está intentando solucionar.
Los registros de nivel de depuración se escribirán ahora en un archivo de registro. Cuando ArcGIS Server Cloud Builder on Amazon Web Services escriba en el archivo de registro, el nombre de archivo tendrá anexada la fecha al final con el formato AAAA-MM-DD.
Cada día que se utiliza ArcGIS Server Cloud Builder on Amazon Web Services se escribe un nuevo archivo de registro. Asegúrese de eliminar los archivos de registro antiguos.
Errores encontrados al usar ArcGIS Server Cloud Builder on Amazon Web Services
A continuación se muestran varios mensajes o problemas habituales que puede encontrarse al crear un sitio de ArcGIS Server utilizando ArcGIS Server Cloud Builder on Amazon Web Services, además de sugerencias sobre cómo corregirlos.
¿Por qué no puedo establecer una conexión de escritorio remoto con el sitio de ArcGIS Server que acabo de crear en Windows?
En primer lugar, espere algún tiempo hasta que el sitio se inicie. Si ha utilizado ArcGIS Server Cloud Builder on Amazon Web Services para crear el sitio, espere hasta que aparezca toda la información sobre el sitio en la ventana Mis sitios y hasta que vea los botones utilizados para detener, actualizar y eliminar un sitio.
Si ha iniciado el sitio usando la Consola de administración de AWS o una plantilla de CloudFormation, haga clic con el botón derecho en la instancia en la Consola de administración de AWS y haga clic en Obtener registro del sistema. Cuando aparezca el mensaje indicando que Windows está listo para ser utilizado, espere 5 minutos más antes de intentar iniciar sesión.
A continuación, asegúrese de que ha agregado al grupo de seguridad del sitio una regla que permita las conexiones de escritorio remoto a través del puerto 3389. Este procedimiento se describe en Abrir un grupo de seguridad de Amazon EC2 para ArcGIS.
ArcGIS Server Cloud Builder on Amazon Web Services muestra el siguiente mensaje después de iniciar sesión: No ha sido posible obtener una lista de plantillas de configuración personalizadas. Prohibido. ¿Qué significa esto?
Aunque este mensaje puede deberse a diversas causas, suele aparecer cuando el sistema está desincronizado con la hora actual real. Por ejemplo, si vive en una región en la que la hora se adelanta durante los meses de verano y el reloj de su equipo no está sincronizado con este cambio, ArcGIS Server Cloud Builder on Amazon Web Services no puede ejecutar determinadas acciones con Amazon EC2.