Существует множество методов, которые вы можете использовать для развертывания ArcGIS Enterprise и ArcGIS Server на AWS. В разделе описываются способы устранения возможных проблем, с которыми вы можете столкнуться для каждого типа развертывания.
Решение проблем ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services
Есть две папки под папкой Logs в местоположении, куда вы извлекаете утилиту ArcGIS Enterprise Cloud Builder CLI for AWS и файлы.
Папка Logs содержит следующие две подпапки:
- Log – папка содержит журналы консоли, которые создаются каждый раз при запуске утилиты. Папка Log также содержит журналы CloudFormation для каждой серии, которую вы создаете в развертывании каждый раз при запуске команды CREATE.
- ErrorLog – папка содержит файлы журнала, куда записываются ошибки, если они возникают при запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS. Для эффективного устранения проблем ознакомьтесь с этими журналами.
Ошибки, возникающие при запуске утилиты 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.
Если вы используете существующий блок 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) и откройте вкладку События для изучения информации о создании, обновлении и удалении стека. Если стек не создается, информация на вкладке События поможет вам понять, что идет не так.
Шаблоны Esri CloudFormation создают также файлы журнала на виртуальных машинах, которые также можно использовать при устранении проблем. Чтобы быть уверенным, что файлы защищены, даже при неудачном развертывании, войдите на AWS CloudFormation Console и отключите Восстановление состояния при ошибке.
Если ваше развертывание произойдет с ошибкой, при запуске из шаблона Esri, выполните удаленное настольное подключение или SSH к экземпляру EC2, чтобы посмотреть эти журналы. Типы журналов и местоположения перечислены в следующей таблице:
| Тип экземпляра EC2 | Файл журнала и местоположение экземпляра EC2 | Описание файла журнала |
|---|---|---|
Ubuntu | /var/log/cfn-init.log | Файл журнала вспомогательного скрипта CloudFormation используется для получения и интерпретации метаданных ресурсов, установки пакетов, создания файлов и запуска сервисов |
/var/log/chef-run.log | Файл журнала главного инструмента настройки управления | |
/var/lib/tomcat7/logs/catalina.out | Файл журнала сервера приложений Apache Tomcat | |
Окна | 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 EC2, означает, что не хватает доступной емкости, чтобы выполнить ваш запрос на новый экземпляр. Если ваша архитектура размещения позволяет, вы сможете работать вокруг этой ошибки, выполняя запросы к экземпляру в различных зонах доступности, или позволяя 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
Вы можете обнаружить одно из следующих сообщений об ошибках, если вы используете Консоль управления AWS Management Console и Esri Amazon Machine Images при ручном создании сайта:
Почему я получаю сообщение Пароль не найден. при попытке получения пароля администратора для своего экземпляра EC2 на Windows?
Данное сообщение может возникать, если вы пытаетесь использовать Получить пароль Windows после того, как вы остановили и запустили заново экземпляр EC2. Чтобы избежать этой ошибки, во время первого входа измените пароль администратора на другой, более легко запоминающийся.
Я получил сообщение в AWS Management Console, что мой экземпляр назначен на удаление. Что это значит?
Вы можете увидеть это сообщение, если ваш экземпляр запускался на устаревшем аппаратном обеспечении, которое Amazon следует заменить. Если вы видите такое сообщение, необходимо остановить сайт и запустить его снова.
Учтите, что если для создания сайта использовался ArcGIS Server Cloud Builder on Amazon Web Services, то для остановки и запуска сайта следует использовать Cloud Builder.
После повторного запуска сайта это сообщение должно исчезнуть.
Решение проблем ArcGIS Server Cloud Builder on Amazon Web Services
Если вы столкнетесь с проблемами при использовании ArcGIS Server Cloud Builder on Amazon Web Services, вы можете создать текстовый файл, в который будут записываться сообщения об ошибке и другая информация, которая поможет вам в устранении проблемы.
Чтобы включить ведение журнала на уровне отладки для ArcGIS Server Cloud Builder on Amazon Web Services, выполните следующие шаги:
- Если ArcGIS Server Cloud Builder on Amazon Web Services запущен, закройте его.
- Создайте обычный текстовый файл с именем loglevel в папке %USERPROFILE%\documents\ArcGISCloudBuilder на компьютере, где установлен ArcGIS Server Cloud Builder on Amazon Web Services.
Не добавляйте никакие расширения к имени файла; файл должен называться loglevel, а не loglevel.txt.
- Откройте файл в текстовом редакторе и введите DEBUG в первой строки.
- Сохраните и закройте файл.
- Запустите заново ArcGIS Server Cloud Builder on Amazon Web Services и повторите шаги, которые привели к возникновению проблемы, которую вы хотите исправить.
Записи на уровне отладки будут занесены в файл журнала. Когда ArcGIS Server Cloud Builder on Amazon Web Services выполняет запись в файл журнала, к имени файла в конце будет добавлена дата в формате ГГГГ-ММ-ДД.
Новый файл журнала будет создаваться для каждого дня, когда используется ArcGIS Server Cloud Builder on Amazon Web Services. Не забывайте удалять старые файлы журнала.
Ошибки, возникающие при использовании ArcGIS Server Cloud Builder on Amazon Web Services
Ниже описаны основные проблемы и сообщения о них, которые могут возникнуть при создании сайта ArcGIS Server с использованием ArcGIS Server Cloud Builder on Amazon Web Services и предположения о том, как их можно устранить.
Почему мне не удается подключить удаленный доступ к вновь созданному сайту ArcGIS Server на Windows?
Во-первых, предоставьте сайту некоторое время для запуска. Если для создания сайта вы использовали ArcGIS Server Cloud Builder on Amazon Web Services, необходимо подождать, пока вся информация сайта не появится в окне Мои сайты, и вы увидите кнопки остановки, обновления и удаления сайта.
Если сайт был запущен с помощью консоли управления AWS или шаблона CloudFormation, щелкните правой кнопкой мыши экземпляр на консоли управления AWS и выберите Получить системный журнал. После того, как вы увидите сообщение, что Windows готов к работе, подождите дополнительно 5 минут, прежде чем пытаться выполнить вход.
Во-вторых, убедитесь, что в группу безопасности сайта добавлено правило, разрешающее удаленные подключения компьютеров через порт 3389. Соответствующее описание содержится в разделе Открытие группы безопасности Amazon EC2 для ArcGIS.
ArcGIS Server Cloud Builder on Amazon Web Services отображает следующее сообщение после входа: Не удалось получить список пользовательских шаблонов конфигурации. Запрещено. Что это значит?
Хотя это сообщение может иметь множество причин, оно также может появляться, когда время вашей системы не синхронизировано с актуальным текущим временем. Например, если вы проживаете в регионе, где время переводится на час раньше в течение летних месяцев, и часы вашего компьютера не синхронизированы с этим изменением, ArcGIS Server Cloud Builder on Amazon Web Services не сможет выполнять определенные действия в Amazon EC2.