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. If your site is configured with web-tier authentication, specify a built-in user, such as the primary site administrator account. |
-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:
|
-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. Ensure that the scales are listed from smallest scale to largest scale. |
-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 the ArcGIS Server 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. |
-h | Prints help for the utility. |
Example
The following example creates cache tiles for a map service named SanDiego.
Legacy:
At 10.2.2 and earlier versions, you were required to reference the Python directory and Python extension (.py) when executing the utilities from the command line. At 10.3, this is no longer required. You can run the utilities directly from the command line without referencing these Python dependencies.
If you implemented logic that automates the execution of these utilities, you need to update your scripts to remove the Python dependencies, for example:
- <ArcGIS Server installation location>/arcgis/server/tools/python
- The .py extension when referring to the name of the command line utility
See the following example below for correct usage:
<ArcGIS Server installation location>/arcgis/server/tools/admin/managecachetiles -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