Delete Globe Server Cache

Summary

Deletes a layer or layers of an existing globe service cache and all tiles in them.

Usage

Legacy:

Parameters have changed for this tool at version 10.1. Models and scripts written prior to 10.1 that use this tool will need to be modified to work in 10.1.

• This is an unrecoverable operation so only use it if you are sure you no longer need the cache.

• This tool can be used to delete an existing globe server cache. To delete a cache, specify the ArcGIS Server (host) machine and select the globe service. The layers list will be populated with all available layers in the selected service.

• By default all layers of the service are displayed and selected. If you intend to delete only a particular layer's cache, make sure to unselect the ones for which you want to keep the cache.

• Delete Globe Server Cache deletes the entire cache folder. Note that after the Delete Globe Server Cache tool runs, it will restart the service. This will, in turn, generate a new set of caches for each layer in the service that was deleted by the delete operation. This is because all globe services require a cache configuration to exist on disk. The cache that gets created automatically on startup of a service is a skeleton representation that does not contain any tiles.

Syntax

DeleteGlobeServerCache_server (service, Layer)

Parameter	Explanation	Data Type
service	The globe service whose layer caches you want to delete. This is a string containing both the server and service information. To see how to construct this string, open ArcCatalog, select your service in the Catalog tree, and note the text in the Location toolbar. Then change the backslashes to forward slashes, for example, GIS Servers/arcgis on MYSERVER (admin)/Seattle.GlobeServer.	String
Layer	The layers in the globe service whose caches will be deleted. All layers of the service are included by default. If a layer is excluded the layer's cache will not be deleted.	String

Code Sample

This example deletes all layers of a cache for a globe service.

#DeleteGlobeServerCache example For ArcGIS Server 10.1 Beta(stand-alone script)

# Name: DeleteGlobeServerCache.py
# Description: The following stand-alone script deletes globe server cache
# Requirements: os, sys, time & traceback modules
# Author: ESRI

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
#                                                           "sys.argv[]"

# Import system modules
import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string

# Set environment settings
env.workspace = "C:/data"

# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
globeServiceName = "tstGlobeService.GlobeService"
globeService = connectionFile + "\\" + server + "\\" + globeServiceName
inputLayers = ""

currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1

# print results of the script to a report
report = open(file,'w')

try:
    starttime = time.clock()
    result = arcpy.DeleteGlobeServerCache_server(globeService, inputLayers)
    finishtime = time.clock()
    elapsedtime = finishtime - starttime

    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print "Deleted the GlobeServer cache successfully for globeservice "
    globeServiceName + "\n in " + str(elapsedtime) + " sec \n on " + arg2

except Exception, e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()
    
print "Deleted the globe server cache successfully"

Environments

This tool does not use any geoprocessing environments

Licensing Information

• ArcGIS for Desktop Basic: Requires 3D Analyst
• ArcGIS for Desktop Standard: Requires 3D Analyst
• ArcGIS for Desktop Advanced: Requires 3D Analyst

Feedback on this topic?