Skip To Content

Migrar cachés de capas de escenas alojadas mediante la utilidad MigrateSceneServices

ArcGIS 11.4 (Windows)  | |  Archivo de ayuda

Después de actualizar una implementación de ArcGIS Enterprise a la versión 11.4, se recomienda agregar un almacén de objetos a la implementación y migrar las cachés de capas de escenas alojadas allí. Al migrar, las cachés se mueven desde el data store de la caché de teselas de ArcGIS Data Store al almacén de objetos.

La utilidad MigrateSceneServices le permite recopilar información sobre los servicios y cachés antes de la migración. Esto incluye los nombres de los servicios de escena y el tamaño de sus cachés. Cuando haya determinado lo que necesita migrar, puede usar la utilidad MigrateSceneServices para automatizar una migración masiva de todas las cachés de capas de escenas alojadas o proporcionar una lista de nombres de servicios para migrar a la vez. Por ejemplo, si tiene una o dos cachés extremadamente grandes, puede migrarlas durante la noche, ya que tardarán mucho tiempo en migrar. Cuando haya terminado y haya probado las capas de escenas alojadas, vuelva a ejecutar la utilidad para migrar las cachés de capas de escenas alojadas restantes.

Al migrar, la utilidad hace lo siguiente por cada capa de escena alojada:

  • Copia la caché al almacén de objetos.
  • Una vez que la caché de esa capa se ha copiado en el almacén de objetos, esta se elimina del data store de la caché de teselas.

Esto significa que hay un período de tiempo en el que la caché de una capa de escena existe en ambos data stores. Si tiene el data store de la caché de teselas y el almacén de objetos en el mismo equipo (lo que no se recomienda), debe tener en cuenta este aumento temporal en los requisitos de espacio en disco.

La caché que migre al almacén de objetos de ArcGIS Data Store utilizará aproximadamente la misma cantidad de espacio en disco en el almacén de objetos que en el equipo del data store de la caché de teselas.

Nota:

Como alternativa, el administrador de la organización de ArcGIS Enterprise o el propietario de una capa de escenas alojadas pueden migrar capas de escenas alojadas individuales desde la página de elementos de la capa de escena del portal. Consulte Administrar capas de escena para obtener instrucciones.

Con independencia del método que utilice, en la migración de la caché de la capa se emplean grandes cantidades de CPU de los equipos de data store de caché de teselas y almacén de objetos.

Razones para migrar capas de escenas alojadas

El data store de caché de teselas ArcGIS Data Store ha quedado obsoleto en la versión 11.4. El soporte para el data store de la caché de teselas se eliminará en una versión futura. Por esta razón, se recomienda empezar a mover las cachés de capas de escenas alojadas a un almacén de objetos del sistema.

Requisitos previos para la migración

Antes de poder migrar las cachés de capas de escenas alojadas, debe hacer lo siguiente:

  • Actualice la implementación de ArcGIS Enterprise a la versión 11.4.
  • Si la implementación de ArcGIS Enterprise aún no tiene un almacén de objetos configurado, debe configurar uno.

Se recomienda encarecidamente que cree una copia de seguridad antes de empezar a migrar las cachés de capas de escena. Consulte Copias de seguridad de ArcGIS Enterprise y la referencia a la utilidad backupdatastore para obtener información sobre cómo crear copias de seguridad.

Parámetros y sintaxis de la utilidad MigrateSceneServices

La sintaxis para ejecutar la utilidad MigrateSceneServices es la siguiente:

MigrateSceneServices.bat -m <analysis | execution> -s <hosting server URL> -u <administrator username> -p <administrator password> [-t <portal token>] [-r <token referrer>] [--select <list of services to migrate>] [-o <directory>] [-l <log level>] [--num-threads <threads to use>]

A continuación se presenta la descripción de cada parámetro:

ParámetroDescripción
-m, --mode

Hay dos modos compatibles.

  • analysis: este es el modo por defecto. Ejecute la utilidad en el modo analysis para evaluar si se pueden migrar las cachés de capas de escena y recibir una lista de servicios elegibles para la migración.
  • execution: después de confirmar que ArcGIS Enterprise está configurado para permitir la migración e identificar qué cachés de capas de escena se pueden migrar, ejecute la utilidad en el modo execution para mover todas las cachés de capas de escenas alojadas elegibles al almacén de objetos desde el data store de la caché de teselas.
