Skip To Content

Convert Cache Storage Format utility

In this topic

The Convert Cache Storage Format utility allows you to change the storage format of a map cache from the command line. If the cache was originally stored in the exploded format, it is converted to the compact format. If the cache was originally stored in the compact format, it is converted to the exploded format.

See Available map cache properties to learn more about cache storage formats.

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

-s

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

  • http://gisserver.domain.com:6080
  • http://webadaptor.domain.com/arcgis
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 format you want to convert. This is provided using the syntax <Service name>:<Service type>.

-i

The number of instances of the ArcGIS Server CachingTools service to use for the job. See Allocation of server resources to caching.

-h

Prints help for the utility.

Example

The following example converts the storage format of 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/convertcachestorageformat -u admin -p admin -s http://gisserver.domain.com:6080 -n SanDiego:MapServer -i 2