Существует множество методов, которые вы можете использовать для развертывания ArcGIS Enterprise и ArcGIS Server на Amazon Web Services (AWS). В разделе описываются способы устранения возможных проблем, с которыми вы можете столкнуться при выполнении развертывания каждого типа.
Решение проблем с ArcGIS Enterprise Cloud Builder для Amazon Web Services
Есть две папки под папкой Logs в местоположении, куда вы извлекаете ArcGIS Enterprise Cloud Builder для Amazon Web Services и связанные с ним файлы.
Папка Logs содержит следующие две подпапки:
- Log – эта папка содержит журналы консоли, которые создаются каждый раз при запуске утилиты. Папка Log также содержит журналы событий CloudFormation для каждого стека, который вы создаете в развертывании каждый раз при запуске команды CREATE с утилитой ArcGIS Enterprise Cloud Builder CLI for AWS или добавлении развертывания в приложении ArcGIS Enterprise Cloud Builder для Amazon Web Services.
- ErrorLog - эта папка содержит файлы журнала, куда записываются ошибки, если они возникают при запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS или приложения ArcGIS Enterprise Cloud Builder для Amazon Web Services. Прочитайте эти журналы ошибок для эффективного устранения неполадок.
Обратитесь к двум следующим разделам для получения информации о конкретных ошибках, с которыми вы можете столкнуться при запуске приложения Cloud Builder или утилиты ArcGIS Enterprise Cloud Builder CLI for AWS. И приложение, и утилита запускают стеки CloudFormation, поэтому обратитесь к разделу об устранении проблем при создании стека CloudFormation для идентификации и исправления проблем, связанных с развертыванием.
Ошибки, возникающие при запуске приложения ArcGIS Enterprise Cloud Builder для Amazon Web Services
Приложение ArcGIS Enterprise Cloud Builder для 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 появятся сообщения об ошибках. Вы можете посмотреть подробные сведения об ошибках, нажав Просмотреть журнал процессов и Просмотреть журнал ошибок на странице выполнения задания.
Если вы видите общую ошибку, такую как сигнал Получен сигнал ОШИБКА с <unique-id>, проверьте журналы Amazon CloudWatch, щелкнув URL-адреса журналов в разделе Просмотреть журналы AWS CloudWatch на странице с итоговой информацией Cloud Builder. При этом откроется соответствующий журнал CloudWatch в вашем веб-браузере по умолчанию, где вы сможете просмотреть журналы для каждого экземпляра Amazon Elastic Compute Cloud (EC2) в вашем развертывании и, таким образом, выявить причину ошибки.
Когда вы поймете, в чем дело, вы можете щелкнуть Назад в приложении Cloud Builder, чтобы исправить нужный параметр и повторить развертывание. Либо вы можете удалить ошибочное развертывание и создать вместо него новое.
Приложение ArcGIS Enterprise Cloud Builder для Amazon Web Services постоянно прекращает работу со сбоем и возвращает ошибку, сообщающую, что ArcGIS Enterprise Cloud Builder for AWS приостановил свою работу
Если приложение ArcGIS Enterprise Cloud Builder для Amazon Web Services прекращает работу со сбоем и возвращает сообщение об ошибке: ArcGIS Enterprise Cloud Builder for AWS остановил работу. Из-за проблемы программа перестала работать правильно. Windows закроет программу и уведомит вас о возможных решениях. , на вашей машине скорее всего отсутствует необходимый пакет Redistributable Microsoft Visual C++. См. предварительные требования к Cloud Builder для получения дополнительной информации и скачивания пакета.
Где найти журналы CloudWatch для созданных мной в приложении ArcGIS Enterprise Cloud Builder для 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>.
Нужно помещать файлы конфигурации JSON в папку Configuration или в одну из ее подпапок в вашей рабочей директории; Не помещайте файлы конфигурации 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 и отключите опцию Восстановление состояния при ошибке.
Когда вы создаете развертывание с использованием шаблонов CloudFormation, предоставленных Esri, все журналы развертывания экспортируются в сервис Amazon CloudWatch Log. См. инструкции в разделе Просмотр журналов в консоли CloudWatch раздела Просмотр AWS журналов CodeDeploy в консоли Amazon CloudWatch в справке AWS для получения информации о просмотре журналов развертывания.
Журналы развертывания хранятся в виде группы журналов в сервисе Amazon CloudWatch Log. В группе журналов вы найдете несколько потоков журналов с именами, заканчивающимися на /stderr и /stdout. Обратитесь ко всем потокам журналов, чтобы выяснить причину сбоя.
Эти журналы также хранятся в экземпляре EC2. В экземплярах Microsoft Windows эти журналы можно найти в папке C:\cinc. В экземплярах Ubuntu Server эти журналы можно найти в директории /var/logs.
Где я могу найти журналы развертываний CloudWatch, созданных с помощью инструментов развертывания ArcGIS Enterprise on Amazon Web Services?
Для допуска к журналам CloudWatch развертываний, созданных инструментами развертывания ArcGIS Enterprise on Amazon Web Services, выполните вход в консоль CloudFormation, являющуюся частью AWS Management Console. См. страницу Просмотр журналов CloudFormation на консоли на веб-сайте AWS.
Ошибки, возникающие при запуске стека AWS CloudFormation
Ниже описаны основные проблемы и сообщения о них, которые могут возникнуть при развертывании с использованием шаблона AWS CloudFormation и предложения, как их можно устранить.
Почему при нажатии кнопки Запуск для запуска экземпляра я вижу ошибку о недостаточной емкости?
Эта ошибка, полученная в Amazon Elastic Compute Cloud, означает, что не хватает доступной емкости, чтобы выполнить ваш запрос на новый экземпляр. Если ваша архитектура размещения позволяет, вы сможете работать в обход этой ошибки, выполняя запросы к экземпляру в различных зонах доступности, или позволяя EC2 выбирать зону доступности за вас. Другими вариантами будет попробовать запустить другой размер экземпляра, или запустить экземпляр позже.
Что означает сообщение Невозможно подключиться к WebAdaptor URL: https://agsportalssl.esri.com/server/webadaptor в файле журнала catalina.out?
Если вы видите сообщение в файле журнала catalina.out на экземпляре Ubuntu, убедитесь, что сертификат SSL в бакете развертывания S3 корректен и представлен в формате PKCS 12. Кроме того, убедитесь, что корректен пароль представленного сертификата SSL.
Что означает сообщение OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: ошибка проверки mac в файле журнала?
Если вы видите сообщение в файле журнала на экземпляре Windows, убедитесь, что сертификат SSL в бакете развертывания S3 корректен и представлен в формате PKCS 12. Кроме того, убедитесь, что корректен пароль представленного сертификата SSL.
Решение проблем с AWS Management Console
Вы можете обнаружить одно из следующих сообщений об ошибках, если вы используете AWS Management Console и Esri Amazon Machine Images при ручном создании сайта:
Почему я получаю сообщение Пароль не найден при попытке получения пароля администратора для своего экземпляра EC2 на Windows?
Данное сообщение может возникать, если вы пытаетесь использовать Получить пароль Windows после того, как вы остановили и запустили заново экземпляр EC2. Чтобы избежать этой ошибки, во время первого входа измените пароль администратора на другой, более легко запоминающийся.
Я получил сообщение в AWS Management Console, что мой экземпляр назначен на удаление. Что это значит?
Вы можете увидеть это сообщение, если ваш экземпляр запускался на устаревшем аппаратном обеспечении, которое Amazon планирует заменить. Если вы видите такое сообщение, необходимо остановить сайт и запустить его снова.
После повторного запуска сайта это сообщение должно исчезнуть.