Skip to main 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.

Before running this utility, you must define 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 is specified with the -u parameter.

-s

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

  • https://gisserver.example.com:6443

  • https://webadaptorhost.example.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 Caching tools and server resources for caching.

-AOI

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. This parameter is optional.

-extent

A rectangular extent defining where tiles are created. It is provided in the format xmin;ymin;xmax;ymax. This parameter is optional.

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

--ignoressl

An optional parameter to disable SSL certification verification.

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.example.com:6080 -n SanDiego:MapServer -scales "500000;250000;125000;66000" -mode RECREATE_ALL_TILES -i 3 -wait DO_NOT_WAIT

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