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 the format http://myserver:6080. |
-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