Skip to main content

Настройка ArcGIS Web Adaptor

После установки ArcGIS Web Adaptor необходимо настроить его для работы с сайтом сервера и вашим порталом ArcGIS Enterprise. Это делается с помощью веб-страницы настройки или утилиты командной строки, которая устанавливается вместе с Web Adaptor.

После открытия страницы конфигурации отображается текущий статус ArcGIS Web Adaptor. Он показывает, был ли ранее настроен ArcGIS Web Adaptor. Чтобы узнать тип платформы и номер версии Web Adaptor, щелкните О Web Adaptor на странице конфигурации.

Примечание:

Начиная с ArcGIS Enterprise 11.5 административный доступ к сайту ArcGIS Server через Web Adaptor включен по умолчанию и не может быть отключен. Для развертываний ArcGIS Enterprise с выходом в интернет рассмотрите возможность использования балансировщика нагрузки с поддержкой брандмауэра веб-приложений (WAF) производственного уровня в качестве внешнего интерфейса вместо Web Adaptor. Подробнее см. раздел ArcGIS Enterprise Hardening Guide.

Если вы уже настроили Web Adaptor с порталом ArcGIS Enterprise и хотите обновить портал, чтобы использовать другой Web Adaptor, сначала потребуется отменить регистрацию текущего Web Adaptor. Вы можете отменить регистрацию только с Portal Directory; функциональность отмены регистрации недоступна со страницы конфигурации или веб-сайта портала. Полные инструкции смотрите в разделе Отмена регистрации ArcGIS Web Adaptor с Portal for ArcGIS.

Внимание:

Хотя вы можете изменить Web Adaptor портала, зарегистрировав новый, это может также повлиять на пользовательские ресурсы портала (например, примечания к карте или другие элементы).

Примечание:

Использование порта HTTPS 443 по умолчанию подходит для большинства пользователей. В редких случаях экземпляр ArcGIS Web Adaptor не может использовать порт 443 на своем веб-сервере из-за ограничений, принятых в организации. Если это применимо к вашей организации, см. Использование портов, не предлагаемых по умолчанию, для ArcGIS Web Adaptor портала, где описываются дополнительные шаги по настройке.

Настройте ArcGIS Web Adaptor с сайтом сервера

В следующих разделах описывается, как можно настроить ArcGIS Web Adaptor с помощью сайта сервера на странице конфигурации и утилиты командной строки.

Настройка на веб-странице конфигурации

Для настройки ArcGIS Web Adaptor с помощью веб-страницы настройки, которая устанавливается вместе с ним, выполните следующие действия.

Примечание:

Существуют дополнительные условия для ArcGIS Mission Server, ArcGIS Notebook Server и ArcGIS Video Server, которые следует рассмотреть на этом этапе.

  1. Откройте страницу конфигурации в веб-браузере.

    URL-адрес имеет формат https://webadaptorhost.example.com/webadaptorname/webadaptor.

    Примечание:

    Если веб-сервер, на котором установлен ArcGIS Web Adaptor, настроен на работу с перенаправляющим прокси-сервером, отключите его при регистрации Web Adaptor. Иначе вы не сможете получить доступ к странице конфигурации Web Adaptor.

  2. Выберите тип сервера, который вы хотите настроить на работу с Web Adaptor. Щелкните Далее.

  3. Введите имя компьютера для одного из серверов, регистрируемого на сайте.

    Это имя компьютера будет использовано для обнаружения всех компьютеров, участвующих в сайте сервера, и их регистрации в Web Adaptor. Имя компьютера должно быть в формате server.example.com.

  4. Введите имя пользователя и пароль для учетной записи, которая имеет права администратора на сайте сервера. Обычно используется имя пользователя и пароль учетной записи основного администратора сайта, которая задается при создании сайта. Если учетная запись основного администратора сайта отключена, необходимо указать учетную запись с административным доступом к сайту.

  5. Щелкните Настроить, чтобы применить настройки Web Adaptor.

