Convertir le format d’un cache de serveur de carte (Serveur)

Synthèse

Convertit le stockage d’une couche d’images de carte ou d’un cache de service d’imagerie ou de carte entre le format éclaté et le format compactV2.

Attention :

L’outil convertit le format in situ, ce qui signifie qu’il ne fait pas de copie du format existant du cache. Il crée plutôt le nouveau format du cache dans le même dossier de cache et supprime l’ancien format. Veillez à faire une sauvegarde du cache avant d’exécuter cet outil si vous comptez rétablir l’ancien format.

Utilisation

  • Dans ArcGIS Enterprise, le paramètre Service d’entrée est une chaîne qui contient l’extrémité REST du service. Assurez-vous que votre portail ArcGIS Enterprise est le portail actif.

    Dans un déploiement ArcGIS Server autonome, le paramètre Service d’entrée est une chaîne qui contient les informations relatives au serveur et au service. Pour construire la chaîne, ajoutez le chemin complet d’accès au fichier de connexion ArcGIS Server (.ags), avec des identifiants de connexion Publication ou Administration, au nom du service sur le serveur autonome, par exemple : "C:\path_to_the connection_file_of_standAloneServer\arcgis on MyServer.com_6443.ags\ServiceName.MapServer". Pour plus d’informations, reportez-vous à la rubrique Se connecter à un serveur SIG.

  • L’outil détecte le format de stockage actuel du service en entrée et définit en conséquence le format cible au format opposé. Vous pouvez indiquer le nombre d’instances de service à consacrer à la conversion du cache à l’aide du paramètre Nombre d’instances de service de mise en cache. La valeur par défaut -1 utilise toutes les instances d’outil de mise en cache de l’installation ArcGIS Enterprise. Définissez une valeur inférieure pour utiliser moins d’instances d’outil de mise en cache. Vous pouvez augmenter la valeur du paramètre Nombre maximum d’instances par machine du service System/CachingTools dans la fenêtre Éditeur de services, disponible via une connexion de niveau administrateur à ArcGIS Server. Assurez-vous que les machines serveur peuvent prendre en charge le nombre d’instances défini. Dans le cas d’une connexion à un serveur autonome, le nombre par défaut d’instances correspond à la valeur du paramètre Nombre maximal d’instances du service d’outil de mise en cache.

Paramètres

ÉtiquetteExplicationType de données
Service d'entrée

Service de carte ou d’imagerie dont le format du cache doit être converti. Dans ArcGIS Enterprise, il s’agit d’une chaîne qui contient l’extrémité REST de la couche d’images de carte. Dans un déploiement ArcGIS Server autonome, il s’agit d’une chaîne qui contient les informations relatives au serveur et au service.

Image Service; Map Server
Nombre d’instances de service de mise en cache
(Facultatif)

Nombre total d’instances du service System/CachingTools à dédier à l’exécution de cet outil. Lorsque la valeur par défaut -1 est utilisée, toutes les instances d’outil de mise en cache de l’installation ArcGIS Enterprise sont utilisées. Définissez une valeur inférieure pour utiliser moins d’instances d’outil de mise en cache.

Vous pouvez augmenter la valeur du paramètre Nombre maximum d’instances par machine du service System/CachingTools dans la fenêtre Éditeur de services, disponible via une connexion de niveau administrateur à ArcGIS Server. Assurez-vous que les machines serveur peuvent prendre en charge le nombre d’instances défini.

Dans le cas d’une connexion à un serveur autonome, le nombre par défaut d’instances correspond à la valeur du paramètre Nombre maximal d’instances du service d’outil de mise en cache.

Long

Sortie obtenue

ÉtiquetteExplicationType de données
URL de service de carte en sortie

L’URL en sortie.

String

arcpy.management.ConvertMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})
NomExplicationType de données
input_service

Service de carte ou d’imagerie dont le format du cache doit être converti. Dans ArcGIS Enterprise, il s’agit d’une chaîne qui contient l’extrémité REST de la couche d’images de carte. Dans un déploiement ArcGIS Server autonome, il s’agit d’une chaîne qui contient les informations relatives au serveur et au service.

Image Service; Map Server
num_of_caching_service_instances
(Facultatif)

Nombre total d’instances du service System/CachingTools à dédier à l’exécution de cet outil. Lorsque la valeur par défaut -1 est utilisée, toutes les instances d’outil de mise en cache de l’installation ArcGIS Enterprise sont utilisées. Définissez une valeur inférieure pour utiliser moins d’instances d’outil de mise en cache.

Vous pouvez augmenter la valeur du paramètre Nombre maximum d’instances par machine du service System/CachingTools dans la fenêtre Éditeur de services, disponible via une connexion de niveau administrateur à ArcGIS Server. Assurez-vous que les machines serveur peuvent prendre en charge le nombre d’instances défini.

Dans le cas d’une connexion à un serveur autonome, le nombre par défaut d’instances correspond à la valeur du paramètre Nombre maximal d’instances du service d’outil de mise en cache.

Long

Sortie obtenue

NomExplicationType de données
out_job_url

L’URL en sortie.

String

Exemple de code

Exemple d’utilisation de l’outil ConvertMapServerCacheStorageFormat

Convertit le cache d’un serveur de carte d’un format de stockage vers l’autre.

# Name: ConvertMapServerCacheStorageFormat.py
# Description: The following stand-alone script demonstrates how to convert map
#               server cache storage format to the alteranate storage format for
#               a weblayers/map or image service based on
#               ArcGIS Enterprise or a stand alone ArcGIS Server

import arcpy
import os

# Sign in to portal
myPortal= "https://www.myArcGISEnterprise.com/webadaptor"
arcpy.SignInToPortal(myPortal, "MyUserName", "MyPassword")
serviceName= "MyCounty"
serviceType= "MapServer"
myPortalServiceURL = (myPortal + "/" + "rest/services" +"/" + serviceName + "/" + serviceType)


# Stand alone ArcGIS Server
target_server_connection = r"C:\Project\gisserver.ags.esri.com (publisher).ags"
serviceName= "MyCounty"
serviceType= "MapServer"
myServerServiceURL= target_server_connection + "/" + serviceName + "." + serviceType

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

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

try:
    #result = arcpy.server.ConvertMapServerCacheStorageFormat(myPortalServiceURL, -1)
    result = arcpy.server.ConvertMapServerCacheStorageFormat(myServerServiceURL, -1)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))
    
except Exception as e:
    
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()

print ("Converted Map Server Cache Storage format for " + serviceName)

Environnements

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