-s, --server_url

Proporcione la URL del sitio del servidor de alojamiento.

-u, --username

Especifique un nombre de usuario de inicio de sesión que sea miembro del rol de administrador predeterminado en el portal de ArcGIS Enterprise asociado con este sitio de servidor de alojamiento.

-p, --password

Proporcione la contraseña de la cuenta de administrador que especificó con el parámetro -u.

-r, --referrer

El referente del token del portal. Utilícelo para restringir aún más el uso y designar las URL o IP de referencia específicas que pueden acceder al servicio. Por ejemplo, puede restringirlo a la URL de su organización de ArcGIS Enterprise.

-t, --token

Se puede generar un token y utilizarlo en lugar del nombre de usuario y la contraseña. Cuando se proporciona un token, este invalida cualquier nombre de usuario o contraseña proporcionados.

Si especifica un referente, debe proporcionar un token de portal.

--select

Este parámetro opcional le permite proporcionar una lista establecida de servicios para migrar. La lista debe tener el siguiente formato:

"[servicename1, servicename2, servicename3]"

-o, --output-dir

Este parámetro opcional le permite especificar el directorio en el que se creará el archivo de informe de la utilidad (cuando ejecuta la utilidad en modo de análisis) o creará el archivo de registro (cuando ejecuta la utilidad en modo de ejecución). Si no está definido, la utilidad genera el informe o el archivo de registro en un directorio temporal del equipo en el que se ejecuta la utilidad.

-l, --log_level

Utilice este parámetro opcional para establecer el nivel de registro utilizado para el archivo de registro que se genera cuando ejecuta la utilidad. El nivel de registro predeterminado que se utiliza es info si no especifica este parámetro con un valor diferente.

Los valores válidos, ordenados desde el más detallado al menos detallado, son los siguientes:

  • trace
  • debug
  • info
  • warning
  • error
  • fatal
--num-threads

Anula el número predeterminado de subprocesos utilizados para la migración. El número predeterminado de subprocesos utilizados es 16.

Si observa un uso de CPU del 100 % durante la migración de la caché y la migración falla o no puede completarse, disminuya la cantidad de subprocesos utilizados por la utilidad.

Al modificar esta configuración, se recomienda que establezca el número de subprocesos en función del número de núcleos del equipo. Por ejemplo, si el equipo tiene cuatro núcleos, configure --num-threads en 4.

-h, --help

Utilice este parámetro para devolver la sintaxis de la utilidad.

Ejecutar la utilidad

La utilidad MigrateSceneServices se instala en los equipos de ArcGIS Server en la carpeta <ArcGIS Server installation directory>\tools\MigrateSceneServices.

Debe ejecutar la utilidad desde uno de los equipos del servidor de alojamiento del portal de ArcGIS Enterprise.

Al ejecutar la utilidad MigrateSceneServices en cualquiera de los modos, se genera un archivo de registro. Ambos modos muestran el recuento de los servicios (capas de escena) que son elegibles para ser migrados.

El informe generado cuando se ejecuta la utilidad en modo de análisis proporciona el tamaño de cada caché.

Sugerencia:

Si el almacén de objetos se ejecuta en el mismo equipo que el data store de la caché de teselas, identifique el tamaño de caché más grande. Asegúrese de que haya suficiente espacio libre en el disco del equipo del data store para acomodar al menos el doble del tamaño de esta caché más grande, porque habrá un pequeño período de tiempo durante la migración en el que se creará la caché en el almacén de objetos, pero aún no se habrá eliminado del data store de la caché de teselas.

En el modo execution, se muestran las entradas de registro relacionadas con la operación de migración, así como un recuento de los servicios que se han migrado.

Siga estos pasos para acceder a la utilidad y ejecutarla:

  1. Inicie sesión en uno de los equipos del sitio del servidor de alojamiento utilizando el inicio de sesión de la cuenta de ArcGIS Server o un inicio de sesión que tenga privilegios de lectura de todos los directorios de ArcGIS Server.
  2. Abra una ventana de comandos y cambie al directorio tools indicado anteriormente.
  3. Ejecute la utilidad MigrateSceneServices en modo de análisis.

    En el ejemplo siguiente, la utilidad se ejecuta en modo de análisis y el archivo de registro se escribe en un directorio llamado analysislogs:

    MigrateSceneServices.bat -m analysis -s https://hostingserver.example.com/waname -u portaladmin -p L00kAway! -o c:\\analysislogs

  4. Si el informe generado al ejecutar la utilidad en modo de análisis indica que la implementación está configurada para permitir la migración y que hay cachés de capas de escena para migrar, ejecute la utilidad en modo de ejecución.

    El ejemplo siguiente migra las cachés de todas las capas de escena:

    MigrateSceneServices.bat -m execution -s https://hostingserver.example.com/waname -u portaladmin -p L00kAway! -o c:\\migrationlogs -l error

  5. Una vez que se hayan migrado y probado todas las cachés de capas de escena, ejecute la utilidad una última vez en modo de análisis para confirmar que no queden cachés para migrar.

