Skip To Content

Migrer des services avec l’utilitaire UpdateArcMapServices

Une fois le site ArcGIS Server mis à niveau vers la version 11 ou une version ultérieure, vous devez migrer, republier ou supprimer tous les services qui font appel à l’environnement d’exécution de services ArcMap. ArcGIS Server ne prend plus en charge l’environnement d’exécution de services ArcMap et les services qui utilisent l’environnement d’exécution de services ArcMap ne peuvent plus être utilisés. Seuls les services qui utilisent l’environnement d’exécution de services ArcGIS Pro sont pris en charge, à la fois pour les nouveaux services publiés et pour les services existants sur un site de serveur mis à niveau.

En savoir plus sur la migration ou la republication des services

L’utilitaire de ligne de commande UpdateArcMapServices vous permet d’automatiser la migration par lots des services SIG pris en charge. Cet utilitaire peut fonctionner dans deux modes :

  • analysis : exécutez l’outil en mode analysis pour identifier quels services de votre site sont prêts à être migrés vers l’environnement d’exécution de services ArcGIS Pro.
  • execution : une fois que vous avez identifié les services pouvant être migrés et que vous avez corrigé les conditions susceptibles d’empêcher la migration d’un service éligible, exécutez l’outil en mode execution pour migrer tous les services éligibles vers l’environnement d’exécution des services ArcGIS Pro. La migration de l’environnement d’exécution de services n’affecte pas le contenu ou les paramètres de vos services.

Conditions préalables à la migration d’un environnement d’exécution de services

L’utilitaire UpdateArcMapServices peut migrer les types de services suivants :

  • Services de carte (avec ou sans KML activé)
  • Services d'entités (services de carte dont l'accès aux entités est activé)
  • Services d'imagerie
  • Services WMS (services de carte avec WMS activé)
  • Services WCS (services de carte avec WCS activé)
  • Services WFS (services de carte avec WFS activé)
  • Services d’analyse de réseau (services de carte pour lesquels la fonction d’analyse de réseau est activée)
  • Services de géodonnées

L’utilitaire de commande UpdateArcMapServices permet de migrer les services d’imagerie, de géodonnées et de carte. Toutefois, tous les services ne peuvent pas être migrés vers l’environnement d’exécution de services ArcGIS Pro. Pour identifier les services qui ne peuvent pas être migrés, exécutez l’utilitaire en mode analysis. La fenêtre de résultat et le rapport HTML classent les services inéligibles selon le motif d’inéligibilité.

  • Les services de carte et d’imagerie signalés par le code 10900 comportent des fonctionnalités de services incompatibles. La fonctionnalité Schematics, les extensions d’objets serveur (SOE) ou les intercepteurs d’objet serveur (SOI) personnalisés doivent être désactivés au niveau du service de carte ou d’imagerie pour le rendre éligible à la migration. (Vous pouvez migrer les SOE et les SOI et les ajouter ensuite aux services migrés. Pour plus d’informations, reportez-vous à l’article de blog Migrating ArcObjects SOEs and SOIs to ArcGIS Enterprise SDK.)
  • Les services de carte signalés par le code 10901 comportent des types de couches incompatibles. Les couches de catalogue d’images et les couches temporelles créées par l’extension Tracking Analyst ne peuvent pas être migrées, tout comme les couches d’entités issues de bases données non prises en charge par ArcGIS Pro.
  • Les services de géodonnées signalés par le code 10903 ont été publiés à partir de bases de données non prises en charge avec ArcGIS Pro, plus précisément ceux publiés à partir de bases de données IBM Db2 pour z/OS et IBM Informix. Pour les services de géodonnées utilisant une base de données non prise en charge, vous devez déplacer les données sources vers une géodatabase qui est une base de données prise en charge par ArcGIS Pro avant de pouvoir les republier.

