Skip to main content

Установка ArcGIS Web Adaptor

ArcGIS Web Adaptor можно установить с помощью предоставленной программы установки, которую можно запустить через утилиту Setup.exe или установить в автоматическом режиме с использованием параметров командной строки Windows Installer.

ArcGIS Web Adaptor можно установить с помощью предоставленной программы установки, которую можно запустить через утилиту Setup.exe или установить в автоматическом режиме с использованием параметров командной строки Windows Installer.

ArcGIS Web Adaptor можно установить с помощью предоставленной программы установки, которую можно запустить через утилиту Setup.sh или установить в автоматическом режиме с использованием параметров командной строки.

Требования установки

  • Версия ArcGIS Web Adaptor должна совпадать с версией сайта сервера или портала.

  • ArcGIS Web Adaptor можно устанавливать параллельно с другими версиями. Вам не требуется удалять ArcGIS Web Adaptor, если вы не обновляетесь до более новой версии.

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

  • Нет необходимости устанавливать ArcGIS Web Adaptor и Tomcat на одном компьютере, если вы будете настраивать Web Adaptor на работу с сайтом сервера или с порталом через браузер. Но для настройки Web Adaptor с помощью инструмента configurewebadaptor.exe на компьютере должны быть установлены и Web Adaptor, и Tomcat.

    Примечание:

    Для запуска Tomcat или любого сервера приложений, на котором будет развернут экземпляр ArcGIS Web Adaptor, необходимо убедиться, что у вас есть права доступа администратора. Если это не так, операция по регистрации ArcGIS Web Adaptor с ArcGIS Server не будет выполнена.

  • Нет необходимости устанавливать ArcGIS Web Adaptor и Tomcat на одном компьютере, если вы будете настраивать Web Adaptor на работу с сайтом сервера или с порталом через браузер. Но для настройки Web Adaptor с помощью инструмента configurewebadaptor.sh на компьютере должны быть установлены и Web Adaptor, и Tomcat.

    Примечание:

    Для запуска Tomcat или любого сервера приложений, на котором будет развернут экземпляр ArcGIS Web Adaptor, необходимо убедиться, что у вас есть права доступа администратора. Если это не так, операция по регистрации ArcGIS Web Adaptor с ArcGIS Server не будет выполнена.

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

Перед установкой ArcGIS Web Adaptor

Перед установкой ArcGIS Web Adaptor выполните следующее:

  1. Убедитесь в том, что ваш компьютер отвечает всем системным требованиям. Для работы с сайтом сервера или порталом можно настроить только один Web Adaptor.

  2. Включите IIS и необходимые компоненты.

    Внимание:

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

  3. Убедитесь, что следующие компоненты установлены на компьютеры, на которых будет устанавливаться ArcGIS Web Adaptor:

    Примечание:

    Вы должны установить ASP.NET Core Runtime — Windows Hosting Bundle, который включает в себя поддержку .NET Runtime и IIS.

    Внимание:

    Если вы установили ASP.NET Core Runtime — Windows Hosting Bundle перед включением необходимых компонентов, необходимо восстановить установку пакета с помощью установщика пакета.

  4. Войдите в систему, на которую устанавливаете ArcGIS Web Adaptor.

    Примечание:

    Вы должны войти в систему как пользователь с правами доступа администратора.

  5. Убедитесь, что у вас сайт на порту 80, а HTTPS включён на порту 443. Это необходимо для разнообразия зашифрованных и незашифрованных вызовов в ArcGIS Enterprise. Для получения инструкций по созданию веб-сайта обратитесь к документации по продукту IIS. Подробные сведения о настройке и использовании HTTPS см. в разделе Включение HTTPS на вашем веб-сервере.

    Примечание:

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

  6. Закройте все работающие приложения.

  7. Просмотрите загруженную папку с установкой ArcGIS Web Adaptor. Вы также можете вставить диск с ArcGIS Server или Portal for ArcGIS Media, чтобы автоматически начать установку.