После успешной настройки, компьютеры. опознанные Web Adaptor, перечисляются внизу страницы конфигурации (выделены зеленым). Можно вернуться на эту страницу для просмотра списка распознанных компьютеров и настройки параметров Web Adaptor.

Настройка из командной строки

Вы можете настроить ArcGIS Web Adaptor с помощью сайта сервера, используя утилиту командной строки (ConfigureWebAdaptor.exe) в C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools.

Доступны следующие параметры:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password>

Вы можете настроить ArcGIS Web Adaptor с помощью сайта сервера, используя утилиту командной строки (ConfigureWebAdaptor.bat) в <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools.

Доступны следующие параметры:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

Вы можете настроить ArcGIS Web Adaptor с помощью сайта сервера, используя утилиту командной строки (configurewebadaptor.sh) в <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools. Это особенно удобно, когда на компьютере с Web Adaptor отсутствует графический интерфейс (GUI).

Доступны следующие параметры:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

  • <Mode> – компонент, с которым будет настраиваться Web Adaptor. По умолчанию этот параметр устанавливается как server, и это значит, что Web Adaptor можно настроить для использования с сайтом сервера. Ниже приведены параметры, которые можно использовать для настройки других компонентов.

    • Portal for ArcGIS — portal

    • ArcGIS Mission Server — mission

    • Notebook Server—notebook

    • Video Server—video

    • ArcGIS Monitor — monitor

    • ArcGIS Data Pipelines — datapipelines

  • <WebAdaptorURL> – URL-адрес Web Adaptor, который требуется настроить из командной строки. Этот тот же URL-адрес, который используется при доступе к странице настройки Web Adaptor с помощью веб-браузера. Если Web Adaptor установлен на порту, отличном от 80, необходимо указать в URL-адресе номер порта.

  • <MachineName|URL> – имя одного из компьютеров сайта сервера, например server.example.com. Вы также можете использовать URL-адрес сервера, вместо имени компьютера. Если вы настраиваете Web Adaptor на работу с ArcGIS Server, имя компьютера или URL-адрес будут использоваться для обнаружения всех компьютеров, участвующих в сайте.

  • <Username> – имя пользователя учетной записи, у которой есть права администратора на сайте сервера. Для ArcGIS Server это может быть учетная запись основного администратора сайта, заданная при создании сайта, или учетная запись с административными правами. Для Mission Server, Notebook Server и Video Server введите имя пользователя учетной записи основного администратора, указанной при создании сайта.

  • <Password> – пароль учетной записи, у которой есть права администратора на сайте сервера.

См. следующий пример: ConfigureWebAdaptor.exe /m server /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g server.example.com /u siteadmin /p secret

См. следующий пример: ConfigureWebAdaptor.bat -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

См. следующий пример: $ ./configurewebadaptor.sh -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

Примечание:

Для запуска утилиты командной строки необходимо, чтобы на компьютере с Web Adaptor была установлена Java Runtime Environment (JRE). Если на этом компьютере нет JRE, то при запуске утилиты возникнет ошибка. Инструкции по загрузке и установке JRE находятся на сайте Загрузки Java SE.

Настройка ArcGIS Web Adaptor с порталом

В следующих разделах описано, как настроить ArcGIS Web Adaptor с вашим порталом ArcGIS Enterprise на странице конфигурации и в утилите командной строки.

Настройка на веб-странице конфигурации

Для настройки ArcGIS Web Adaptor на вашем портале с веб-страницы конфигурации, которая устанавливается вместе с ним, выполните следующие действия:

Внимание:

