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.

Parameters

Parameter

Details

-u

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.

-p

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

-s

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

  • http://gisserver.domain.com:6080
  • http://webadaptor.domain.com/arcgis

-n

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>.

-scales

The scales for which you want to manage cache tiles, provided as a semicolon-delimited string such as "12000;6000;3000".

-mode

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.

-i

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

-AOI

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.

-extent

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

-wait

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.

-t

Passes the token to the server when the utility is executed. If this parameter is omitted, HTTP authentication is used.

-h

Prints help for the utility.

Example

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

<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\manageCacheTiles.py" -u admin -p admin -s http://gisserver.domain.com:6080 -n SanDiego:MapServer -scales "500000;250000;125000;66000" -mode RECREATE_ALL_TILES -i 3 -wait DO_NOT_WAIT -t
9/1/2015