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.

Parameters

ParameterDetails

-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 is specified with the -u parameter.

-s

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

  • http://gisserver.domain.com:6080
  • http://webadaptorhost.domain.com/webadaptorname
If your site is configured with web-tier authentication, you'll need to specify the local URL to your site.

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

If you implemented logic that automates the execution of these utilities, you need to update your scripts to remove the Python dependencies. The following are examples:

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

In this topic
  1. Parameters
  2. Example