Чтобы добавить псевдоним DNS или обратный прокси-сервер после того, как сайт ArcGIS Server был интегрирован с порталом, см. раздел Обновление URL-адреса организации.

  1. Включите HTTPS на вашем веб-сервере, если вы этого еще не сделали.

  2. Откройте страницу конфигурации в веб-браузере по протоколу HTTPS, например, https://webadaptorhost.example.com/webadaptorname/webadaptor. Если с порталом будет использоваться псевдоним DNS, то Web Adaptor должен настраиваться на этот псевдоним с использованием URL типа https://<dnsalias.example.com>/<webadaptorname>/webadaptor.

    Примечание:

    Если на веб-сервере, на котором установлен ArcGIS Web Adaptor, запущен перенаправляющий прокси-сервер, отключите его при регистрации Web Adaptor. Иначе вы не сможете получить доступ к странице конфигурации Web Adaptor.

  3. Выберите Portal for ArcGIS и щелкните Далее.

  4. Введите название компьютера, размещающего Portal for ArcGIS. Введите полное доменное имя, например, portal.example.com.

  5. Введите имя пользователя и пароль для учетной записи, у которой есть права администратора в Portal for ArcGIS. Обычно используется имя пользователя и пароль основной учетной записи администратора, которая задается при создании портала. Если вы ограничили права или удалили основную учетную запись администратора, необходимо указать учетную запись с административным доступом к веб-сайту портала.

  6. Щёлкните Настройка.

ArcGIS Web Adaptor настроен для использования с компьютером, размещающем Portal for ArcGIS. Теперь у вас есть доступ к порталу через URL ArcGIS Web Adaptor, а не через порт 7443. URL-адрес имеет следующий формат: https://webadaptorhost.example.com/webadaptorname/home.

Если вы настроили свой портал на использование HTTPS для передачи данных, обновите URL ярлыков веб-сайта портала и справки с учетом использования протокола https вместо http, иначе вы увидите сообщения об ошибке в браузере при попытке перейти по старым URL-ссылкам ярлыков.

Если планируется настроить Portal for ArcGIS для работы с обратным прокси-сервером вашей организации, потребуется ввести на портале необходимые данные о прокси-сервере. Полные инструкции см. в разделе Интеграция портала с обратным прокси или балансировщиком нагрузки.

Настройка из командной строки

Вы можете настроить ArcGIS Web Adaptor на портале, используя утилиту командной строки (ConfigureWebAdaptor.exe) в C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools.

Доступны следующие параметры:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password> -r <ReindexPortal>

Вы можете настроить ArcGIS Web Adaptor на портале, используя утилиту командной строки (ConfigureWebAdaptor.bat) в <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools.

Доступны следующие параметры:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

Вы можете настроить ArcGIS Web Adaptor на портале, используя утилиту командной строки (configurewebadaptor.sh) в <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools. Это особенно удобно, когда на компьютере с Web Adaptor отсутствует графический интерфейс (GUI).

Доступны следующие параметры:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

  • <Mode> – компонент, с которым будет настраиваться Web Adaptor. По умолчанию значением этого параметра является server; это означает, что Web Adaptor может быть настроен для работы с ГИС-сервером, Image Server или GeoAnalytics Server. Поскольку вы настраиваете веб-адаптер для использования с Portal для ArcGIS, укажите этот параметр как portal.

  • <WebAdaptorURL> – URL-адрес Web Adaptor, который требуется настроить из командной строки. Этот тот же URL-адрес, который используется при доступе к странице настройки Web Adaptor с помощью веб-браузера. Вам требуется указать адрес URL-адрес Web Adaptor в формате HTTPS – например, https://webadaptorhost.example.com/webadaptorname/webadaptor. Если с порталом будет использоваться псевдоним DNS, то Web Adaptor должен настраиваться на этот псевдоним с использованием URL типа https://<dnsalias.example.com>/<webadaptorname>/webadaptor.

  • <MachineName|URL> — имя одного из компьютеров, размещающих Portal for ArcGIS. Укажите полное доменное имя компьютера, например, portal.example.com. Вы также можете использовать URL-адрес компьютера, на котором размещен Portal for ArcGIS, вместо имени компьютера.

  • <Username> — имя пользователя учетной записи, у которой есть права администратора в Portal for ArcGIS. Это может быть учетная запись основного администратора сайта, заданная при создании сайта, или учетная запись с административными правами.

  • <Password> — пароль от учетной записи, у которой есть административные права в Portal for ArcGIS.

  • <ReindexPortal> — обозначает, следует ли переиндексировать ресурсы портала по умолчанию при регистрации Web Adaptor. Эта опция удобна, если вы собираетесь настраивать свое развертывание с обратным прокси или балансировщиком нагрузки. Регистрация Web Adaptor без индексации занимает меньше времени. После настройки webContextURL встроенные ресурсы будут ссылаться на webContextURL.