Теперь вы готовы начать установку ArcGIS Web Adaptor.

[!CAUTION]Не стоит пытаться настроить ArcGIS Web Adaptor так, чтобы URL-адрес содержал дополнительные уровни, так как это может вызвать проблемы в работе клиентских приложений.

  1. Убедитесь в том, что ваш компьютер отвечает всем системным требованиям. Для работы с сайтом сервера или порталом можно настроить только один Web Adaptor.

  2. Войдите в компьютер, на который устанавливаете ArcGIS Web Adaptor.

    Примечание:

    Вы должны войти в систему как пользователь с правами доступа администратора.

  3. Убедитесь, что у вас сайт на порту 80, а HTTPS включён на порту 443. Это необходимо для разнообразия зашифрованных и незашифрованных вызовов в ArcGIS Enterprise. Для получения инструкций по созданию сайта обратитесь к документации продукта, специализирующейся на вашем сервере приложений на Java. Подробные сведения о настройке и использовании HTTPS см. в разделе Включение HTTPS на вашем веб-сервере.

    Примечание:

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

  4. Закройте все работающие приложения.

  5. Просмотрите загруженную папку с установкой ArcGIS Web Adaptor. Вы также можете вставить диск с ArcGIS Server или Portal for ArcGIS Media, чтобы автоматически начать установку.

Теперь вы готовы начать установку ArcGIS Web Adaptor.

  1. Убедитесь в том, что ваш компьютер отвечает всем системным требованиям. Для работы с сайтом сервера или порталом можно настроить только один Web Adaptor.

  2. Войдите в компьютер, на который устанавливаете ArcGIS Web Adaptor.

    Примечание:

    Вы должны войти в систему как пользователь с правами доступа администратора.

  3. Убедитесь, что у вас сайт на порту 80, а HTTPS включён на порту 443. Это необходимо для разнообразия зашифрованных и незашифрованных вызовов в ArcGIS Enterprise. Для получения инструкций по созданию сайта обратитесь к документации продукта, специализирующейся на вашем сервере приложений на Java. Подробные сведения о настройке и использовании HTTPS см. в разделе Включение HTTPS на вашем веб-сервере.

    Примечание:

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

  4. Просмотрите загруженную папку с установкой ArcGIS Web Adaptor. Вы также можете вставить диск с ArcGIS Server или Portal for ArcGIS Media, чтобы автоматически начать установку.

Теперь вы готовы начать установку ArcGIS Web Adaptor.

Установка ArcGIS Web Adaptor с помощью программы установки

Чтобы установить ArcGIS Web Adaptor с помощью программы установки, выполните следующие действия:

  1. Программа установки ArcGIS Web Adaptor должна запуститься автоматически по окончании загрузки. Если программа установки автоматически не запустилась, перейдите в папку, где находятся загруженные установочные файлы, и дважды щелкните Setup.exe.

  2. Прочитайте основное соглашение и примите его условия, если согласны. Для продолжения установки щелкните Далее.

  3. Выберите сайт с портом 80 для ArcGIS Web Adaptor. Возможные веб-сайты перечислены в виде <название веб-сайта (порт)>. Если диалоговое окно Выберите веб-сайт не появилось, значит, доступен только один веб-сайт. Если на вашем компьютере будет найден только один веб-сайт, то ArcGIS Web Adaptor будет автоматически установлен на этом веб-сайте, а диалоговое окно Выбрать веб-сайт не появится.

  4. Введите имя для Web Adaptor. По умолчанию задано название arcgis. Это имя экземпляра не должно содержать пробелы.

    Примечание:

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

  5. Для завершения процесса установки следуйте указаниям на экране.

Примечание:

