Una vez que un sitio de ArcGIS Server se haya actualizado a 11.0 o posterior, deberá migrar, volver a publicar o eliminar todos los servicios que utilizan el tiempo de ejecución del servicio ArcMap. ArcGIS Server ya no es compatible con el tiempo de ejecución del servicio ArcMap, y los servicios que usan el tiempo de ejecución del servicio ArcMap no se pueden usar. Solo se admiten 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.
Más información acerca cómo migrar o volver a publicar servicios
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 de 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)
- Servicios de geodatos
La utilidad de comando UpdateArcMapServices permite migrar servicios de imágenes, geodatos y mapas. Sin embargo, existen limitaciones sobre cuáles de estos servicios se pueden migrar al tiempo de ejecución del servicio ArcGIS Pro. Para identificar los servicios que no se pueden migrar, ejecute la utilidad en el modo analysis. La ventana de resultados y el informe HTML categorizan los servicios no aptos en función del motivo por el que no son elegibles.
- Los servicios de mapas e imágenes marcados con el código 10900 contienen capacidades de servicio incompatibles. La funcionalidad Schematics o las extensiones de objeto de servidor (SOE) o los interceptores de objeto de servidor (SOI) personalizados deben estar desactivados en el servicio de mapas o imágenes para que sean elegibles para la migración. (Puede migrar los SOE y SOI y agregarlos a los servicios migrados. Consulte la publicación del blog Migración de SOE y SOI de ArcObjects a ArcGIS Enterprise SDK para obtener más información.
- Los servicios de mapas marcados con el código 10901 contienen tipos de capa incompatibles. No se pueden migrar las capas del catálogo de ráster ni las capas con tiempo habilitado creadas por la extensión Tracking Analyst, ni las capas de entidades de las bases de datos no admitidas por ArcGIS Pro.
- Los servicios de geodatos marcados por el código 10903 se publicaron desde bases de datos que no se admiten en ArcGIS Pro, específicamente las publicadas desde bases de datos de IBM Db2 para z/OS e IBM Informix. En el caso de los servicios de geodatos que utilizan una base de datos no admitida, deberá trasladar los datos de origen a una geodatabase que esté en una base de datos admitida por ArcGIS Pro antes de poder volver a publicarlos.
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 su 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.
Examine 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ámetro | Descripció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 execution procede a migrar todos los servicios elegibles al tiempo de ejecución del servicio de 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 el informe en un directorio temporal del equipo en el que se ejecuta la utilidad. |
-u, --username | Especifique el nombre de usuario del 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 | Imprimir 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 modo analysis para determinar qué servicios de mapas, imágenes y geodatos 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 analysis. 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. 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 execution para migrar todos los servicios que cumplan los requisitos del tiempo de ejecución del servicio de ArcMap al tiempo de ejecución del servicio de 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 migran correctamente al tiempo de ejecución del servicio de ArcGIS Pro.
El resto de servicios no se pueden migrar. Los miembros del personal de SIG comienza a crear contenido en ArcGIS Pro para publicarlo de nuevo.
Los miembros del personal de SIG también utilizan ArcGIS Enterprise SDK 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.