Пример: ConfigureWebAdaptor.exe /m portal /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g portal.example.com /u initialadmin /p secret -r true

Пример: ConfigureWebAdaptor.bat -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

Пример: ConfigureWebAdaptor.sh -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

После выполнения команды ArcGIS Web Adaptor настраивается для использования с компьютером, размещающем Portal for ArcGIS. Теперь у вас есть доступ к порталу через URL ArcGIS Web Adaptor, а не через порт 7443. URL-адрес имеет следующий формат: https://webadaptorhost.example.com/webadaptorname/home.

Если планируется настроить Portal for ArcGIS для работы с прокси-сервером вашей организации, потребуется ввести в портал необходимые данные о прокси-сервере. Полные инструкции см. в разделе Интеграция портала с обратным прокси или балансировщиком нагрузки.

Настройка нескольких ArcGIS Web Adaptor

Несколько ArcGIS Web Adaptor требуется при настройте отказоустойчивого портала, использующего аутентификацию веб-узлов. Для настройки нескольких Web Adaptor с Portal for ArcGIS необходимо использовать единую конечную точку для доступа к порталу. Этот URL должен быть задан в свойстве WebContextURL. Затем несколько веб-адапторов можно настроить на портале, выполнив следующие шаги.

  1. Настройте первый ArcGIS Web Adaptor с помощью вашего портала.

  2. Добавьте Portal for ArcGIS к вашему обратному прокси-серверу. Настройте свойство WebContextURL следующим образом:

    1. Откройте веб-браузер и войдите в Portal Administrator Directory в качестве администратора своей организации.

      Адрес URL имеет формат https://portal.example.com:7443/arcgis/portaladmin.

    2. Щелкните Система > Свойства > Обновить свойства.

      Сервис Portal for ArcGIS перезапускается автоматически. Следует подождать завершения перезагрузки перед продолжением.

    3. В диалоговом окне Обновить свойства системы вставьте следующий JSON, заменив URL-адрес обратного прокси или псевдоним DNS тем, который видят пользователи за пределами брандмауэра вашей организации:

       {
      "WebContextURL": "https://reverseproxy.example.com/myorg"
   }
    1. Щелкните Обновить свойства.

  3. Настройте дополнительные экземпляры Web Adaptor.

Все экземпляры Web Adaptor, настроенные с порталом, будут перечислены в итоговой информации по выполненной настройке. Портал будет доступен для пользователей через обратный прокси-сервер или URL-адрес псевдонима DNS.

Примечание:

Portal for ArcGIS поддерживает только один URL организации.

После настройки ArcGIS Web Adaptor

Теперь, когда ArcGIS Web Adaptor готов к использованию, рассмотрите следующие элементы.

Добавление или удаление компьютеров сервера

Если вы добавляете или удаляете машины сервера с сайта, необходимо около одной минуты, чтобы Web Adaptor распознал изменения на сайте. Если вы хотите, чтобы Web Adaptor немедленно распознавал добавленные или удаленные машины, его следует перенастроить с помощью вышеуказанных инструкций.

Установка нескольких Web Adaptor

Можно создать другие веб-точки входа на сайт сервера, установив несколько экземпляров Web Adaptor. Это позволит сделать ваш сайт более доступным для клиентов, обеспечить поддержку устаревшим приложениям и разрешить публикацию для отдельных пользователей в защищенную среду. Дополнительные сведения см. в разделе Сценарии внедрения.

Несколько экземпляров Web Adaptor можно установить на один компьютер или распределить их по нескольким. Чтобы установить несколько Web Adaptor на одном веб-сайте (порт), используйте для них разные имена. Например, два экземпляра Web Adaptor с именем arcgis не могут находиться на одном веб-сайте. Если вы хотите установить несколько экземпляров Web Adaptor с одинаковыми именами, необходимо установить их на разные веб-сайты (порты).