Существует множество методов, которые вы можете использовать для развертывания 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. Для эффективного устранения проблем ознакомьтесь с этими журналами.
Решение проблем с приложением 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. See 'c:\\chef\chef-run.log' for details', проверьте журналы AWS 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 для получения дополнительной информации и скачивания пакета.
Ошибки, возникающие при запуске утилиты 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>.
Вы должны разместить файл конфигурации 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
Используйте консоль AWS CloudFormation для отслеживания статуса своего стека AWS CloudFormation и определения случая неудачного создания стека. Войдите в консоль AWS CloudFormation (являющуюся частью AWS Management Console) и откройте вкладку События для изучения информации о создании, обновлении и удалении стека. Если стек не создается, информация на вкладке События поможет вам понять, что идет не так.
Шаблоны Esri CloudFormation создают также файлы журнала на виртуальных машинах, которые также можно использовать при устранении проблем. Чтобы быть уверенным, что файлы защищены, даже при неудачном развертывании, войдите в консоль AWS CloudFormation и отключите опцию Восстановление состояния при ошибке.
Если ваше развертывание произойдет с ошибкой, при запуске из шаблона Esri, выполните удаленное настольное подключение или SSH-подключение к экземпляру Amazon Elastic Compute Cloud (EC2), чтобы посмотреть эти журналы. Типы журналов и местоположения перечислены в следующей таблице:
| Тип экземпляра EC2 | Файл журнала и его местоположение в экземпляре EC2 | Описание файла журнала |
|---|---|---|
Ubuntu | /var/log/cfn-init.log | Файл журнала вспомогательного скрипта CloudFormation используется для получения и интерпретации метаданных ресурсов, установки пакетов, создания файлов и запуска сервисов |
/var/log/chef-run.log | Файл журнала главного инструмента настройки управления | |
/var/lib/tomcat7/logs/catalina.out | Файл журнала сервера приложения Apache Tomcat | |
Windows | C:\cfn\log\cfn-init.log | Файл журнала вспомогательного скрипта CloudFormation используется для получения и интерпретации метаданных ресурсов, установки пакетов, создания файлов и запуска сервисов |
C:\chef\chef-run.log | Файл журнала главного инструмента настройки управления |
Примечание:
Если создание стека CloudFormation выполнено успешно, выходные параметры стека содержат ссылку на группу журналов в AWS Management Console. В случае неудачного создания стека перейдите в список CloudFormation Ресурсы в AWS Management Console, чтобы найти группу журналов. Обратите внимание, что если создание стека не удается до запуска экземпляров, группа журналов может не быть создана.
Ошибки, возникающие при запуске стека 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 планирует заменить. Если вы видите такое сообщение, необходимо остановить сайт и запустить его снова.
После повторного запуска сайта это сообщение должно исчезнуть.