Zusammenfassung
Aktualisiert das Kompakt-Cache-Speicherformat einer Karte oder eines Image-Service (in 10.2.2 und früheren Versionen erstellt), um die Performance-Verbesserungen in 10.3 und höheren Versionen zu nutzen.
Ab 10.3 wurde das Kompakt-Cache-Speicherformat verbessert, um die Performance bei der Nutzung gecachter Karten- und Image-Services zu steigern. Durch Verbesserungen konnte außerdem die Anzahl der im Cache-Verzeichnis erstellten Dateien reduziert werden, indem die Kachelindexinformationen (.bundlx-Dateien) in die .bundle-Dateien eingefügt wurden. Neue Kompakt-Caches, die mit ArcGIS 10.3 for Server (und höheren Versionen) erstellt wurden, nutzen automatisch die Performance-Verbesserungen.
Wenn Sie auf 10.3 und höhere Versionen aktualisieren, bleibt die Funktionalität Ihrer Services mit Kompakt-Caches aus früheren Versionen erhalten. Sie können diese Caches weiterhin mit den Server-Cache-Werkzeugen pflegen.
Wenn Ihr bestehender Cache die Performance-Verbesserungen nutzen soll, aktualisieren Sie zunächst auf 10.3 (oder höhere Versionen), und aktualisieren Sie anschließend den Cache mit diesem Werkzeug. Beim Aktualisieren des Cache werden keine neuen Dateien erstellt, sondern die vorhandenen Dateien werden neu organisiert, damit sie mit dem verbesserten Format kompatibel sind.
Das verbesserte Kompakt-Cache-Speicherformat ist mit früheren Versionen von ArcGIS nicht rückwärtskompatibel. Beispielsweise lässt sich ein Kompakt-Cache, der in Version 10.3 (oder höheren Versionen) erstellt oder aktualisiert wurde, nicht in Version 10.2.2 (oder früheren Versionen) der Software übertragen oder dort verwenden. Das verbesserte Kompakt-Cache-Speicherformat muss immer mit einem Service verknüpft sein.
Verwendung
Um dieses Werkzeug zu verwenden, geben Sie den Karten- oder Image-Service an, den Sie aktualisieren möchten. Das Werkzeug erkennt das aktuelle Speicherformat des Service und verwendet dieses Format, um zu ermitteln, ob der Cache aktualisiert werden kann.
Sie können auswählen, wie viele Service-Instanzen für die Cache-Aktualisierung reserviert werden sollen, indem Sie einen Wert im Parameter Anzahl der Caching-Service-Instanzen (num_of_caching_service_instances in Python) angeben.
Mit diesem Werkzeug werden keine neuen Kacheln erstellt. Stattdessen werden die bestehenden Kacheln im selben Ordner neu organisiert, damit sie mit dem verbesserten Format kompatibel sind. Das alte Format wird als Teil der Aktualisierung gelöscht. Es empfiehlt sich, den vorhandenen Cache vor Ausführung dieses Werkzeugs zu sichern.
Wenn das Werkzeug während eines Vorgangs fehlschlägt oder abgebrochen wird, wird der Task an der Stelle erneut gestartet, an der er fehlgeschlagen bzw. abgebrochen wurde.
Verwenden Sie zum Aktualisieren eines Cache-Service mit erweitertem Format das Werkzeug Speicherformat des Kartenserver-Cache konvertieren.
Syntax
arcpy.server.UpgradeMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})
Parameter | Erklärung | Datentyp |
input_service | Der Karten- oder Image-Service-Cache, den Sie aktualisieren möchten. Diese Zeichenfolge enthält die Server- und Service-Informationen. Um zu erfahren, wie diese Zeichenfolge erstellt wird, öffnen Sie ArcCatalog, wählen Sie Ihren Service im Kataloginhaltsverzeichnis aus, und beachten Sie den Text in der Werkzeugleiste Verzeichnis. Ändern Sie dann die umgekehrten Schrägstriche in Schrägstriche, z. B. GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer. | String |
num_of_caching_service_instances (optional) | Die Gesamtzahl der Instanzen des Service "System/CachingTools", die Sie zum Ausführen dieses Werkzeugs reservieren möchten. Sie können die Maximale Anzahl von Instanzen pro Computer des Service "System/CachingTools" mithilfe des Fensters Service-Editor erhöhen, das über eine administrative Verbindung zu ArcGIS-Server verfügbar ist. Stellen Sie sicher, dass die Servercomputer die ausgewählte Anzahl von Instanzen unterstützen können. | Long |
Codebeispiel
Speicherformat des Kartenserver-Cache aktualisieren – Beispiel (eigenständiges Skript)
Das folgende eigenständige Skript veranschaulicht, wie das Kompakt-Cache-Speicherformat aktualisiert wird.
# 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 "
Umgebungen
Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja