Resumen
Actualiza el formato de almacenamiento en caché compacto de un mapa o un servicio de imágenes (creado con la versión 10.2.2 o anteriores) con el fin de aprovechar las mejoras en el rendimiento de la versión 10.3 y las versiones posteriores.
A partir de la versión 10.3, se introdujeron mejoras en el formato de almacenamiento del caché compacto con el fin de mejorar el rendimiento cuando se consumen servicios de mapas y de imágenes en caché. Las mejoras también sirvieron para reducir el número de archivos que se crean en el directorio del caché incluyendo la información sobre el índice de teselas (los archivos .bundlx) dentro de los archivos .bundle. Las nuevas cachés compactas creadas con ArcGIS 10.3 for Server (y versiones posteriores) aprovecharán automáticamente las mejoras en el rendimiento.
Si se actualiza a la versión 10.3 o una versión posterior, los servicios con cachés compactas generados en las versiones anteriores seguirán funcionando. Puede mantener estas cachés usando las herramientas de la caché del servidor.
Si desea que la caché existente aproveche las mejoras en el rendimiento, actualice a la versión 10.3 (o una versión posterior) y, a continuación, actualice la caché con esta herramienta. Al actualizar la caché no se crean nuevas teselas. En lugar de eso, los archivos se reorganizan de modo que sean compatibles con el formato mejorado.
El formato compacto de almacenamiento en caché mejorado no es compatible con las versiones anteriores de ArcGIS. Por ejemplo, una caché compacta creada o actualizada con la versión 10.3 (o una versión posterior) no se puede transferir y consumir en la versión 10.2.2 (o una versión anterior) del software. El formato compacto de almacenamiento en caché mejorado debe estar asociado siempre con un servicio.
Uso
Para utilizar esta herramienta, especifique el servicio de mapas o imágenes cuya caché desee actualizar. La herramienta detecta el formato de almacenamiento actual del servicio y utiliza esa información para determinar si se puede actualizar la caché.
Puede elegir cuántas instancias de servicio dedicar a la actualización de la caché especificando un valor en el parámetro Número de instancias de servicio de almacenamiento en caché (num_of_caching_service_instances en Python).
Esta herramienta no crea teselas nuevas. En lugar de eso, las teselas existentes se reorganizan en la misma carpeta de modo que sean compatibles con el formato mejorado. El formato antiguo se elimina como parte de la actualización. Es recomendable realizar copias de seguridad de la caché existente antes de ejecutar esta herramienta.
Si la herramienta falla o se cancela durante la operación, al volver a ejecutar la herramienta la tarea se reanudará allí donde haya fallado o se haya cancelado.
Para actualizar un servicio de caché en formato expandido, utilice la herramienta Convertir formato de almacenamiento de caché del servidor de mapas.
Sintaxis
arcpy.server.UpgradeMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})| Parámetro | Explicación | Tipo de datos |
input_service | Caché de mapa o servicio de imágenes que se desea actualizar. Esta cadena de caracteres contiene la información del servidor y del servicio. Para ver cómo construir esta cadena de caracteres, abra ArcCatalog, seleccione el servicio en el árbol Catálogo y anote el texto en la barra de herramientas Ubicación. A continuación, cambie las barras invertidas por barras normales, por ejemplo, GIS Servers/arcgis en MYSERVER (admin)/USA.MapServer.Servidor de mapas MapServer. | String |
num_of_caching_service_instances (Opcional) | El número total de casos del servicio System/CachingTools que desea dedicar a ejecutar esta herramienta. Puede aumentar la cantidad máxima de instancias por equipo del servicio System/CachingTools utilizando la ventana Editor de servicio disponible a través de una conexión administrativa a ArcGIS Server. Asegúrese de que los equipos de servidor son compatibles con el número de instancias elegidos. | Long |
Muestra de código
Ejemplo de Actualizar formato de almacenamiento de caché del servidor de mapas (secuencia de comandos independiente)
La secuencia de comandos independiente siguiente muestra cómo se actualiza el formato del almacenamiento de caché compacto.
# Name: UpgradeMapServerCacheStorageFormat.py
# Description: The following stand-alone script demonstrates how to upgrade map
# server cache storage format to the latest compact storage format
# Requirements: os, sys, time, 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, string, datetime, traceback
# Set environment settings
env.workspace = "C:/data"
# Set local variables for mapservice properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.3\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
numOfCachingServiceInstances = "2"
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')
# Execute UpgradeMapServerCacheFormat
try:
starttime = time.clock()
result = arcpy.UpgradeMapServerCacheStorageFormat_server(inputService,
numOfCachingServiceInstances)
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 "Upgraded Map Server Cache Storage format for " + serviceName + " 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 1 \n" "Line %i" % tb.tb_lineno)
report.write(e.message)
report.close()
print "Upgraded Map Server Cache Storage format "
Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí