Mettre à niveau le format de stockage d'un cache de serveur de carte

Résumé

Met à niveau le format de stockage de cache compact d'un service de carte ou d'imagerie (créé dans la version 10.2.2 ou des versions antérieures) afin de tirer parti des performances optimisées accessibles dans la version 10.3 et les versions ultérieures.

A partir de la version 10.3, le format de stockage de cache compact a été optimisé pour renforcer les performances lors de l'utilisation de services d'imagerie et de cartes mis en cache. Les améliorations ont également réduit le nombre de fichiers créés dans le répertoire de cache en intégrant les informations d'index de tuile (fichiers .bundlx) au sein des fichiers .bundle. Les nouveaux caches compacts créés avec ArcGIS 10.3 for Server (et versions ultérieures) utiliseront automatiquement les performances optimisées.

Si vous effectuez la mise à niveau vers la version 10.3 et les versions ultérieures, vos services comportant des caches compacts générés dans une version antérieure continueront de fonctionner. Vous pouvez continuer à gérer ces caches à l'aide des outils de cache de serveur.

Pour que votre cache actuel puisse utiliser les performances optimisées, procédez à la mise à niveau vers la version 10.3 (ou des versions ultérieures), puis mettez à niveau le cache à l'aide de cet outil. La mise à niveau du cache ne crée pas de nouvelles tuiles, mais les fichiers sont réorganisés pour être compatibles avec le format optimisé.

Le format de stockage de cache compact amélioré n'est pas compatible avec les versions antérieures d'ArcGIS. Par exemple, un cache compact créé ou mis à niveau avec la version 10.3 (ou des versions ultérieures) ne peut pas être transféré ni utilisé dans la version 10.2.2 (ou des versions antérieures) du logiciel. Le format de stockage de cache compact amélioré doit toujours être associée à un service.

Utilisation

• Pour utiliser cet outil, spécifiez le service de carte ou d'imagerie que vous souhaitez mettre à niveau. L'outil détecte le format de stockage courant du service et utilise ces informations pour déterminer si le cache peut être mis à niveau.

• Vous pouvez choisir le nombre d'instances de service à consacrer à la mise à niveau du cache en spécifiant une valeur dans le paramètre Nombre d'instances de service de mise en cache (num_of_caching_service_instances dans Python).

• Cet outil ne crée pas de nouvelles tuiles, mais les tuiles existantes sont réorganisées dans le même dossier pour être compatibles avec le format optimisé. L'ancien format est supprimé dans le cadre de la mise à niveau. Il est recommandé de sauvegarder votre cache existant avant d'exécuter cet outil.

• Si l'outil échoue ou est annulé au cours de l'opération, réexécutez-le pour relancer la tâche à partir du point d'échec ou d'annulation.

• Pour mettre à niveau un service de cache avec un format décomposé, utilisez l'outil Convertir le format d'un cache de serveur de carte.

Syntaxe

UpgradeMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})

Paramètre	Explication	Type de données
input_service	Service de carte ou d'imagerie que vous souhaitez mettre à niveau. Cette chaîne contient les informations relatives au serveur et au service. Pour savoir comment construire cette chaîne, ouvrez ArcCatalog, sélectionnez votre service dans l'arborescence du catalogue et notez le texte dans la barre d'outils Emplacement. Remplacez les barres obliques inverses par des barres obliques, par exemple, GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer.	String
num_of_caching_service_instances (Facultatif)	Nombre total d'instances du service des outils de mise en cache du dossier système que vous souhaitez utiliser pour exécuter cet outil. Vous pouvez augmenter le nombre maximal d'instances par machine du service des outils de mise en cache du dossier système en ouvrant la fenêtre Editeur de services via une connexion administrateur à ArcGIS Server. Assurez-vous que vos machines serveur peuvent prendre en charge le nombre d'instances sélectionné.	Long

Exemple de code

Exemple d'utilisation de l'outil Mettre à niveau le format de stockage d'un cache de serveur de carte (script autonome)

Le script autonome suivant illustre la mise à niveau du format de stockage de cache compact.

# 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 "

Environnements

Cet outil n'utilise pas d'environnement de géotraitement.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui