Skip To Content

Migrate a service in Server Manager

After ArcGIS Enterprise 10.9.1, ArcGIS Server will no longer support the ArcMap service runtime. Only services using the ArcGIS Pro service runtime will be supported, for both newly published services and existing services on an upgraded ArcGIS Server site.

While some services that use the ArcMap service runtime may continue to function on future versions of ArcGIS Server, Esri recommends that you migrate, republish, or remove all services that use the ArcMap service runtime prior to upgrading to any ArcGIS Server version released after 10.9.1.

Learn more about migrating services

You can use the Edit Runtime operation in ArcGIS Server Manager to migrate eligible ArcMap services to the ArcGIS Pro service runtime. The Edit Runtime operation does not change the service's content or settings.

The Edit Runtime operation works on one service at a time. The following conditions must apply:

After you use this operation to migrate a service's runtime, thoroughly test the service. If it's not working properly, you can use the same operation to revert the service to the ArcMap service runtime.

Tip:

If you changed the service to use shared instances after migrating but you to need revert the service to the ArcMap service runtime, you must configure the service to use dedicated instances again before you can migrate.

If you prefer to migrate multiple services in bulk, use the UpdateArcMapServices command line tool.

Migrate a service to the ArcGIS Pro service runtime

The following steps explain how to use the Edit Runtime operation in ArcGIS Server Manager to migrate a map, image, or geodata service to the ArcGIS Pro service runtime:

  1. Sign in to ArcGIS Server Manager as an administrator or the owner of the service to be migrated.
  2. Locate the service you want to migrate and click its Edit button Edit.

    If a service uses the ArcMap service runtime, a warning message appears that tells you to migrate the service.

    The service runtime is also listed on the General tab when editing the service.

    Service Runtime section on the General tab when editing a map service in ArcGIS Server Manager

  3. Before you migrate a map service, click the Capabilities tab to identify what is enabled on it.

    You can migrate services that have the following capabilities:

    • WCS
    • WFS
    • Network Analysis
    • KML
    • WMS
    • Feature Access

  4. If the map service has the Schematics capability, or if the service has any custom SOEs or SOIs enabled, uncheck the box next to each to disable them to make the service eligible for migration, and click Save and restart.

    Note:

    When you disable schematics, you can no longer use this service in schematics workflows. Similarly, disabling custom SOEs and SOIs means the custom functionality will no longer be available to users of the service until you migrate the SOE or SOI to the ArcGIS Enterprise SDK and add it back to the service. Ensure that no one is relying on these functions before you disable them.

    If you made any changes to the service's settings during this session, you must save those changes before you migrate the service. All unsaved changes to service settings will be lost.

  5. When the service restarts, click the Edit Runtime button Edit in the Service Runtime section of the General tab.

    Click the edit button in the Service Runtime section to begin migration.

    The Edit Runtime dialog box appears.

  6. Select the ArcGIS Pro (recommended) option on the dialog box and click Apply to begin the migration operation.

    If the service was running before you migrated it, the operation restarts the service when migration completes. The runtime displayed in the Service Runtime section now displays ArcGIS Pro. If the service was not running before you migrated it, you must start it.

  7. Ensure that the service functions properly in your applications. If you detect any functionality issues, return to the Edit Runtime dialog box and reverse the migration operation.

If necessary, migrate custom SOEs or SOIs from ArcObjects SDK to ArcGIS Enterprise SDK and add them back to the ArcGIS Pro runtime service. See the blog article, Migrating ArcObjects SOEs and SOIs to ArcGIS Enterprise SDK for more information.