ArcGIS Server web services transform the maps you author in desktop apps into web GIS resources.
The back-end structure of web services published from ArcGIS Pro are fundamentally different from those published from ArcMap. This structure, called a service runtime, determines the functions available in a service. Many newer capabilities of web services, such as the ability to use shared instances, are only supported by the ArcGIS Pro service runtime.
This difference in service runtime applies to ArcGIS Server web services only; it does not apply to hosted services. Therefore, there is no need to migrate or republish hosted services.
Beginning with ArcGIS Enterprise 11.0, ArcGIS Server no longer supports the ArcMap service runtime. You cannot publish services from ArcMap (including those published using the version of ArcPy installed with ArcMap) to ArcGIS Server sites.
When you upgrade ArcGIS Server from 10.9.1 or earlier to 11.0, you will see the following behavior for existing web layers:
- Existing map, image, and geodata services that use the ArcMap service runtime will be migrated to the ArcGIS Pro service runtime as part of the upgrade process.
- If any of the migrated map, image, or geodata services contain data that the ArcGIS Pro runtime does not support, the layers in the service will be inaccessible after you upgrade.
- Geocode and geoprocessing services that use the ArcMap service runtime will not function until you migrate or republish them.
The following sections summarize the process of getting your staff and web services ready. If you don't migrate or republish services that use the ArcMap service runtime before you upgrade, those services will no longer function after you upgrade the ArcGIS Server site.
Transition publishers to ArcGIS Pro
Publish all new ArcGIS Server web services from ArcGIS Pro. That means publishers in your organization need installations of ArcGIS Pro and time to learn that product if they are not already familiar with it.
Migrate existing services
To migrate ArcGIS Server 10.9 or 10.9.1 map, image, and geodata services from the ArcMap service runtime to the ArcGIS Pro service runtime before you upgrade to 11.0, you can use one of the following tools:
- In ArcGIS Server Manager, the Edit Runtime option is available for eligible services. This operation migrates services from the ArcMap service runtime to the ArcGIS Pro service runtime and can also be reversed to return to the ArcMap service runtime if the migrated service isn't working correctly. Some map service capabilities aren't supported by this operation and must be removed from the service before migrating.
- A command line tool—UpdateArcMapServices—is also available. It allows you to migrate services in bulk to the ArcGIS Pro service runtime. This tool supports migration of image services as well as map services. Before you migrate services, you can run the UpdateArcMapServices tool in analysis mode to determine which map and image services running on the ArcGIS Server site can be migrated and which ones have unsupported capabilities that you must disable before you can migrate them.
ArcMap can continue to consume the services after you migrate them to the ArcGIS Pro service runtime.
For more information on migrating services, see the technical paper Manually migrating services from the ArcMap-based to the ArcGIS Pro-based runtime.
Republish services that cannot be migrated
The following service types cannot be migrated. You must author them in ArcGIS Pro and publish new services for them to use the ArcGIS Pro service runtime.
The following table lists services you must republish from ArcGIS Pro and provides links to more information about publishing that type of service.
|Service type||Help to publish from ArcGIS Pro|
Publish web tools in ArcGIS Pro (to publish to a federated server)
Share a locator (to publish to a federated server)
Publish a geocode service (to publish to a stand-alone ArcGIS Server site)
Services that contain layer types that the ArcGIS Pro runtime does not support. These include raster catalogs, time-enabled layers created by the Tracking Analyst extension, and data stored in IBM Informix or IBM Db2 for z/OS.
When you run the UpdateArcMapServices tool in analysis mode, it identifies the map and image services that contain unsupported layer types.
For cached map and image services that contain unsupported layer types, you don't have to re-create the cache. You can delete the service that uses the ArcMap service runtime and publish a service from ArcGIS Pro that references the existing cache.
When you publish the service from ArcGIS Pro, the service must have the same name as the old service and it must reference the same data as the old service. When you publish, choose the Using an existing cache option and choose the directory that contains the existing cache, as described in the ArcGIS Pro help pages in the next column.
ArcGIS Workflow Manager (Classic) services
Run the Publish Workflow Service geoprocessing tool from ArcGIS Pro 2.9.
Migrate SOEs and SOIs
If any of the services you migrated or republished were using custom server object extensions (SOEs) or server object interceptors (SOIs), you must migrate the SOEs and SOIs from ArcObjects SDK to ArcGIS Enterprise SDK before you can add them back to the ArcGIS Pro runtime services. See the blog article, Migrating ArcObjects SOEs and SOIs to ArcGIS Enterprise SDK for more information.
Services that cannot be migrated or republished
You cannot migrate schematics services (map services with the schematics capability enabled) to the ArcGIS Pro service runtime or republish them from ArcGIS Pro.
If you are still using schematics services, do not upgrade the ArcGIS Server site past 10.9.1. If you no longer use the schematics service, though, you can upgrade the site and still use the map service. To do this, disable the Schematics capability from the map service in ArcGIS Server Manager and migrate the map service.