Uso de ejemplo

Después de que el administrador configure un almacén de objetos, el administrador de ArcGIS Server ejecuta la utilidad MigrateSceneServices en modo de análisis para determinar qué servicios de escena deben migrarse.

El administrador de ArcGIS Server inicia sesión en uno de los equipos del sitio de ArcGIS Server que se utiliza como servidor de alojamiento. El administrador utiliza el inicio de sesión que ejecuta el servicio de ArcGIS Server Microsoft Windows.

El administrador abre una ventana de comandos, accede al directorio tools y ejecuta el comando en modo de análisis. Dado que el informe se compartirá con compañeros, el administrador especifica un directorio compartido para la ubicación de salida.

cd C:\\Program Files\arcgis\server\tools\MigrateSceneServices

MigrateSceneServices.bat -m analysis -s https://hostingserver.example.com/hserver -r https://webadaptorhost.example.com/webadaptor/admin -t abcdefg1234567 -o \\sharedserver\utiloutput

La utilidad se ejecuta y determina que cuatro de las capas de escena aún tienen sus cachés en el data store de la caché de teselas y se pueden migrar. Los resultados se muestran en la línea de comandos y se enumeran en el informe que se creó en el directorio utiloutput. El informe muestra que sceneservice1, sceneservice2, sceneservice3 y sceneservice4 todavía tienen sus cachés en el data store de la caché de teselas.

En el informe, cada servicio aparece con su tamaño de caché, como se muestra a continuación:

{
  "mode":"analysis",
  "messages":[
    "INFO: Started: Fri Aug  2 17:19:58 2024",
    "INFO: Found 4 migratable service(s)",
    "INFO: Largest service: [sceneservice2] (96459081B / ~(91.99MB)",
    "INFO: Ended: Fri Aug  2 17:20:01 2024"
  ],
  "services":[
    {
      "sceneservice1":{
        "messages":[
          "INFO: size: (48887B / ~5.1MB)"
        ]
      },
      "sceneservice2":{
        "messages":[
          "INFO: size: (96459081B / ~91.99MB)"
        ]
      },
      "sceneservice3":{
        "messages":[
          "INFO: size: (722299B / ~11.37MB)"
        ]
      },
      "sceneservice4":{
        "messages":[
          "INFO: size: (61005191B / ~70.11MB)"
        ]
      }
    }
  ]
}

Los miembros del personal de SIG revisan el informe que se escribió en la ubicación compartida y comprueban cada una de las capas de escena antes de que se realice la migración. Esto les permite comparar el contenido y el rendimiento de las capas antes y después de la migración. Descubren que sceneservice3 tiene un servicio de entidades asociado que está siendo editado activamente. Por lo tanto, sceneservice3 no se migrará hasta que el editor haya terminado.

El administrador de ArcGIS Server ejecuta la utilidad MigrateSceneServices para mover las cachés de las otras tres capas de escena.

MigrateSceneServices.bat -m execution -s https://hostingserver.example.com/hserver -r https://fully.qualified.domain:6443/arcgis/admin -t abcdefg1234567 -f [sceneservice1,sceneservice2,sceneservice4] -o \\sharedserver\utiloutput -l debug

Al finalizar la utilidad, se habrá migrado la caché de todas las capas de escena elegibles. El administrador de ArcGIS Server vuelve a ejecutar la utilidad MigrateSceneServices en modo de análisis para confirmar que no es necesario migrar más cachés de capas de escena.

Una vez que se han probado todas las capas de escena migradas y se ha confirmado que funcionan, el administrador de ArcGIS Data Store ejecuta la utilidad disabledatastore para anular el registro del data store de la caché de teselas del servidor de alojamiento y eliminar todo su contenido.