Certaines fonctions raster appliquées au service ou aux sources de données raster du service ne fonctionnent pas dans l’environnement d’exécution de services ArcGIS Pro, notamment les fonctions raster Python écrites en Python 2 et celles qui utilisent certains dégradés de couleurs. Le rapport HTML n’identifie pas les services individuels qui contiennent ces fonctions raster non prises en charge, mais il vous informe que certains services en cours d’exécution sur le site ArcGIS Server contiennent ces fonctions. Avant la migration, remplacez les fonctions Python 2 par des fonctions Python 3. Vous pouvez migrer ces services sans supprimer les fonctions raster non prises en charge, mais le service migré ne fonctionnera pas correctement lors de l’accès à ces fonctions. Si le rendu des services migrés n’est pas correct en raison de dégradés de couleurs non pris en charge, contactez l’assistance technique Esri (aux États-Unis) ou votre distributeur Esri (en dehors des États-Unis).

Seuls les services publiés depuis ArcMap sont analysés. Les services publiés initialement depuis ArcGIS Pro ne peuvent pas être migrés vers l’environnement d’exécution des services ArcMap et ne figurent pas dans la liste des services analysés.

Instances de service

L’environnement d’exécution de services ArcGIS Pro prend en charge à la fois les types d’instances dédiées et partagées pour les services de carte. Au cours de la migration, l’utilitaire affecte par conséquent un type d’instance à chaque service de carte migré. L’opération repose sur le type d’instance par défaut de votre site ArcGIS Server.

Tenez-en compte avant de migrer des services. Par exemple, si le type d’instance par défaut de votre site ArcGIS Server est Instances partagées et que vous préparez la migration d’un service qui reçoit un fort trafic, vous pouvez mettre à jour le service pour qu’il utilise des instances dédiées après la migration et qu’il dispose ainsi de ressources adéquates. Si votre service comprend des SOE ou SOI personnalisés que vous avez l’intention de recompiler et de rajouter au service après la migration, le service ne peut pas faire appel au groupage d’instances partagées.

En savoir plus sur la configuration des paramètres des instances du service

Accéder à l’utilitaire de ligne de commande

L’utilitaire de migration est hébergé dans le dossier <ArcGIS Server installation location>\tools\UpdateArcMapServices sur votre machine ArcGIS Server. Vous pouvez exécuter le fichier UpdateArcMapServices.bat directement à partir de cet emplacement ou en indiquant le chemin d’accès complet au répertoire. Vous devez vous connecter à la machine ArcGIS Server à l’aide des identifiants du compte ArcGIS Server.

Lorsque vous exécutez l’utilitaire UpdateArcMapServices dans l’un ou l’autre mode, une page HTML s’ouvre pour afficher les résultats de l’outil. Les deux modes affichent le nombre de services éligibles ou actuellement inéligibles à la migration. En mode execution, les journaux associés à la migration s’affichent, ainsi que le nombre de services qui ont été migrés vers l’environnement d’exécution de services ArcGIS Pro.

Paramètres

L’utilitaire prend en charge les paramètres en entrée suivants :

ParamètreDescription

-m, --mode

Spécifiez le mode d’exécution souhaité de l’outil : le mode analysis (par défaut) évalue et affiche les services actuellement éligibles et non éligibles à la migration, tandis que le mode execution migre tous les services éligibles vers l’environnement d’exécution des services ArcGIS Pro.

-o, --output

Définissez le répertoire dans lequel le fichier de rapport de l’outil sera généré. S’il n’est pas défini, l’outil génère le rapport dans un répertoire temporaire de la machine sur laquelle vous exécutez l’utilitaire.

-u, --username

Indiquez le nom d’utilisateur de l’administrateur de site principal du site ArcGIS Server. Si le compte d’administrateur de site principal de votre site n’est pas disponible, spécifiez le nom d’utilisateur de compte d’un administrateur du serveur ou, si le serveur est fédéré, d’un administrateur du portail.

-h, --help

Imprimez l’aide de l’utilitaire.

Exemple d'utilisation

Un administrateur SIG souhaite que tous les services de l’organisation utilisent l’environnement d’exécution de services ArcGIS Pro. Tout d’abord, l’administrateur se connecte à ArcGIS Server Manager pour établir la liste des services de géotraitement et de géocodage qui s’exécutent sur le site ArcGIS Server. Ceux-ci ne peuvent pas être migrés ; ils doivent être republiés.

Ensuite, l’administrateur exécute l’utilitaire UpdateArcMapServices en mode analysis pour identifier les services de carte, d’imagerie et de géodonnées qui contiennent des fonctionnalités ou des couches non prises en charge.

L’administrateur SIG se connecte à l’une des machines du site ArcGIS Server avec le compte qui exécute le service ArcGIS Server. L’administrateur ouvre une fenêtre de commandes, accède au répertoire de l’outil et exécute la commande en mode analysis. Étant donné que le rapport HTML est destiné à être partagé, l’administrateur spécifie un répertoire partagé pour la sortie.

cd <ArcGIS Server installation location>\arcgis\server\tools\UpdateArcMapServices

UpdateArcMapServices.bat -m analysis -o C:\\Desktop

L’outil s’exécute et détermine que cinq des services dans le site ArcGIS Server sont actuellement inéligibles à la migration. Les résultats s’affichent sur la ligne de commande et sont consignés dans le rapport HTML. Le rapport indique que des fonctionnalités non prises en charge sont activées sur quatre services (code d’avertissement 10900) et qu’un service contient un type de couche non pris en charge (code d’avertissement 10901).

WARNING: Service [Mapservice1] with extensions [JavaRESTSOE] enabled needs to be addressed. Code 10900.
WARNING: Service [Mapservice2] with extensions [JavaMapExtension] enabled needs to be addressed. Code 10900.
WARNING: Service [Mapservice3] with extensions [CustomExtension] enabled needs to be addressed. Code 10900.
WARNING: Service [Mapservice4] with extensions [JavaMapExtension,JavaRESTSOE] enabled needs to be addressed. Code 10900.
WARNING: Service [Imageservice] with data in layers [coral_reefs] needs to be addressed. Code 10901.

Les membres de l’équipe SIG examinent le rapport et vérifient ces cinq services. Leur conclusion est que les quatre services comportant des extensions non prises en charge ont des SOE personnalisés activés et que l’autre service contient un jeu de données raster. Pour permettre la migration des quatre premiers services, ils désactivent les SOE dans ArcGIS Server Manager. Ils recompileront les SOE et les rajouteront aux services de carte après la migration vers l’environnement d’exécution de services ArcGIS Pro.

Étant donné que les couches ne peuvent pas être supprimées des services, ils ne migrent pas le service d’imagerie. Ce service est ajouté à la liste des services que l’administrateur SIG devra recréer et publier dans ArcGIS Pro.

Une fois les SOE supprimées des quatre premiers services, l’administrateur exécute l’outil en mode execution pour migrer tous les services éligibles de l’environnement d’exécution des services ArcMap vers l’environnement d’exécution des services ArcGIS ProArcGIS Pro.

UpdateArcMapServices.bat -m execution

Au cours de l’exécution de l’outil, l’administrateur surveille la page de résultats HTML afin de consulter les journaux de chaque tâche de migration. Une fois l’exécution terminée, chaque service éligible a été migré vers l’environnement d’exécution des services ArcGIS Pro.

Les services restants ne peuvent pas être migrés. Les membres de l’équipe SIG commencent à créer du contenu dans ArcGIS Pro pour le republier.

Ils utilisent également ArcGIS Enterprise SDK pour recompiler les SOE JavaRESTSOE, JavaMapExtension et CustomExtension. Une fois les SOE mis à jour, ils sont rajoutés à chacun des quatre services de carte.