管理地图服务器缓存状态 (Server)
摘要
管理服务器所保存的与地图或影像服务缓存中的构建切片有关的内部数据。
用法
- 此工具可移除或重建在 ArcMap 或 ArcGIS Server 管理器中报告的缓存完成状态信息。
手动将切片复制到缓存目录或按需构建切片后，您可使用此工具重建缓存状态。
只能使用此工具构建先前版本的 ArcGIS Server 所创建的缓存的状态。
您也可以选择使用此工具只针对自定义感兴趣区域及比例级别创建状态报告，而无需为整个缓存创建状态。通过将管理模式 (manage_mode) 参数设置为 REPORT_BUNDLE_STATUS 可实现此操作。该报告存储在一个名为 Status.gdb 的新文件地理数据库中，具体位置是在一个可通过 ArcMap 显示及查看的名为 TaskStatus 的要素类中。
请注意，缓存目录同时包含一个与整个缓存相关的 Status.gdb，并在其他管理模式选项用于此工具时更新。在此位置无法替换自定义 Status.gdb。
语法
| 参数 | 说明 | 数据类型 |
input_service | 将修改其状态的地图或影像服务。 这是一个包含服务器和服务器信息的字符串。要查看构建此字符串的方法，请打开 ArcCatalog，选择“目录”树中的服务，并注意位置 工具条中的文本。然后将反斜线改为正斜线，例如，MYSERVER (admin)/USA.MapServer 上的 GIS Servers/arcgis。 | String |
scales (可选) |
将修改其状态的比例级别。此参数仅适用于使用 REPORT_BUNDLE_STATUS 选项为manage_mode参数构建自定义状态的情况。 | Double |
manage_mode |
| String |
num_of_caching_service_instances (可选) |
专用于运行该工具的系统/缓存工具服务实例的总数。您可以通过与 ArcGIS Server 的管理连接，使用 服务编辑器 窗口，增加系统/缓存工具服务的每台计算机的最大实例数。确保您的服务器计算机可以支持所选数量的实例。 默认情况下，此工具使用三个实例（如果允许使用三个）。在此工具中使用较大数量的实例可能会导致操作速度减慢。 | Long |
report_folder (可选) |
Status.gdb 的输出文件夹。此参数仅适用于使用 REPORT_BUNDLE_STATUS 选项构建自定义状态的情况。 运行 ArcGIS for Desktop 的帐户需要拥有对此文件夹的写入权限。 此文件夹中必须还没有 Status.gdb。 | Folder |
report_extent (可选) |
定义构建状态区域的矩形范围。此参数仅适用于使用 REPORT_BUNDLE_STATUS 选项构建自定义状态的情况。 请注意，感兴趣区参数可指定非矩形感兴趣区。 | Extent |
area_of_interest (可选) |
感兴趣区(面)决定着状态报告将覆盖的地理形态。它可能是一个要素类，也可能是在 ArcMap 中以交互方式定义的要素。此参数仅适用于使用 REPORT_BUNDLE_STATUS 选项构建自定义状态的情况。 | Feature Set |
代码实例
ManageMapServerCacheStatus 示例
删除缓存的状态信息。
# Name: ManageMapServerCacheStatus.py
# Description: The following stand-alone script demonstrates how to delete
# Status of cache using ManageMapServerCachStatus tool
# Requirements: os, sys, time and traceback modules
# 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)"
serviceName = "Rainfall.MapService"
inputService = connectionFile + "\\" + server + "\\" + serviceName
scales = ""
manageMode = "DELETE_CACHE_STATUS"
numOfCachingServiceInstances = "2"
outputFolder = ""
areaOfInterest = ""
reportExtents = ""
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')
# use "scales[0]","scales[-1]","scales[0:3]"
try:
starttime = time.clock()
result = arcpy.ManageMapServerCacheStatus_server(inputService, scales[-1],
manageMode,
numOfCachingServiceInstances,
outputFolder,
areaOfInterest,
reportExtents)
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 "Reported the Bundle status for scale =" + str(scales[-1]) + "of "
serviceName + "at " + outputFolder + "\n using specified feature class "
areaOfInterest + " 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 step 3 \n" "Line %i" % tb.tb_lineno)
report.write(e.message)
report.close()