Skip To Content

Перенесение сервисов с утилитой UpdateArcMapServices

После ArcGIS Enterprise 10.9.1 ArcGIS Server больше не будут поддерживать среду исполнения ArcMap. Будут поддерживаться только сервисы исполнения ArcGIS Pro, как для новых опубликованных сервисов, так и для существующих сервисов на обновленном сайте сервера.

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

Более подробно о переносе сервисов

Утилита командной строки UpdateArcMapServices позволяет автоматизировать пакетный перенос поддерживаемых ГИС-сервисов. Утилита предлагает следующие два режима:

  • analysis - Запустите инструмент в режиме analysis, чтобы оценить, какие сервисы на вашем сайте уже готовы к переносу в среду запуска сервисов ArcGIS Pro.
  • execution - Когда вы знаете, какие сервисы можно перенести, и вы исправили условия, которые могут помешать переносу подходящего сервиса, запустите инструмент в режиме execution, чтобы перенести все подходящие сервисы в среду исполнения ArcGIS Pro. Перенос среды выполнения сервисов не повлияет на содержимое или настройки сервисов.

Предварительные условия для переноса среды выполнения сервисов

Утилита UpdateArcMapServices может перенести следующие типы сервисов:

  • Картографические сервисы (вместе с включенным WMS или без него)
  • Сервисы объектов (картографические сервисы с включенным доступом к объектам)
  • Сервисы изображений
  • Сервисы WMS (картографические сервисы с включенным WMS)
  • Сервисы WCS (картографические сервисы с включенным WCS)
  • Сервисы WFS (картографические сервисы c включенным WFS)
  • Сервисы сетевого анализа (картографические сервисы с включенным Сетевым анализом)

В отличие от операции Редактировать среду исполнения в ArcGIS Server Manager, утилита командной строки позволяет вам перенести еще и сервисы изображений, а не только картографические сервисы. Однако, до сих существуют ограничения на то, какие сервисы могут быть перенесены в среду исполнения сервисов ArcGIS Pro. Чтобы идентифицировать эти сервисы, запустите утилиты в режиме анализа. Окно результата и отчет HTML разбивают неподходящие сервисы на категории по причинам несоответствия.

Определенные функции растра, применяемые к сервису или источникам растровых данных в сервисе, не будут работать со средой исполнения ArcGIS Pro, например функции растра Python в Python 2 и функции растра с определенными цветовыми схемами. Отчет HTML не идентифицирует отдельные сервисы, которые содержат эти неподдерживаемые функции растра, но в отчете будет отмечено, что есть такие сервисы, запущенные на сайте ArcGIS Server и содержащие их. Перед переносом замените функции Python 2 на функции Python 3. Вы можете перенести эти сервисы без удаления неподдерживаемых функций, но перенесенный сервис не будет работать корректно при обращении к этим функциям. Если перенесенные сервисы не отображаются корректно из-за неподдерживаемых цветовых схем, обратитесь к технической поддержке Esri (если вы в США) или к дистрибьютору Esri (за пределами США).

Анализируются только сервисы, опубликованные из ArcMap. Сервисы, изначально опубликованные из ArcGIS Pro, нельзя перенести в среду исполнения ArcMap, и они не будут отображаться в списке анализируемых сервисов.

Экземпляры сервиса

Среда исполнения сервисов ArcGIS Pro поддерживает оба типа экземпляров картографических сервисов: назначенные и опубликованные. В соответствии с ними в ходе процесса переноса утилита назначает тип экземпляра каждому перенесенному картографическому сервису. Он будет основан на настройке типа экземпляра по умолчанию на вашем сайте ArcGIS Server.

Убедитесь, что вы учли все последствия этого перед началом переноса сервисов. Например, если типом экземпляра вашего сайта ArcGIS Server по умолчанию являются опубликованные экземпляры, и вы готовитесь к переносу сервиса, который получает большой трафик, подумайте об изменении сервиса таким образом, чтобы использовать выделенные экземпляры после переноса, чтобы гарантировать достаточное количество ресурсов. Если сервис имеет пользовательские SOE и SOI, и вы хотите перекомпилировать их и добавить их обратно в сервис после переноса, сервис не может использовать группу опубликованный экземпляров.

Более подробно о настройке параметров экземпляра сервиса

Доступ к утилите командной строки

Утилита переноса находится в папке <ArcGIS Server installation location>\tools\UpdateArcMapServices на вашем компьютере ArcGIS Server. Вы можете запустить файл UpdateArcMapServices.bat непосредственно оттуда или по ссылке к полному пути к директории. Вы должны выполнить вход в машину ArcGIS Server, используя логин учетной записи ArcGIS Server .

