La plantilla de Esri arcgis-enterprise-ha-upgrade.template.json Amazon Web Services (AWS) CloudFormation actualiza una implementación base de ArcGIS Enterprise 10.9, 10.9.1, 11.0 o 11.1 de alta disponibilidad en dos instancias de Amazon Elastic Compute Cloud (EC2) más una instancia de EC2 para un servidor de archivos que haya creado con la plantilla descrita en Implementar componentes de alta disponibilidad de ArcGIS Enterprise mediante CloudFormation.
La plantilla de arcgis-enterprise-ha-upgrade.template.json actualiza los productos siguientes en dos instancias de EC2 idénticas:
- Portal for ArcGIS
- ArcGIS Server
- ArcGIS Web Adaptor
- ArcGIS Data Store
Requisitos previos
Los requisitos previos se pueden agrupar por elementos (como archivos y cuentas) que debe obtener y las tareas que debe realizar antes de ejecutar la plantilla de CloudFormation.
Elementos requeridos
Antes de ejecutar esta plantilla, necesitará lo siguiente:
- Una cuenta de Amazon Web Services con acceso a la implementación que se va a actualizar.
- Licencias de Esri. Archivos de licencia para Portal for ArcGIS, ArcGIS GIS Server y cualquier rol de licenciamiento de ArcGIS Server que tenga además de la implementación base. Todos los archivos de licencia deben ser de la misma versión de ArcGIS.
- Uno o varios archivos de certificado SSL (en formato .pfx) y las contraseñas correspondientes. Los certificados deben provenir de una autoridad de certificación.
- Una implementación base de ArcGIS Enterprise de alta disponibilidad que haya creado utilizando la plantilla de Esri Amazon Web Services CloudFormation arcgis-enterprise-ha.template.json.
- La plantilla de actualización de CloudFormation, arcgis-enterprise-ha-upgrade.template.json.
Nota:
Para actualizar su implementación, ejecute esta plantilla de actualización de CloudFormation, que creará una nueva pila de CloudFormation. No actualice la pila de CloudFormation de la implementación existente mediante esta plantilla.
Tareas requeridas
Complete las siguientes tareas antes de ejecutar esta plantilla:
- Prepare un bucket de implementación de Amazon Simple Storage Service (S3) en su cuenta de AWS. Especificará el nombre del bucket en la plantilla cuando inicie la pila.
- Cree un bucket o utilice un bucket existente de S3. Usted debe ser propietario del bucket.
- Cargue sus archivos de autorización de software de ArcGIS en el bucket.
- Cargue su archivo de certificado SSL en el bucket de implementación.
- Configure contraseñas en AWS Secrets Manager (opcional pero recomendable).
Puede configurar las contraseñas de las cuentas como el nombre de usuario del administrador del sitio y la contraseña de usuario de Windows arcgis en AWS Secrets Manager. Con ello, obtendrá un Amazon Resource Name (ARN) secreto. Utilice ARN en lugar de una contraseña en los parámetros de la plantilla al iniciar una pila. Si no utiliza AWS Secrets Manager para almacenar contraseñas, debe escribir contraseñas en texto sin formato en el parámetro de plantilla al iniciar la pila.
Nota:
Al crear un ARN secreto en AWS Secrets Manager para una contraseña que se utilizará con las plantillas de Esri CloudFormation, debe utilizar el tipo de secreto Otros tipos de secretos y utilizar la opción Texto sin formato. Para obtener más información acerca de cómo crear un Amazon Resource Name para contraseñas, consulte AWS CloudFormation y ArcGIS.
Sugerencia:
De forma predeterminada, CloudFormation elimina los recursos creados parcialmente si se produce un error en la creación de la pila. Resulta útil porque elimina las implementaciones inutilizables de su cuenta, pero puede dificultar la solución de problemas. Para conservar la pila en su estado fallido, deshabilite la opción de creación de pila de CloudFormation Reversión en caso de error antes de iniciar la pila. Consulte Configurar las opciones de AWS CloudFormation en la ayuda de AWS para obtener más información.
Parámetros
La siguiente tabla contiene los parámetros utilizados en esta plantilla y una descripción de cada parámetro.
ArcGIS Enterprise Configuration
| Nombre del parámetro | Necesario o no | Descripción del parámetro |
|---|---|---|
Platform Type | Requerido | Elija el tipo de plataforma de su implementación existente de ArcGIS Enterprise.
|
Primary ArcGIS Enterprise EC2 Instance ID | Requerido | Elija el Id. de la instancia de EC2 principal en su implementación de ArcGIS Enterprise existente. Si creó la implementación existente con una plantilla Esri CloudFormation o ArcGIS Enterprise Cloud Builder for AWS, puede encontrar el Id. de instancia en la sección Recursos de la pila existente de CloudFormation en AWS Management Console. El Id. lógico del recurso es ArcGISEnterprisePrimaryEC2Instance. |
Standby ArcGIS Enterprise EC2 Instance ID | Requerido | Elija el Id. de la instancia de EC2 en espera en su implementación de ArcGIS Enterprise existente. Si creó la implementación existente con una plantilla Esri CloudFormation o ArcGIS Enterprise Cloud Builder for AWS, puede encontrar el Id. de instancia en la sección Recursos de la pila existente de CloudFormation en AWS Management Console. El Id. lógico del recurso es ArcGISEnterpriseStandbyEC2Instance. |
Deployment Bucket Name | Requerido | Proporcione el nombre del bucket de Amazon S3 que contiene sus archivos de licencia de software y certificados SSL. Este bucket ya debe existir y contener el archivo de licencia y el certificado SSL para su implementación. Usted debe ser el propietario del bucket y este debe residir en la misma cuenta de AWS que su implementación. |
Portal License File Name | Requerido | Proporcione el nombre de clave de objeto del archivo de autorización Portal for ArcGIS. Debe cargar el archivo de licencia (archivo .json) en el bucket de implementación antes de iniciar esta pila. Puede obtener el nombre de clave del objeto de archivo yendo al archivo en el bucket de implementación en la consola AWS S3, por ejemplo, portal.json o resources/licenses/portal/portal.json. Los nombres de archivo de licencia distinguen entre mayúsculas y minúsculas. Asegúrese de haber escrito el nombre y las mayúsculas correctamente. |
Server License File Name | Requerido | Proporcione el nombre de clave de objeto del archivo de autorización ArcGIS Server. Debe cargar el archivo de licencia de (.ecp o .prvc) en el bucket de implementación antes de iniciar esta pila. Para obtener el nombre de clave del objeto de archivo, busque el archivo en el bucket de implementación en la consola Amazon S3, por ejemplo, server.prvc o resources/licenses/server/server.prvc. Debe usar una licencia ArcGIS GIS Server porque se utilizará para obtener una licencia para el servidor de alojamiento. Los nombres de archivo de licencia distinguen entre mayúsculas y minúsculas. Asegúrese de haber escrito correctamente el nombre. |
Domain Name | Requerido | Proporcione el nombre de dominio totalmente calificado de su implementación existente de ArcGIS Enterprise. |
Portal and Server Administrator User Name | Requerido | Proporcione un nombre de usuario para el administrador inicial del portal y el administrador principal del sitio de ArcGIS Server de su implementación existente. |
Portal and Server Administrator User Password | Requerido | Proporcione una contraseña para el administrador inicial del portal y el administrador principal del sitio de ArcGIS Server de su implementación existente. Puede escribir una contraseña de texto sin formato o el ARN de su Id. secreto desde AWS Secrets Manager. |
Windows arcgis user password | Condicional | Esta contraseña solo es necesaria si implementó en Windows. Proporcione la contraseña del usuario arcgis de su implementación existente. Puede introducir una contraseña de texto sin formato o el ARN de su Id. secreto desde AWS Secrets Manager. Se recomienda administrar sus contraseñas en AWS Secrets Manager. Para obtener información acerca de cómo crear un Amazon Resource Name para contraseñas, consulte AWS CloudFormation y ArcGIS. |
Portal Web Adaptor Name | Requerido | Proporcione el nombre del Web Adaptor de Portal for ArcGIS de su implementación existente de ArcGIS Enterprise. |
Server Web Adaptor Name | Requerido | Proporcione el nombre del Web Adaptor de ArcGIS Server de su implementación existente de ArcGIS Enterprise. |
SSL Certificate File Name | Requerido | Proporcione un certificado SSL de una autoridad de certificación (archivo .pfx). Utilice el mismo certificado SSL (o una renovación) utilizado cuando creó su implementación existente. Debe cargar el certificado en el bucket de implementación antes de iniciar esta pila. Puede obtener el nombre de clave del objeto de archivo yendo al archivo en el bucket de implementación en la consola AWS S3, por ejemplo, domainname.pfx o resources/sslcerts/domainname.pfx. |
SSL Certificate Password | Requerido | Proporcione una contraseña para el certificado SSL. Puede escribir una contraseña de texto sin formato o el ARN de su Id. secreto desde AWS Secrets Manager. Para obtener información acerca de cómo crear un Amazon Resource Name para contraseñas, consulte AWS CloudFormation y ArcGIS. |
Salidas
Cuando su pila se crea correctamente, puede ver los siguientes parámetros de salida en la pestaña Salidas de la pila CloudFormation en AWS Management Console.
| Nombre de salida | Descripción de salida |
|---|---|
PortalHomeAppURL | La URL para acceder al portal. |
ServerManagerDirURL | La dirección URL de ArcGIS Server Manager. |
ServerRestDirURL | La dirección URL de los servicios REST de ArcGIS Server. |
DeploymentLogsURL | Esta es la dirección URL de los registros de Amazon CloudWatch en los que se almacenan todos los registros de implementación. Puede consultar estos registros para solucionar problemas si falla su implementación. |
Consideraciones
Estos son puntos importantes a tener en cuenta después de crear una pila de CloudFormation que contenga implementaciones de ArcGIS:
- Una vez que la pila se haya creado correctamente (en otras palabras, el estado de la pila sea CREATE_COMPLETE), significa que la implementación de ArcGIS Enterprise se ha actualizado correctamente. Puede validarlo iniciando sesión en el sitio web del portal, ArcGIS Server Manager para el servidor de alojamiento o el directorio de servicios REST.
- Si la pila de CloudFormation no se pudo crear correctamente (en otras palabras, el estado de la pila sea CREATE_FAILED), puede solucionar el error como se menciona en la página vinculada en la sección Solucionar problemas que aparece a continuación. Después de localizar la causa raíz del error y realizar la acción requerida, puede eliminar la pila fallida y crear una nueva para actualizar la implementación de ArcGIS Enterprise existente.
- Si recibe una notificación relativa a las licencias cuando inicie sesión en el portal después de una actualización, puede que no haya importado un archivo de licencia que cumpla la configuración de licenciamiento actual o puede que se haya asignado un tipo de usuario temporal a los usuarios. Consulte Consideraciones después de actualizar Portal for ArcGIS en la guía de instalación de Portal for ArcGIS.
Solucionar problemas
Si observa algún fallo al crear esta pila de CloudFormation, consulte Solucionar problemas de implementaciones de ArcGIS en AWS.