Après ArcGIS Enterprise 10.9.1, ArcGIS Server ne prendra plus en charge l’environnement d’exécution de services ArcMap. Seuls les services qui utilisent l’environnement d’exécution ArcGIS Pro seront pris en charge, à la fois pour les nouveaux services publiés et pour les services existants sur un site de serveur mis à niveau.
Il est recommandé de migrer, republier ou supprimer tous les services qui font appel à l’environnement d’exécution de services ArcMap avant que celui-ci ne soit plus pris en charge.
En savoir plus sur la migration 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 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)
Contrairement à l’opération Edit Runtime (Modifier l’environnement d’exécution) de ArcGIS Server Manager, l’utilitaire de ligne de commande permet de migrer les services d’imagerie, en plus des services de carte. Toutefois, tous les services ne peuvent pas être migrés vers l’environnement d’exécution ArcGIS Pro. Pour identifier les services éligibles, exécutez l’utilitaire en mode d’analyse. 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 signalés par le code 10900 comportent des fonctionnalités de services incompatibles. La fonctionnalité schématique ou les extensions d’objet serveur (SOE) ou intercepteurs d’objet serveur (SOI) personnalisés doivent être désactivés sur le service de carte pour le rendre éligible à la migration.
- 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.
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 le distributeur Esri (hors 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 de services ArcMap et n’apparaissent 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 compte des implications de cette opération avant de migrer les 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 trafic élevé, vous pouvez mettre à jour le service de façon à utiliser des instances dédiées après la migration et vous assurer ainsi de l’exactitude des ressources. 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.sh 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 du compte qui a installé 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ètre | Description |
|---|---|
-m, --mode | Spécifiez le mode d’exécution que vous souhaitez pour l’outil : le mode analysis (par défaut) évalue et affiche les services qui sont actuellement éligibles et inéligibles à la migration, tandis que le mode execution procède à la migration de tous les services éligibles vers l’environnement d’exécution de 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 son rapport dans un répertoire temporaire sur la machine sur laquelle l’utilitaire est exécuté. |
-u, --username | Indiquez le nom d’utilisateur de l’administrateur 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 | Imprime 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 d’analyse pour déterminer si des services de carte et d’imagerie contiennent des fonctionnalités ou des couches non prises en charge.
Le cas échéant, l’administrateur SIG a installé ArcGIS Server et possède donc les informations de connexion requises pour exécuter l’utilitaire sur une machine du site ArcGIS Server. L’administrateur ouvre une session de commandes sur la machine, accède au répertoire d’outils et exécute la commande en mode d’analyse. É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.sh -m analysis -o /Home/SharedDocs
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 quatre services comportent des fonctionnalités non prises en charge (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és des quatre premiers services, l’administrateur exécute l’outil en mode d’exécution pour migrer tous les services éligibles depuis l’environnement d’exécution de services ArcMap vers l’environnement d’exécution de services ArcGIS Pro.
UpdateArcMapServices.sh -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 de services ArcGIS Pro.
Les services restants ne peuvent pas être migrés. L’équipe SIG commence à créer du contenu dans ArcGIS Pro pour le republier.
Elle utilise également le SDK ArcGIS Enterprise pour recompiler les SOE JavaRESTSOE, JavaMapExtension et CustomExtension. Une fois les SOE mis à jour, ils sont rajoutés à chacun des quatre services de carte.
Vous avez un commentaire à formuler concernant cette rubrique ?