Skip To Content

Manage Cache Tiles utility

The Manage Cache Tiles utility allows you to manage map or image service cache tiles from the command line. You can add or delete tiles from a cache using this utility.

Prior to running this utility, you should have defined a cache for the service. You can do this with the Create Cache Schema utility.




The name of an ArcGIS Server user who will execute the utility. The user must have the appropriate level of privileges to execute the action. If your site is configured with web-tier authentication, specify a built-in user, such as the primary site administrator account.


The password of the user who was specified with the -u parameter.


The URL of the site, in one of the following formats:

If your site is configured with web-tier authentication, you'll need to specify the local URL to your site.


The name of the service whose cache tiles you want to manage. If the service is in the root directory, use the syntax <Service name>:<Service type>. If the service is in a folder, use the syntax <Folder name>/<Service name>:<Service type>.


The scales for which you want to manage cache tiles, provided as a semicolon-delimited string such as 12000;6000;3000. Ensure that the scales are listed from smallest scale to largest scale.


The update mode, defining whether you want to create tiles, create only tiles that are currently empty, or delete tiles. The respective available values are RECREATE_ALL_TILES | RECREATE_EMPTY_TILES | DELETE_TILES.


The number of instances of the ArcGIS Server CachingTools service to use for this job. See Allocation of server resources to caching.


Optional. The path to a feature class whose boundaries will define where tiles are created. This can save time and storage space when caching irregularly shaped geographies.


Optional. A rectangular extent defining where tiles are created. Provided in the format xmin;ymin;xmax;ymax.


Defines whether the utility should run synchronously (WAIT) or asynchronously (DO_NOT_WAIT). If you choose to let it run asynchronously, you can continue running other commands while the utility is running.


Prints help for the utility.


The following example creates cache tiles for a map service named SanDiego.

<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\" -u admin -p admin -s -n SanDiego:MapServer -scales "500000;250000;125000;66000" -mode RECREATE_ALL_TILES -i 3 -wait DO_NOT_WAIT

In this topic
  1. Parameters
  2. Example