После 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. Чтобы идентифицировать эти сервисы, запустите утилиты в режиме 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.sh непосредственно оттуда или по ссылке к полному пути к директории. Вы должны выполнить вход в машину 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.sh -m analysis -o /Home/SharedDocs
Инструмент запускается и определяет, что пять сервисов на сайте 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.sh -m execution
Пока инструмент выполняется, администратор отслеживает HTML страницу результатов, чтобы просмотреть журнал для каждой задачи переноса. Когда инструмент завершил работу, каждый подходящий сервис был успешно перенесен в среду исполнения ArcGIS Pro.
Оставшиеся сервисы не могут быть перенесены. ГИС-специалист начинает создавать ресурсы в ArcGIS Pro для публикации.
Штатные ГИС-сотрудники также используют ArcGIS Enterprise SDK для перекомпиляции JavaRESTSOE, JavaMapExtension и CustomExtension SOEs. Когда они обновили SOE, они добавляют их обратно в каждый из четырех картографических сервисов.