Каждая установка Web Adaptor создаёт пул приложений со стандартными наименованиями ArcGISWebAdaptorAppPool<web adaptor name>.

  1. Запустите программу установки ArcGIS Web Adaptor Setup.exe и прочитайте условия использования программы в окне приветствия. Когда вы будете готовы продолжить установку, щелкните Далее.

  2. Прочитайте основное соглашение и примите его условия, если согласны. Для продолжения установки щелкните Далее.

  3. Щелкните Изменить, чтобы задать папку для установки, или нажмите Далее, чтобы установить программу в папку по умолчанию.

  4. Нажмите кнопку Установить, чтобы начать установку.

  5. Нажмите Готово, чтобы выйти из мастера.

  6. Зайдите в папку установки ArcGIS Web Adaptor. Разверните файл arcgis.war на сервере приложений Java на вебсайте, который работает на порту 80. Инструкции, как развернуть файл .war, см. в документации к серверу приложений Java.

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

  8. Подключите ArcGIS Web Adaptor к сайту сервера или порталу.

После установки ArcGIS Web Adaptor будет отображаться на языке, заданным вашим сервером приложений Java. Чтобы изменить язык, см. документацию к серверу приложений Java.

  1. Запустите программу установки ArcGIS Web Adaptor и ознакомьтесь с информацией в диалоговом окне Введение. Когда вы будете готовы продолжить установку, щелкните Далее.

  2. Прочитайте основное соглашение и примите его условия, если согласны. Для продолжения установки щелкните Далее.

  3. Чтобы установить продукт в папку по умолчанию, щелкните Далее или щелкните Выбрать, чтобы самостоятельно выбрать папку установки.

    Примечание:

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

  4. Нажмите кнопку Установить, чтобы начать установку.

  5. По завершении щелкните Готово, чтобы выйти из мастера.

  6. Зайдите в папку установки ArcGIS Web Adaptor. Разверните файл arcgis.war на сервере приложений Java на вебсайте, который работает на порту 80. Инструкции, как развернуть файл .war, см. в документации к серверу приложений Java.

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

  8. Подключите ArcGIS Web Adaptor к сайту сервера или порталу.

После установки ArcGIS Web Adaptor будет отображаться на языке, заданным вашим сервером приложений Java. Чтобы изменить язык, см. документацию к серверу приложений Java.

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

Примечание:

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

Примечание:

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

Установка ArcGIS Web Adaptor в автоматическом режиме

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

  • ACCEPTEULA=да

    Это свойство необходимо для принятия Лицензионного соглашения с конечным пользователем во время автоматической установки. Укажите Да, чтобы принять лицензионное соглашение и установить программное обеспечение. Если вы не отметите или не укажете это свойство, установка будет неудачной. Загружаемый файл содержит версию Лицензионного соглашения с конечным пользователем (EULA) в формате PDF. Файл EULA.pdf находится в папке \Documentation.

  • WEBSITE_ID=<числовое значение веб-сайта>

    Параметр WEBSITE_ID используется для задания веб-сайта, на котором будет создано веб-приложение ArcGIS Web Adaptor. Значением для WEBSITE_ID является число, определенное для каждого веб-сайта на вашем сервере, и назначенное с помощью IIS. Идентификаторы веб-сайтов вашего сервера могут быть найдены в IIS Manager. У сайта по умолчанию идентификатор ID будет 1. По умолчанию параметр WEBSITE_ID задается для веб-сайта по умолчанию (даже если существует несколько веб-сайтов). Параметр WEBSITE_ID чувствителен к регистру.

  • PORT=<номер порта>

    Кроме того, если ваш веб-сайт имеет множество портов, используйте параметр PORT для установки выбранного порта с WEBSITE_ID.

    Например, путем является <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb VDIRNAME=arcgis_external WEBSITE_ID=4059640 PORT=82.

  • VDIRNAME=<имя ArcGIS Web Adaptor>

    Это необязательный параметр командной строки. По умолчанию свойство VDIRNAME имеет значение arcgis. Если вы не использовали параметр VDIRNAME в командной строке, Web Adaptor будет создан с именем arcgis. Параметр VDIRNAME чувствителен к регистру. Имя Web Adaptor не должно содержать пробелов.

    Например, путем является <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb ACCEPTEULA=yes VDIRNAME=arcgis_external WEBSITE_ID=4059640.

  • CONFIGUREIIS=TRUE

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