При запуске утилиты UpdateArcMapServices в любом режиме открывается страница HTML, где будут показаны результаты работы инструмента. В обоих режимах показано число сервисов, которые в настоящий момент доступны и недоступны к переносу. В режиме execution будут показаны журналы, связанные с операцией переноса, а также количество сервисов, которые были успешно перенесены в среду выполнения сервисов ArcGIS Pro.

Параметры

Утилита поддерживает следующие входные параметры:

ПараметрОписание

-m, --mode

Укажите режим, в котором вы хотите запустить инструмент: analysis (по умолчанию) оценивает и показывает сервисы, которые в настоящий момент доступны или недоступы для переноса, а режим execution выполняет перенос всех доступных сервисов в среду исполнения ArcGIS Pro.

-o, --output

Задайте папку, в которой будет создан файл отчета о работе инструмента. Если ее не указать, то инструмент создаст отчет во временной папке на машине, где вы запускаете утилиту.

-u, --username

Укажите имя пользователя для Первичного администратора сайта для сайта ArcGIS Server. Если учетная запись Первичного администратора сайта недоступна, укажите имя учетной записи администратора сервера или администратора портала (если сервер является интегрированным).

-h, --help

Вывод справки по утилите.

Пример использования

ГИС-администратор хочет, чтобы все сервисы организации использовали среду исполнения сервисов ArcGIS Pro. Сначала администратор выполняет вход в ArcGIS Server Manager, чтобы сделать список сервисов геообработки и геокодирования, выполняемых на сайте ArcGIS Server. Их нельзя перенести, можно только опубликовать заново.

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

ГИМ администратор выполняет вход на одну из машин на сайте ArcGIS Server с помощью логина, с которым запускается сервис ArcGIS Server. Администратор открывает командное окно, переходит в папку инструментов и запускает команду в режиме анализа. Поскольку отчет HTML будет опубликован для коллег, администратор указывает опубликованную папку для результатов.

cd <ArcGIS Server installation location>\arcgis\server\tools\UpdateArcMapServices

UpdateArcMapServices.bat -m analysis -o C:\\Desktop

Инструмент запускается и определяет, что пять сервисов на сайте ArcGIS Server в настоящий момент недоступны для переноса. Результаты отображаются в командной строке и выводятся в отчет HTML. В отчете показано, что четыре сервиса имеют неподдерживаемые свойства (код предупреждения 10900) и один сервис содержит слой неподдерживаемого типа (код предупреждения 10901).

WARNING: Service [Mapservice1] with extensions [JavaRESTSOE] enabled needs to be addressed. Code 10900.
WARNING: Service [Mapservice2] with extensions [JavaMapExtension] enabled needs to be addressed. Code 10900.
WARNING: Service [Mapservice3] with extensions [CustomExtension] enabled needs to be addressed. Code 10900.
WARNING: Service [Mapservice4] with extensions [JavaMapExtension,JavaRESTSOE] enabled needs to be addressed. Code 10900.
WARNING: Service [Imageservice] with data in layers [coral_reefs] needs to be addressed. Code 10901.

ГИС-специалисты просматривают отчет и проверяют каждый из пяти сервисов. Они определяют, что в четыре сервиса с неподдерживаемыми расширениями включены пользовательские SOE, и что еще один сервис содержит набор растровых данных. Чтобы разрешить перенести первые четыре сервиса, они отключают SOE от каждого сервиса в ArcGIS Server Manager. Потом они перекомпилируют SOE и добавляют их обратно в картографические сервисы после переноса в среду исполнения сервиса ArcGIS Pro.

Поскольку слои нельзя удалить из сервисов, они не перенесут сервис изображения. Сервис добавлен в список сервисов ГИС администратора для создания заново и публикации в ArcGIS Pro.

Когда SOE удалены из первых четырех, администратор запускает инструмент в режиме выполнения, чтобы перенести все соответствующие сервисы из среды исполнения ArcMap в среду исполнения ArcGIS Pro.

UpdateArcMapServices.bat -m execution

Пока инструмент выполняется, администратор отслеживает HTML страницу результатов, чтобы просмотреть журнал для каждой задачи переноса. Когда инструмент завершил работу, каждый подходящий сервис успешно перенесен в среду исполнения ArcGIS Pro.

Оставшиеся сервисы не могут быть перенесены. ГИС-специалист начинает создавать ресурсы в ArcGIS Pro для публикации.

ГИС-специалисты также используют ArcGIS Enterprise SDK для перекомпиляции SOE JavaRESTSOE, JavaMapExtension и CustomExtension. Когда они обновили SOE, они добавляют их обратно в каждый из четырех картографических сервисов.