An overview of the Caching toolset
The Caching toolset creates and manages caches for faster display of map, image, and globe services. The caches consist of pregenerated images that the server can distribute to clients. Tools with Map Server in the name work with map and image services; tools with Globe Server in the name work with globe services.
Creating a cache requires the server to generate many map images and save them to disk. Depending on the area and scales covered, the caches can become very large, taking many gigabytes of space. Some of the tools can take a long time to run, and you should read the Caching services book of the help for guidelines on how to plan your cache and anticipate the creation time.
Many of the tools in this toolset are especially appropriate for scripting. For example, Manage Map Server Cache Tiles can be run on a regular basis to update the tiles in a cache with the latest available data. See Automating cache creation and updates with geoprocessing to learn more.
The parameters of many of the tools in the Caching toolset have changed between versions 10 and 10.1. If you are using tools from this toolset in any existing models or scripts, check the tool reference help carefully to understand how to migrate to 10.1.
When moving to 10.1 Service Pack 1, you must open and validate any models that use Export Map Server Cache or Import Map Server Cache because these tools have a new parameter. This process is described in Automating cache creation and updates with geoprocessing.
Tool |
Description |
---|---|
Converts the storage of a map or image service cache between the exploded format and the compact format. The tool converts the format in place, meaning it does not make a copy of the existing format of the cache. Instead, it creates the new format of the cache in the same cache folder and deletes the old format. | |
Creates the tiling scheme and preparatory folders for a map or image service cache. After running this tool, run Manage Map Server Cache Tiles to add tiles to the cache. |
|
Deletes a layer or layers of an existing globe service cache and all tiles in them. |
|
Deletes an existing map or image service cache, including all associated files on disk. |
|
Exports tiles from a map or image service cache as a cache dataset or as a tile package to a folder on disk. The tiles can either be imported into other caches or they can be accessed from ArcGIS for Desktop or mobile devices as a raster dataset, independently from their parent service. | |
Generates an XML tiling scheme file that defines the scale levels, tile dimensions, and other properties for a map service cache. This tool is useful when creating a tiling scheme to use in multiple caches. You can load the tiling scheme file when you create a cache in ArcGIS for Desktop or ArcGIS Server Manager, or you can run Create Map Server Cache and pass in the tiling scheme file as a parameter. |
|
Imports tiles from a folder on disk into a map or image service cache. The source folder can be a child of a registered server cache directory, a folder into which a cache has been previously exported, or a tile package (.tpk).The target service must have the same tiling scheme and the storage format as the source cache. | |
Creates and updates tiles in an existing globe service cache. This tool is used to create new tiles or to replace missing tiles, overwrite outdated tiles, or add new tiles. All these actions can be defined by rectangular extents or by a polygon feature class. When creating new tiles, you can choose whether to create only empty tiles or re-create all tiles. |
|
Updates the scale levels in an existing cached map or image service. Use this tool to add new scales or delete existing scales from a cache. |
|
Manages internal data kept by the server about the built tiles in a map or image service cache. | |
Creates and updates tiles in an existing map or image service cache. This tool is used to create new tiles, replace missing tiles, overwrite outdated tiles, and delete tiles. |