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

Résumé

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 Input Service (Service en entrée) est une chaîne qui contient le point de terminaison REST du service. Assurez-vous que votre portail ArcGIS Enterprise est le portail actif.

Dans un déploiement ArcGIS Server autonome, le paramètre Input Service (Service en 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 les informations d’identification 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 le format opposé comme format cible. Vous pouvez spécifier le nombre d’instances de service à dédier à la conversion du cache à l’aide du paramètre Number of caching service instances (Nombre d’instances du service de mise en cache). La valeur par défaut -1 utilise toutes les instances de l’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 Maximum number of instances per machine (Nombre maximal d’instances par machine) du service System/CachingTools dans la fenêtre Service Editor (Éditeur de services), disponible via une connexion de type 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 d’instances par défaut correspond à la valeur du paramètre Maximum number of instances (Nombre maximal d’instances) du service d’outil de mise en cache.

Etiqueter Explication Type de données

Etiqueter	Explication	Type de données
Service en 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 le point de terminaison 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 du service de mise en cache (Facultatif)	Nombre total d’instances du service `System/CachingTools` dédiées à l’exécution de cet outil. Si la valeur par défaut -1 est utilisée, toutes les instances de l’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 Maximum number of instances per machine (Nombre maximal d’instances par machine) du service `System/CachingTools` dans la fenêtre Service Editor (Éditeur de services), disponible via une connexion de type 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 d’instances par défaut correspond à la valeur du paramètre Maximum number of instances (Nombre maximal d’instances) du service d’outil de mise en cache.	Long

Service en 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 le point de terminaison 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 du service de mise en cache

(Facultatif)

Nombre total d’instances du service System/CachingTools dédiées à l’exécution de cet outil. Si la valeur par défaut -1 est utilisée, toutes les instances de l’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 Maximum number of instances per machine (Nombre maximal d’instances par machine) du service System/CachingTools dans la fenêtre Service Editor (Éditeur de services), disponible via une connexion de type 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 d’instances par défaut correspond à la valeur du paramètre Maximum number of instances (Nombre maximal d’instances) du service d’outil de mise en cache.

Long

Sortie dérivée

Etiqueter	Explication	Type de données
URL de service de carte en sortie	L’URL en sortie.	String

arcpy.server.ConvertMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})

Nom Explication Type de données

Nom	Explication	Type 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 le point de terminaison 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édiées à l’exécution de cet outil. Si la valeur par défaut -1 est utilisée, toutes les instances de l’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 Maximum number of instances per machine (Nombre maximal d’instances par machine) du service `System/CachingTools` dans la fenêtre Service Editor (Éditeur de services), disponible via une connexion de type 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 d’instances par défaut correspond à la valeur du paramètre Maximum number of instances (Nombre maximal d’instances) du service d’outil de mise en cache.	Long

input_service

Image Service; Map Server

num_of_caching_service_instances

(Facultatif)

Long

Sortie dérivée

Nom	Explication	Type de données
out_job_url	L’URL en sortie.	String

Exemple de code

Exemple d’utilisation de la fonction 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.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

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

Résumé

Attention :

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes