Skip To Content

Migrar servicios con la utilidad UpdateArcMapServices

Después de ArcGIS Enterprise 10.9.1, ArcGIS Server ya no será compatible con el tiempo de ejecución del servicio ArcMap. Solo se admitirán los servicios que utilicen el tiempo de ejecución del servicio ArcGIS Pro, tanto para los servicios recién publicados como para los servicios existentes en un sitio de servidor actualizado.

Se recomienda migrar, volver a publicar o eliminar todos los servicios que utilizan el tiempo de ejecución del servicio ArcMap antes de que ya no se admita.

Más información acerca de los servicios de migración

La utilidad de línea de comandos UpdateArcMapServices le permite automatizar una migración en masa de servicios SIG admitidos. La utilidad ofrece los dos modos siguientes:

  • analysis: ejecute la herramienta en modo analysis para evaluar qué servicios de su sitio están listos para migrar al tiempo de ejecución del servicio ArcGIS Pro.
  • execution: una vez que sepa qué servicios se pueden migrar y tener condiciones corregidas que podrían impedir la migración de un servicio apto, ejecute la herramienta en modo execution para migrar todos los servicios aptos al tiempo de ejecución del servicio ArcGIS Pro. La migración del tiempo de ejecución del servicio no afectará al contenido ni a la configuración de sus servicios.

Requisitos previos para migrar un tiempo de ejecución de servicio

La utilidad UpdateArcMapServices puede migrar los tipos de servicio siguientes:

  • Servicios de mapas (con o sin KML habilitado)
  • Servicios de entidades (servicios de mapas con acceso de entidades habilitado)
  • Servicios de imágenes
  • Servicios WMS (servicios de mapas con WMS habilitado)
  • Servicios WCS (servicios de mapas con WCS habilitado)
  • Servicios WFS (servicios de mapas con WFS habilitado)
  • Servicios de análisis de red (servicios de mapas con análisis de red habilitado)

A diferencia de la operación Editar tiempo de ejecución en ArcGIS Server Manager, la utilidad de comando permite migrar servicios de imágenes además de los servicios de mapas. Sin embargo, todavía existen limitaciones sobre qué servicios se pueden migrar al tiempo de ejecución del servicio ArcGIS Pro. Para identificar estos servicios, ejecute la utilidad en el modo de análisis. La ventana de resultados y el informe HTML categorizan los servicios no aptos en función del motivo por el que no son elegibles.

Algunas funciones ráster aplicadas al servicio o a las fuentes de datos ráster del servicio no funcionarán con el tiempo de ejecución del servicio ArcGIS Pro, como las funciones ráster Python escritas en Python 2 y funciones ráster con determinadas rampas de color. El informe HTML no identifica servicios individuales que contienen estas funciones ráster no compatibles, pero el informe le notificará que hay servicios en ejecución en el sitio de ArcGIS Server que las contienen. Antes de migrar, reemplace las funciones Python 2 por las funciones Python 3. Puede migrar estos servicios sin eliminar las funciones ráster no compatibles, pero el servicio migrado no funcionará correctamente al acceder a esas funciones. Si los servicios migrados no se renderizan correctamente debido a rampas de color no compatibles, póngase en contacto con el Soporte técnico de Esri (en Estados Unidos) o con el distribuidor de Esri (fuera de Estados Unidos).

Solo se analizan los servicios publicados desde ArcMap. Los servicios publicados originalmente desde ArcGIS Pro no se pueden migrar al tiempo de ejecución del servicio ArcMap y no se mostrarán en la lista de servicios analizados.

Instancias de servicio

El tiempo de ejecución del servicio ArcGIS Pro admite tipos de instancias dedicadas y compartidas para los servicios de mapas. Por lo tanto, durante el proceso de migración, la utilidad asigna un tipo de instancia a cada servicio de mapa migrado. Esto se basa en la configuración del tipo de instancia predeterminado en su sitio de ArcGIS Server.

Asegúrese de examinar las implicaciones de todo ello antes de migrar los servicios. Por ejemplo, si el tipo de instancia predeterminado de su sitio de ArcGIS Server es el de instancias compartidas, y está preparando la migración de un servicio que recibe mucho tráfico, considere la posibilidad de editar el servicio para que utilice instancias dedicadas después de la migración, a fin de garantizar que disponga de los recursos adecuados. Si el servicio tiene SOE o SOI personalizados y desea volver a compilarlos y agregarlos de nuevo al servicio después de la migración, el servicio no puede utilizar la agrupación de instancias compartidas.

Más información sobre cómo configurar los ajustes de instancia de servicio

Acceso a la utilidad de línea de comandos

La utilidad de migración se encuentra alojada en la carpeta <ArcGIS Server installation location>\tools\UpdateArcMapServices de su máquina ArcGIS Server. Puede ejecutar el archivo UpdateArcMapServices.bat directamente desde esta ubicación o mediante una referencia a la ruta completa al directorio. Debe iniciar sesión en el equipo ArcGIS Server con el inicio de sesión de la cuenta de ArcGIS Server.

Al ejecutar la utilidad UpdateArcMapServices en cualquiera de los modos, se abre una página HTML para mostrar los resultados de la herramienta. Ambos modos muestran el recuento de los servicios que pueden o no pueden ser migrados. En modo execution, se muestran los registros relativos a la operación de migración, así como un recuento de los servicios que se han migrado correctamente al tiempo de ejecución del servicio ArcGIS Pro.

Parámetros

La utilidad admite los siguientes parámetros de entrada:

ParámetroDescripción

-m, --mode

Especifique el modo en el que desea que se ejecute la herramienta: el modo analysis (modo predeterminado) evalúa y muestra los servicios actualmente elegibles y no elegibles que se van a migrar, mientras que el modo execution procede a migrar todos los servicios elegibles al tiempo de ejecución del servicio ArcGIS Pro.

-o, --output

Defina el directorio en el que se generará el archivo de informe de la herramienta. Si no está definido, la herramienta genera su informe en un directorio temporal del equipo en el que se ejecuta la utilidad.

-u, --username

Especifique el nombre de usuario para el administrador principal del sitio de ArcGIS Server. Si la cuenta del administrador principal del sitio no está disponible, especifique un nombre de usuario de la cuenta para un administrador del servidor o, si el servidor está federado, un administrador del portal.

-h, --help

Imprime la ayuda para la utilidad.

Uso de ejemplo

Un administrador de SIG desea que todos los servicios de la organización utilicen el tiempo de ejecución del servicio ArcGIS Pro. Primero, el administrador inicia sesión en ArcGIS Server Manager para crear una lista de los servicios de geoprocesamiento y geocodificación que se ejecutan en el sitio de ArcGIS Server. No se pueden migrar; deben publicarse de nuevo.

A continuación, el administrador ejecuta la utilidad UpdateArcMapServices en el modo de análisis para determinar qué servicios de mapas e imágenes contienen funcionalidades o capas no compatibles.

El administrador de SIG inicia sesión en uno de los equipos del sitio ArcGIS Server utilizando el inicio de sesión que ejecuta el servicio ArcGIS Server. El administrador abre una ventana de comandos, accede al directorio de la herramienta y ejecuta el comando en modo de análisis. Dado que el informe HTML se compartirá con compañeros, el administrador especifica un directorio compartido para la ubicación de salida.

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

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

La herramienta ejecuta y determina que cinco de los servicios del sitio de ArcGIS Server no son elegibles actualmente para la migración. Los resultados se muestran en la línea de comandos y se enumeran en el informe HTML. En el informe, muestra que cuatro de los servicios tienen habilitadas las funcionalidades no compatibles (código de advertencia 10900) y un servicio contiene un tipo de capa no compatible (código de advertencia 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.

Los miembros del personal de SIG revisan el informe y comprueban cada uno de los cinco servicios. Determinan que los cuatro servicios con extensiones no compatibles tienen las SOE personalizadas habilitadas y que el otro servicio contiene un dataset ráster. Para permitir la migración de los primeros cuatro servicios, deshabilitan las SOE de cada servicio en ArcGIS Server Manager. Recompilarán las SOE y las agregarán de nuevo a los servicios de mapas una vez que se hayan migrado al tiempo de ejecución del servicio ArcGIS Pro.

Dado que las capas no se pueden eliminar de los servicios, no migrarán el servicio de imágenes. El servicio se agrega a la lista de servicios del administrador de SIG que se van a volver a crear y publicar en ArcGIS Pro.

Cuando se eliminan las SOE de los primeros cuatro servicios, el administrador ejecuta la herramienta en modo de ejecución para migrar todos los servicios que cumplan los requisitos del tiempo de ejecución del servicio ArcMap al tiempo de ejecución del servicio ArcGIS Pro.

UpdateArcMapServices.bat -m execution

Mientras se ejecuta la herramienta, el administrador supervisa la página de resultados HTML para ver los registros de cada tarea de migración. Cuando la herramienta completa su ejecución, todos los servicios elegibles se han migrado correctamente al tiempo de ejecución del servicio ArcGIS Pro.

El resto de servicios no se pueden migrar. El personal de SIG comienza a crear contenido en ArcGIS Pro para publicarlo de nuevo.

El personal de SIG también utiliza el SDK de ArcGIS Enterprise para recompilar las SOE JavaRESTSOE, JavaMapExtension y CustomExtension. Cuando actualizan las SOE, se vuelven a agregar a cada uno de los cuatro servicios de mapas.