Далее перечислены параметры командной строки Windows Installer, которые используются для установки ArcGIS Web Adaptor в автоматическом режиме:

  • ACCEPTEULA=да

    Это свойство необходимо для принятия Лицензионного соглашения с конечным пользователем во время автоматической установки. Укажите Да, чтобы принять лицензионное соглашение и установить программное обеспечение. Если вы не отметите или не укажете это свойство, установка будет неудачной. Загружаемый файл содержит версию Лицензионного соглашения с конечным пользователем (EULA) в формате PDF. Файл EULA.pdf находится в папке \Documentation.

  • INSTALLDIR=<установочная директория>

    Данное свойство позволяет вам задать установочную директорию для ArcGIS Web Adaptor в командной строке. Если вы не зададите это свойство, в качестве установочной директории по умолчанию будет использоваться расположение C:\Program Files\ArcGIS\WebAdaptor12.0\java\.

    Например:

    <path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes INSTALLDIR="C:\NewInstallDir" /qb

  • Для установки ArcGIS Web Adaptor в автоматическом режиме без указания директории установки используйте следующую команду:

    <path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes /qb

После установки ArcGIS Web Adaptor вы можете настроить его с помощью сайта сервера или портала.

Примечание:

После установки ArcGIS Web Adaptor будет отображаться на языке, задаваемом вашим сервером приложений Java. Чтобы изменить язык, см. документацию к серверу приложений Java.

Чтобы установить ArcGIS Web Adaptor в автоматическом режиме, выполните следующие действия:

  1. Перед началом установки ознакомьтесь с основным соглашением, которое находится в файле <CD_ROOT or untar directory>/Documentation/EULA.pdf, и, если вы согласны, примите его условия.

  2. В командной строке запустите автоматическую установку. Пример синтаксиса:

    <CD_ROOT or untar directory>/Setup -m silent -l yes

Использование: Setup [Опции]

Опция Описание
-m; --mode MODE Необязательно. По умолчанию GUI.

MODE либо автоматический, либо GUI.
-l; --license – agreement CHOICE Обязательный параметр для автоматического режима. CHOICE может быть "Да" или "Нет". "Да" означает, что вы прочли и приняли условия Основного соглашения Esri (E204, E300). Текст этого соглашения доступен на странице https://www.esri.com/legal/licensing-translations.
-d; --directory DIRECTORY Необязательно. По умолчанию ArcGIS Web Adaptor устанавливается в вашу директорию $HOME. DIRECTORY указывает другую директорию установки.

Путь /arcgis/webadaptor12.0/ добавлен в каталог установки.

Название каталога установки должно быть задано строчными буквами. Выборки и установленные данные требуют, чтобы путь к данным был задан строчными буквами.

Рекомендуется не устанавливать ArcGIS Web Adaptor на удалённый сетевой диск. Если удаленный диск окажется недоступным во время удаления программы, в процессе удаления может произойти сбой, и на диске останутся файлы.
-v; --verbose Программа установки работает в режиме вывода текстовых сообщений.
-h; --help Отображение справки командной строки и выход.
-e; --examples Отображаются примеры использования этих параметров и выходы.

  1. Зайдите в папку установки ArcGIS Web Adaptor и разверните соответствующий файл .war на вашем сервере приложений Java на веб-сайте с портом 80. Если вы используете Apache Tomcat 10.1.x, обязательно разверните файл arcgis_tomcat10.war. Для Tomcat 9.0.x и всех других серверов приложений Java необходимо развернуть файл arcgis.war. Инструкции, как развернуть файл .war, см. в документации к серверу приложений Java.

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

  3. После установки ArcGIS Web Adaptor вы можете настроить его с помощью сайта сервера или портала.

После установки ArcGIS Web Adaptor будет отображаться на языке, заданным вашим сервером приложений Java. Чтобы изменить язык, см. документацию к серверу приложений Java.

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