Overwrite a map service

You can overwrite a map service that has been published to a stand-alone ArcGIS Server 10.6 or later. Reasons to overwrite a map service include updating source data, changing map or layer properties (such as layer symbology), editing the item description, and setting different configuration properties. When you overwrite a map service, any maps that use the service in client applications are updated.

Overwriting a map service is similar to publishing a map service. You can change most of the properties of a map service when you overwrite it, including both properties of the map itself and configuration settings. You can't change the name of the service or its location (the service URL). If you are overwriting a cached map service, see the section Cached map service considerations, below.

  1. Open the ArcGIS Pro project that contains the map that you published as a map service.

    Typically, you overwrite a map service with the same map (modified or not) that you previously published from ArcGIS Pro. However, it is possible to overwrite a map service with a different map, either in the same project or in a different project, as long as the project contains a publisher or administrator connection to the server.

  2. Optionally make changes to the map or its layers.
  3. In the Catalog pane, on the Project tab, expand Servers and browse to the map service you want to overwrite.
  4. Right-click the service and click Overwrite Overwrite.
  5. On the Select Map dialog box, browse to the map you want to use to overwrite the service and select it. Click OK.

    The Overwrite Map Service pane appears. On the General tab, under Service Details, the name of the map service is displayed. This name can't be changed. Under the name, you can use the item description from the published service (the default) or update the item description from the map you are using to overwrite the service.

  6. Accept the default item description setting or click Use the item description from the map.

    If you use the item description from the map, and the map does not currently have a summary or tags, you need to enter values in the Summary and Tags fields.

  7. Optionally, under Data, change the option to reference registered data or copy all data to the server.

    For information about the data options, hover over the Information icon Information.

  8. Optionally click the Configuration tab at the top of the pane and change any capabilities or service properties of the service.

    For information about capabilities and service properties, see Configure a map service.

  9. Optionally click the Content tab to view the new service structure and its sublayers.
  10. Click Analyze to identify potential issues or limitations.

    The Messages tab reports any errors or warnings. Right-click a message to open a help topic with information and recommended solutions. See Analyze your GIS resource for details.

  11. Once you have resolved any errors, and optionally resolved any warnings, click Publish.
  12. When the service is successfully overwritten, click the Manage the map service link at the bottom of the pane to access the service REST endpoint.

    If you configured your service to draw using tiles from a cache, you can click the Jobs button under Finish Publishing to view the cache generation status in the Job Status pane.

Cached map service considerations

When you overwrite a map service that is drawn using tiles from a cache (a cached map service), you can choose whether to keep the existing cache. If you keep the existing cache, you can change many configuration properties of the service. For example, you can increase the visible range of the service by publishing additional levels of detail at either end of the range. However, you can't change the tiling scheme, image format, compression, or cache directory.

Cache extent settings made when you published the map service previously are not preserved. By default, when you overwrite the service, the map extent is cached. Optionally you can cache tiles for an area of interest. In either case, tiles are cached only for the levels of detail that you select in the Build Tiles and Calculate dialog box.

Also, if you keep the existing cache, the map you use to overwrite the service must have the same spatial reference as the service and a spatial extent that overlaps the service.

If you choose not to keep the existing cache, you can change all configuration properties of the service, including the tiling scheme and cache directory. Essentially, this is the same as publishing a new map service, except that the service URL does not change.

If you choose not to keep the existing cache, the tiles that were built for the previously published map service are disassociated from the service and new tiles are built. The old tiles are associated with an automatically generated service named <service_name>_<timestamp>. This service can be deleted from the server at your convenience.

Follow the steps below to access the Keep existing cache setting:

  1. At the top of the Overwrite Map Service pane, click the Configuration tab.
  2. Under Capabilities, next to Map, click the Configure Service Properties button Configure Service Properties.
  3. Under Caching, check or uncheck the Keep existing cache box.

Related topics