Существует множество методов, которые вы можете использовать для развертывания ArcGIS Enterprise и ArcGIS Server на Amazon Web Services (AWS). В разделе описываются способы устранения возможных проблем, с которыми вы можете столкнуться при выполнении развертывания каждого типа.
Решение проблем ArcGIS Enterprise Cloud Builder for Amazon Web Services
Есть две папки под папкой Logs в местоположении, куда вы извлекаете утилиту ArcGIS Enterprise Cloud Builder for Amazon Web Services и ее файлы.
Папка Logs содержит следующие две подпапки:
- Log – папка содержит журналы консоли, которые создаются каждый раз при запуске утилиты. Папка Log также содержит журналы событий CloudFormation для каждой серии, которую вы создаете в развертывании каждый раз при запуске команды CREATE с утилитой ArcGIS Enterprise Cloud Builder CLI for AWS или добавлении развертывания в приложении ArcGIS Enterprise Cloud Builder for Amazon Web Services.
- ErrorLog – папка содержит файлы журнала, куда записываются ошибки, если они возникают при запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS или приложения ArcGIS Enterprise Cloud Builder for Amazon Web Services. Для эффективного устранения проблем ознакомьтесь с этими журналами.
Обратитесь к двум следующим разделам для получения информации о конкретных ошибках, с которыми вы можете столкнуться при запуске приложения Cloud Builder или утилиты ArcGIS Enterprise Cloud Builder CLI for AWS. И приложение, и утилита запускают стеки CloudFormation, поэтому обратитесь к разделу об устранении проблем при создании стека CloudFormation для идентификации и исправления проблем, связанных с развертыванием.
Ошибки, возникающие при запуске приложения ArcGIS Enterprise Cloud Builder for Amazon Web Services
Приложение ArcGIS Enterprise Cloud Builder for Amazon Web Services проверяет множество значений, которые вы указываете при работе с приложением. Дополнительная информация будет доступна в разделах файла журнала, которые упоминались в предыдущем разделе.
Я получил сообщение, что мое имя домена некорректно.
Есть несколько причин, по которым Cloud Builder не может проверить ваше доменное имя, но чаще всего это связано с пропуском или некорректным заполнением доменного имени на вашем сервере доменных имен (DNS). Например, доменное имя может быть не внесено в ваш DNS, либо записано там неправильно.
Убедитесь, что указанное вам доменное имя преобразуется в CNAME или запись A в вашем DNS. Чтобы проверить, действительно ли доменное имя, указанное в Cloud Builder, заполнено корректно, используйте команду nslookup в командной строке Microsoft Windows на том же компьютере, где запущено приложение Cloud Builder.
Если вы считаете, что доменное имя заполнено корректно, попробуйте почистить локальный кэш DNS на компьютере, где запускаете Cloud Builder, а затем снова проверьте доменное имя в приложении Cloud Builder.
Если ваше доменное имя все еще некорректно, обратитесь к своему ИТ-администратору.
Не удалось создать развертывание.
Если приложение Cloud Builder не может создать развертывание, то на странице выполнения задания Cloud Builder появятся сообщения об ошибках. Вы можете посмотреть подробные сведения об ошибках, нажав Просмотреть журнал процессов и Просмотреть журнал ошибок на странице выполнения задания.
Если вы видите общую ошибку типа Wait condition received failed message: 'Chef run failed. Изучите файл 'c:\\chef\chef-run.log' for details’, проверьте журналы Amazon CloudWatch, нажав на URL логов в разделе Просмотреть журналы AWS CloudWatch на странице с итоговой информацией Cloud Builder. При этом откроется соответствующий журнал CloudWatch в вашем веб-браузере по умолчанию, где вы сможете просмотреть журналы для каждого экземпляра Amazon Elastic Compute Cloud (EC2) в вашем развертывании и, таким образом, выявить причину ошибки.
Когда вы поймете, в чем дело, вы можете нажать Назад в приложении Cloud Builder, чтобы исправить нужный параметр и повторить развертывание. Либо вы можете удалить ошибочное развертывание и создать вместо него новое.
Приложение ArcGIS Enterprise Cloud Builder for Amazon Web Services постоянно прекращает работу со сбоем и возвращает ошибку, сообщающую, что ArcGIS Enterprise Cloud Builder for AWS приостановил свою работу
Если приложение ArcGIS Enterprise Cloud Builder for Amazon Web Services прекращает работу со сбоем и возвращает сообщение об ошибке: ArcGIS Enterprise Cloud Builder for AWS has stopped working. Из-за проблемы программа перестала работать правильно. Windows закроет программу и уведомит вас о возможных решениях., на вашей машине скорее всего отсутствует необходимый пакет Microsoft Visual C++ Redistributable. См. предварительные требования к Cloud Builder для получения дополнительной информации и скачивания пакета.
Где найти журналы CloudWatch для созданных мной в приложении ArcGIS Enterprise Cloud Builder for Amazon Web Services развертываний?
Если приложение Cloud Builder не может создать развертывание, то на странице выполнения задания появятся сообщения об ошибках. Вы можете посмотреть подробные сведения об ошибках, нажав Просмотреть журнал процессов и Просмотреть журнал ошибок на странице выполнения задания.
Ошибки, возникающие при запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS
Ниже описаны основные проблемы и сообщения о них, которые могут возникнуть при запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS и предположения о том, как их можно устранить.
Я получил ошибку допуска.
Пользователь, который запускает утилиту ArcGIS Enterprise Cloud Builder CLI for AWS должен иметь рекурсивные права доступа на запись в папки Logs и Output. Убедитесь, что эти права предоставлены.
Я получил сообщение Не могу найти файл <file_name>.
Начиная с версии 10.8.1, нужно помещать файлы конфигурации JSON в папку Configuration или в одну из ее подпапок в вашей рабочей директории. Не помещайте файлы конфигурации JSON в папку Configuration, доступную в директории установки. Если ваших файлов конфигурации нет в папке Configuration вашей рабочей директории, переместите их туда и снова запустите утилиту.
В версии 10.8 и более ранних версиях вы должны разместить файл конфигурации JSON в папке Configuration или в одной из ее подпапок. Если файлы конфигурации не находятся в этом местоположении, перенесите в папку Configuration и снова запустите утилиту.
Я получил сообщение: Некорректное расширение файла конфигурации развертывания. Оно должно быть '.json’.
Расширение файла конфигурации должно быть .json. Если нет – переименуйте расширение файла и запустите утилиту заново.
Я получил сообщение Некорректный формат файла JSON <file_name>.
Убедитесь, что файл конфигурации соответствует формату JSON.
Подсказка:
Можно использовать проверку JSON, например JSONLint для проверки форматирования.
Я получил сообщение Не удалось получить доступ к учетной записи AWS с указанными учетными данными.
Убедитесь, что вы предоставили корректные учетные данные AWS в файле конфигурации JSON, и утилита может подключиться к AWS. Если учетные данные корректны, убедитесь, что ваша учетная запись доступна с компьютера, где вы запускаете утилиту ArcGIS Enterprise Cloud Builder CLI for AWS.
Я получил сообщение – Доступ запрещен – при запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS с использованием команды PREP.
Если вы используете существующий контейнер Amazon Simple Storage Service (S3) для файлов развертывания, убедитесь что у вас есть соответствующие права для доступа и записи для этого контейнера.
Когда я открываю выходной файл после запуска утилиты ArcGIS Enterprise Cloud Builder CLI for AWS с использованием команды CREATE я не вижу всех компонентов, которые там должны быть.
Выходной файл, созданный при использовании команды CREATE содержит заголовки для каждого компонента, который утилита создает на AWS. Эти заголовки связаны с узлами, которые вы включили в файл конфигурации JSON. Узлы в файле конфигурации указывают, какие компоненты должны быть созданы утилитой. Если вы удалили какой-либо узел из файла конфигурации, утилита на будет создавать этот компонент.
Каждый узел, который вы включили в файл конфигурации, должен содержать, как минимум, один параметр. Даже если вы задали все параметры в узле "Default", вы должны включить узел в каждую часть развертывания, которое хотите создать, и этот узел должен содержать, как минимум, один параметр и значение. Если узел представлен в файле конфигурации, но не содержит параметр, утилита пропустит этот узел. Например, вы не можете установить параметры для сайта ArcGIS GIS Server в "Default" и поместили пустой узел "Server" в файл конфигурации. Если так, утилита не создаст сайт ArcGIS GIS Server.
Проверьте файл конфигурации и убедитесь, что вы добавили все требуемые узлы и, как минимум, по одному параметру для каждого компонента развертывания. См. в разделе Параметры ArcGIS Enterprise Cloud Builder CLI for AWS список требуемых параметров для каждого узла файла конфигурации.
Когда я запускаю утилиту ArcGIS Enterprise Cloud Builder CLI for AWS, появляется командная строка, которая останавливает запуск.
В случае появления утилиты ArcGIS Enterprise Cloud Builder CLI for AWS или любой утилиты, запускаемой из окна командной строки Microsoft Windows, которая останавливает процесс запуска, выключите Режим QuickEdit для этого окна командной строки.
Решение проблем с созданием стека AWS CloudFormation
Инструменты развертывания ArcGIS Enterprise on Amazon Web Services создают стеки AWS CloudFormation. Используйте консоль AWS CloudFormation для отслеживания статуса своего стека AWS CloudFormation и определения случая неудачного создания стека. Войдите в консоль AWS CloudFormation (являющуюся частью AWS Management Console) и откройте вкладку События для изучения информации о создании, обновлении и удалении стека. Если стек не создается, информация на вкладке События поможет вам понять, что идет не так.
Инструменты развертывания ArcGIS Enterprise on Amazon Web Services создают также файлы журнала на виртуальных машинах, которые можно использовать при устранении проблем. Чтобы быть уверенным, что файлы защищены даже при неудачном развертывании, войдите в консоль AWS CloudFormation и отключите опцию Восстановление состояния при ошибке.
Если ваше развертывание произойдет с ошибкой, при запуске из инструмента развертывания ArcGIS Enterprise on Amazon Web Services, выполните подключение удаленного рабочего стола или SSH-подключение к экземпляру Amazon Elastic Compute Cloud (EC2), чтобы посмотреть эти журналы. Типы журналов и местоположения перечислены в следующей таблице:
| Тип экземпляра EC2 | Файл журнала и его местоположение в экземпляре EC2 | Описание файла журнала |
|---|---|---|
Ubuntu | /var/log/cfn-init.log | Файл журнала вспомогательного скрипта CloudFormation используется для получения и интерпретации метаданных ресурсов, установки пакетов, создания файлов и запуска сервисов |
/var/log/chef-run.log | Файл журнала главного инструмента настройки управления Chef | |
/var/lib/tomcat7/logs/catalina.out | Файл журнала сервера приложения Apache Tomcat | |
Windows | C:\cfn\log\cfn-init.log | Файл журнала вспомогательного скрипта CloudFormation используется для получения и интерпретации метаданных ресурсов, установки пакетов, создания файлов и запуска сервисов |
C:\chef\chef-run.log | Файл журнала главного инструмента настройки управления Chef |
Примечание:
Если создание стека CloudFormation выполнено успешно, выходные параметры стека содержат ссылку на группу журналов в AWS Management Console. В случае неудачного создания стека перейдите в список CloudFormation Ресурсы в AWS Management Console, чтобы найти группу журналов. Обратите внимание, что если создание стека не удается до запуска экземпляров, группа журналов может не быть создана.
Где найти журналы CloudWatch для созданных мной в приложении ArcGIS Enterprise on Amazon Web Services развертываний?
Для допуска к журналам CloudWatch развертываний, созданных инструментами ArcGIS Enterprise on Amazon Web Services, выполните вход в консоль CloudFormation, являющуюся частью AWS Management Console. См. страницу Просмотр журналов CloudFormation на консоли на веб-сайте AWS.
Где найти журналы CloudWatch для созданных мной инструментами ArcGIS Enterprise on Amazon Web Services развертываний?
Начиная с версии 10.8.1, ArcGIS Enterprise Cloud Builder for AWS использует версию 2 (V2) Amazon Instance Metadata Service (IMDS) при создании развертываний. Начиная с версии 10.8.1, шаблоны CloudFormation Esri используют также по умолчанию IMDS V2. В этом случае агент журнала CloudWatch AWS на экземплярах EC2 не совместим с IMDS V2. Это известное ограничение.
До тех пор пока AWS не исправит это ограничение, то если ваш стек не запускается и вы хотите просмотреть журналы для устранения неполадок, вам нужно будет делать следующее:
- Выполните вход в консоль CloudFormation в AWS Management Console.
- Выполните доступ к стеку CloudFormation и перейдите на вкладку События, чтобы найти причину неполадки.
- Если вы увидите сообщение наподобие Получен сигнал ОШИБКА с UniqueId <id экземпляра>, воспользуйтесь подключением к удаленному рабочему столу или SSH-подключением и ID экземпляра из сообщения для доступа к соответствующему экземпляру EC2.
- Изучите журналы Chef для понимания причины неудавшегося запуска стека. Журналы Chef можно найти в одном из следующих местоположений - в зависимости от операционной системы экземпляра EC2:
- Microsoft Windows – C:\chef\chef-run.log
- Ubuntu – /var/log/chef-run.log
Подсказка:
При использовании шаблонов CloudFormation Esri , чтобы ваше новое развертывание использовало IMDS версии 1 (V1), избегайте превышения ограничений агента журнала CloudWatch. Однако поскольку IMDS V1 менее безопасен, чем IMDS V2, этот способ не рекомендуется.
Ошибки, возникающие при запуске стека AWS CloudFormation
Ниже описаны основные проблемы и сообщения о них, которые могут возникнуть при развертывании с использованием шаблона AWS CloudFormation и предложения, как их можно устранить.
Почему при нажатии кнопки Запуск для запуска экземпляра я вижу ошибку о недостаточной емкости?
Эта ошибка, полученная в Amazon Elastic Compute Cloud, означает, что не хватает доступной емкости, чтобы выполнить ваш запрос на новый экземпляр. Если ваша архитектура размещения позволяет, вы сможете работать в обход этой ошибки, выполняя запросы к экземпляру в различных зонах доступности, или позволяя EC2 выбирать зону доступности за вас. Другими вариантами будет попробовать запустить другой размер экземпляра, или запустить экземпляр позже.
Что означает сообщение При построении конфигурации возникла ошибка: Не удалось получить https:// .s3.amazonaws.com/ в cfn-init.log?
Если вы видите это сообщение в файле cfn-init.log, убедитесь, что имя контейнера развертывания S3 корректно, и что имя ключа объекта S3 для файлов авторизации и сертификатов SSL корректно.
Что означает сообщение Невозможно подключиться к WebAdaptor URL: https://agsportalssl.esri.com/server/webadaptor в файле журнала? catalina.out
Если вы видите сообщение в файле журнала catalina.out на экземпляре Ubuntu, убедитесь, что сертификат SSL в контейнере развертывания S3 корректен и представлен в формате PKCS 12. Кроме того, убедитесь, что корректен пароль представленного сертификата SSL.
Что означает сообщение OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: ошибка проверки mac в файле chef-run.log?
Если вы видите это сообщение в файле журнала chef-run.log в экземпляре Windows, убедитесь, что сертификат SSL в контейнере развертывания S3 корректен и представлен в формате PKCS 12. Кроме того, убедитесь, что корректен пароль представленного сертификата SSL.
Решение проблем AWS Management Console
Вы можете обнаружить одно из следующих сообщений об ошибках, если вы используете AWS Management Console и Esri Amazon Machine Images при ручном создании сайта:
Почему я получаю сообщение Пароль не найден. при попытке получения пароля администратора для своего экземпляра EC2 на Windows?
Данное сообщение может возникать, если вы пытаетесь использовать Получить пароль Windows после того, как вы остановили и запустили заново экземпляр EC2. Чтобы избежать этой ошибки, во время первого входа измените пароль администратора на другой, более легко запоминающийся.
Я получил сообщение в AWS Management Console, что мой экземпляр назначен на удаление. Что это значит?
Вы можете увидеть это сообщение, если ваш экземпляр запускался на устаревшем аппаратном обеспечении, которое Amazon планирует заменить. Если вы видите такое сообщение, необходимо остановить сайт и запустить его снова.
После повторного запуска сайта это сообщение должно исчезнуть.