После обновления сайта ArcGIS Server до версии 11.0 или более новой, необходимо перенести, переопубликовать или удалить все сервисы, которые используют среду исполнения сервисов ArcMap. ArcGIS Server более не поддерживает служебную среду ArcMap, а сервисы, которые используют среду ArcMap, не работают. Будут поддерживаться только сервисы исполнения ArcGIS Pro, как для новых опубликованных сервисов, так и для существующих сервисов на обновленном сайте сервера.
Более подробно о переносе или повторной публикации сервисов
Утилита командной строки UpdateArcMapServices позволяет автоматизировать пакетный перенос поддерживаемых ГИС-сервисов. Утилита предлагает следующие два режима:
- analysis - Запустите инструмент в режиме analysis, чтобы оценить, какие сервисы на вашем сайте уже готовы к переносу в среду запуска сервисов ArcGIS Pro.
- execution - если вы знаете, какие сервисы можно перенести, и вы исправили условия, которые могут помешать переносу подходящего сервиса, запустите инструмент в режиме execution, чтобы перенести все подходящие сервисы в среду исполнения ArcGIS Pro. Перенос среды выполнения сервисов не повлияет на содержимое или настройки сервисов.
Предварительные условия для переноса среды выполнения сервисов
Утилита UpdateArcMapServices может перенести следующие типы сервисов:
- Картографические сервисы (вместе с включенным WMS или без него)
- Сервисы объектов (картографические сервисы с включенным доступом к объектам)
- Сервисы изображений
- Сервисы WMS (картографические сервисы с включенным WMS)
- Сервисы WCS (картографические сервисы с включенным WCS)
- Сервисы WFS (картографические сервисы c включенным WFS)
- Сервисы сетевого анализа (картографические сервисы с включенным Сетевым анализом)
- Сервисы геоданных
Утилита командной строки UpdateArcMapServices позволяет перенести изображения, геоданные и картографические сервисы. Однако существуют ограничения на то, какие сервисы могут быть перенесены в среду исполнения сервисов ArcGIS Pro. Чтобы определить сервисы, которые не могут быть перенесены, запустите утилиту в режиме analysis. Окно результата и отчет HTML разбивают неподходящие сервисы на категории по причинам несоответствия.
- Картографические сервисы и сервисы изображений с кодом 10900 содержат несовместимые возможности сервисов. Возможность Schematics или пользовательские расширения серверных объектов (SOE) или перехватчики серверных объектов (SOI) должны быть отключены в картографическом сервисе или сервисе изображений, чтобы его перенос стал возможен. (Вы можете перенести SOE и SOI и добавить их в перенесенные сервисы. Для получения дополнительной информации см. статью в блоге Перенос ArcObjects SOE и SOI в ArcGIS Enterprise SDK.
- Картографические сервисы с кодом 10901 содержат несовместимые типы слоев. Слои каталога растров и слои с поддержкой опции времени, созданные в дополнительном модуле Tracking Analyst, а также векторные слои из баз данных, не поддерживаемых в ArcGIS Pro, перенести нельзя.
- Сервисы геоданных, помеченные кодом 10903, были опубликованы из баз данных, которые не поддерживаются в ArcGIS Pro, в частности из тех, которые опубликованы bp IBM Db2 для баз данных z/OS и IBM Informix. Для сервисов геоданных, которые используют неподдерживаемую базу данных, вы должны переместить исходные данные в базу геоданных, которая поддерживается в ArcGIS Pro, прежде чем вы сможете повторно опубликовать их.
Определенные функции растра, применяемые к сервису или источникам растровых данных в сервисе, не будут работать со средой исполнения 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 в режиме analysis, чтобы определить, какие картографические сервисы, сервисы изображения или геоданных содержат неподдерживаемые свойства или слои.
ГИМ администратор выполняет вход на одну из машин на сайте ArcGIS Server с помощью логина, с которым запускается сервис ArcGIS Server. Администратор открывает командное окно, переходит в директорию с инструментами и запускает команду в режиме analysis. Поскольку отчет 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 удалены из первых четырех сервисов, администратор запускает инструмент в режиме execution, чтобы перенести все соответствующие сервисы из среды исполнения ArcMap в среду исполнения ArcGIS Pro.
UpdateArcMapServices.bat -m execution
Пока инструмент выполняется, администратор отслеживает HTML страницу результатов, чтобы просмотреть журнал для каждой задачи переноса. Когда инструмент завершил работу, каждый подходящий сервис был успешно перенесен в среду исполнения ArcGIS Pro.
Оставшиеся сервисы не могут быть перенесены. ГИС-специалисты начинают создавать ресурсы в ArcGIS Pro для повторной публикации.
Штатные ГИС-сотрудники также используют ArcGIS Enterprise SDK для перекомпиляции JavaRESTSOE, JavaMapExtension и CustomExtension SOE. Когда они обновили SOE, они добавляют их обратно в каждый из четырех картографических сервисов.