Skip To Content

Обновление отказоустойчивых компонентов ArcGIS Enterprise с помощью CloudFormation

Шаблон Esri arcgis-enterprise-ha-upgrade.template.json Amazon Web Services (AWS) CloudFormation обновляет отказоустойчивое базовое развертывание ArcGIS Enterprise 10.9, 10.9.1, 11.0 или 11.1 на двух экземплярах Amazon Elastic Compute Cloud (EC2) плюс один экземпляр EC2 для файлового сервера, который вы создали с помощью шаблона, описанного в разделе Развертывание отказоустойчивых компонентов ArcGIS Enterprise с помощью CloudFormation.

Шаблон arcgis-enterprise-ha-upgrade.template.json обновляет следующие продукты на двух идентичных экземплярах:EC2:

  • Portal for ArcGIS
  • ArcGIS Server
  • ArcGIS Web Adaptor
  • ArcGIS Data Store

Предварительные условия

Предварительные требования можно сгруппировать по элементам - таким как файлы и учетные записи, которые вы должны получить, а также по задачам, которые вы должны выполнить перед запуском шаблона CloudFormation.

Обязательные элементы

Перед запуском этого шаблона у вас должно быть следующее:

  • Учетная запись Amazon Web Services с доступом к обновляемому развертыванию.
  • Лицензии Esri. Файлы лицензий Portal for ArcGIS, ArcGIS GIS Server и любые роли лицензирования ArcGIS Server, которые имеются в дополнение к базовому развертыванию. Все файлы лицензий должны относиться к одинаковой версии ArcGIS.
  • Файл сертификата или сертификаты SSL (в формате .pfx) и соответствующий пароль. Сертификаты должны быть выданы центром сертификации.
  • Существующее отказоустойчивое базовое развертывание ArcGIS Enterprise, которое вы создали с помощью шаблона Esri Amazon Web Services CloudFormation arcgis-enterprise-ha.template.json.
  • Шаблон обновления CloudFormation, arcgis-enterprise-ha-upgrade.template.json.

Примечание:

Для обновления развертывания, запустите этот шаблон обновления CloudFormation, который создаст новый стек CloudFormation. Не обновляйте имеющийся стек развертывания CloudFormation, используя этот шаблон.

Обязательные задачи

Перед запуском этого шаблона вам необходимо выполнить следующие задачи:

  • Подготовьте бакет развертывания Amazon Simple Storage Service (S3) в своей учетной записи AWS. Вы укажите имя бакета в шаблоне при запуске стека.
    1. Создайте бакет или используйте существующий бакет S3. Вы должны быть владельцем бакета.
    2. Загрузите свои файлы авторизации ПО ArcGIS в бакет.
    3. Загрузите свой файл сертификата SSL в бакет развертывания.
  • Настройте пароли в AWS Secrets Manager (не обязательно, но рекомендуется).

    Вы можете настроить пароли для учетных записей, таких как имя пользователя администратора сайта и пароль пользователя Windows arcgis в AWS Secrets Manager. При этом вам будет предоставлено секретное Amazon Resource Name (ARN). Используйте ARN вместо пароля в параметрах шаблона при запуске стека. Если вы не используете AWS Secrets Manager для хранения паролей, вы должны ввести пароли в виде простого текста в параметр шаблона при запуске стека.

    Примечание:

    При создании секретного ARN в AWS Secrets Manager для пароля, который будет использоваться в шаблонах Esri CloudFormation, вы должны использовать секретный тип Другие типы секретов и опцию Простой текст. Более подробно о создании Amazon Resource Name для паролей см. AWS CloudFormation и ArcGIS.

Подсказка:

По умолчанию CloudFormation удаляет частично созданные ресурсы в случае неудачного создания стека. Это удобно, потому что он удаляет неиспользуемые развертывания из вашей учетной записи, но это может затруднить выявление проблем. Чтобы получить стек в состоянии неудачи, отключите опцию создания стека Rollback on failure CloudFormation перед его запуском. Подробнее см. Настройка опций AWS CloudFormation в справке AWS.

Параметры

В следующей таблице содержатся параметры, используемые в этом шаблоне, и описание каждого параметра.

ArcGIS Enterprise Configuration

Имя параметраОбязательно или нетОписание параметра

Platform Type

Обязательный

Выберите тип платформы для существующего развертывания ArcGIS Enterprise.

  • Windows
  • Linux

Primary ArcGIS Enterprise EC2 Instance ID

Обязательный

Выберите ID экземпляра основного экземпляра EC2 в существующем развертывании ArcGIS Enterprise.

Если вы создали существующее развертывание с помощью шаблона Esri CloudFormation или ArcGIS Enterprise Cloud Builder for AWS, вы можете найти ID экземпляра в разделе Ресурсы существующего стека CloudFormation в AWS Management Console. Логический ID ресурса - ArcGISEnterprisePrimaryEC2Instance.

Standby ArcGIS Enterprise EC2 Instance ID

Обязательный

Выберите ID экземпляра дублирующего экземпляра EC2 в существующем развертывании ArcGIS Enterprise.

Если вы создали существующее развертывание с помощью шаблона Esri CloudFormation или ArcGIS Enterprise Cloud Builder for AWS, вы можете найти ID экземпляра в разделе Ресурсы существующего стека CloudFormation в AWS Management Console. Логический ID ресурса - ArcGISEnterpriseStandbyEC2Instance.

Deployment Bucket Name

Обязательный

Укажите имя бакета Amazon S3, в котором находятся файлы лицензий на программное обеспечение и сертификаты SSL. Этот бакет должен уже существовать и содержать файл лицензии и сертификат SSL для вашего развертывания.

Вы должны быть владельцем бакета, и она должна располагаться в той же учетной записи AWS, что и ваше развертывание.

Portal License File Name

Обязательный

Укажите имя ключа объекта файла авторизации Portal for ArcGIS. Перед запуском этого стека необходимо загрузить файл лицензии (файл .json) в бакет развертывания. Вы можете получить имя ключа объекта файла, перейдя к файлу в бакете развертывания в консоли AWS S3, например, portal.json или resources/licenses/portal/portal.json.

Имена файлов лицензии чувствительны к регистру. Убедитесь, что вы корректно ввели имя в правильном регистре.

Server License File Name

Обязательный

Укажите имя ключа объекта файла авторизации ArcGIS Server. Перед запуском этого стека необходимо загрузить файл лицензии (.ecp или .prvc) в бакет развертывания.

Чтобы получить имя ключа объекта файла, перейдите к файлу в корзине развертывания в консоли Amazon S3, например, server.prvc или resources/licenses/server/server.prvc.

Вы должны использовать лицензию ArcGIS GIS Server, потому что она будет использоваться для лицензирования хост-сервера.

Имена файлов лицензии чувствительны к регистру. Убедитесь в корректности написания имени.

Domain Name

Обязательный

Укажите полное доменное имя существующего развертывания ArcGIS Enterprise.

Portal and Server Administrator User Name

Обязательный

Укажите имя пользователя первичного администратора портала и основного администратора сайта ArcGIS Server или существующего развертывания.

Portal and Server Administrator User Password

Обязательный

Укажите пароль первичного администратора портала и основного администратора сайта ArcGIS Server или существующего развертывания.

Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager.

Windows arcgis user password

Условные

Этот пароль требуется только при развертывании на Windows. Введите пароль для пользователя arcgis вашего существующего развертывания.

Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager.

Лучше всего управлять своими паролями в AWS Secrets Manager. Более подробную информацию о создании Amazon Resource Name для паролей см. в разделе AWS CloudFormation и ArcGIS.

Portal Web Adaptor Name

Обязательный

Укажите имя Portal for ArcGIS Web Adaptor для существующего развертывания ArcGIS Enterprise.

Server Web Adaptor Name

Обязательный

Укажите имя ArcGIS Server Web Adaptor для существующего развертывания ArcGIS Enterprise.

SSL Certificate File Name

Обязательный

Предоставьте сертификат SSL от центра сертификации (файл .pfx). Используйте тот же (или обновленный) сертификат SSL, который использовался при создании существующего развертывания.

Перед запуском этого стека необходимо загрузить сертификат в бакет развертывания. Можно получить имя ключа объекта файла, перейдя к файлу в бакете развертывания в консоли AWS S3, например, domainname.pfx или resources/sslcerts/domainname.pfx.

SSL Certificate Password

Обязательный

Введите пароль для сертификата SSL. Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager. Более подробную информацию о создании Amazon Resource Name для паролей см. в разделе AWS CloudFormation и ArcGIS.

Выходные данные

Когда ваш стек будет успешно создан, вы можете увидеть следующие выходные параметры на вкладке Outputs стека CloudFormation в AWS Management Console.

Выходное имяВыходное описание

PortalHomeAppURL

URL для доступа к порталу.

ServerManagerDirURL

URL ArcGIS Server Manager.

ServerRestDirURL

URL ArcGIS Server REST сервисов.

DeploymentLogsURL

Это URL-адрес журналов Amazon CloudWatch, где хранятся все журналы развертывания. Вы можете обратиться к этим журналам для устранения неполадок в случае сбоя развертывания.

Рекомендации

Следующие моменты являются важными после создания стека CloudFormation, который содержит развертывания ArcGIS:

  • Если стек создан успешно (другими словами, статус стека - CREATE_COMPLETE), это означает, что ваше развертывание ArcGIS Enterprise успешно обновлено. Вы можете проверить это, войдя на веб-сайт портала, ArcGIS Server Manager для хост-сервера или в каталог служб REST.
  • Если не удалось создать стек CloudFormation (другими словами, состояние стека - CREATE_FAILED), вы можете устранить ошибку, как указано на странице, на которую имеется ссылка в разделе Устранение неполадок ниже. Выявив основную причину ошибки и предприняв необходимые действия, вы можете удалить отказавший стек и создать новый для обновления существующего развертывания ArcGIS Enterprise.
  • Если после обновления, при входе на портал, вы получили уведомление о лицензиях, возможно, вы не импортировали файл лицензии, соответствующий текущей конфигурации лицензирования, или вашим пользователям назначен временный тип пользователя. См. Рекомендации после обновления Portal for ArcGIS в Руководстве по установке Portal for ArcGIS.

Решение проблем

Если вы столкнулись с проблемами при создании этого стека CloudFormation, см. Решение проблем, возникающих при развертывании ArcGIS на AWS.