Skip To Content

Migrer les caches de couche de scènes hébergées à l’aide de l’utilitaire MigrateSceneServices

ArcGIS 11.4 (Windows)  | |  Archive de l’aide

Après avoir mis à niveau un déploiement ArcGIS Enterprise vers 11.4, il est recommandé d’ajouter un magasin d’objets au déploiement et d’y migrer les caches de couche de scènes hébergées. Lors de la migration, les caches sont déplacés du data store de cache tuilé ArcGIS Data Store vers le magasin d’objets.

L’utilitaire MigrateSceneServices permet de rassembler des informations relatives aux services et aux caches avant la migration. Cela comprend les noms des services de scène et la taille de leurs caches. Après avoir déterminé vos besoins en matière de migration, vous pouvez utiliser l’utilitaire MigrateSceneServices pour automatiser une migration par lots de tous les caches de couche de scènes hébergées ou fournir une liste de noms de service à migrer à tout moment. Par exemple, si un ou deux de vos caches sont extrêmement volumineux, vous pouvez les migrer pendant la nuit étant donné que la migration prendra beaucoup de temps. À l’issue et après avoir testé les couches de scènes hébergées, exécutez de nouveau l’utilitaire pour migrer les caches de couche de scènes hébergées restants.

Lors de la migration, l’utilitaire procède comme suit en fonction de chaque couche de scènes hébergées :

  • Il copie le cache dans le magasin d’objets.
  • Dès que le cache de cette couche a été copié dans le magasin d’objets, il est supprimé du data store de cache tuilé.

Cela signifie que les deux data stores contiennent le cache d’une couche de scènes pendant un certain temps. Si le data store de cache tuilé et le magasin d’objets sont sur la même machine (ce qui est déconseillé), vous devez penser à augmenter temporairement l’espace disque.

Le cache que vous migrez vers le magasin d’objets ArcGIS Data Store va utiliser à peu près la même quantité d’espace disque sur le magasin d’objets que celui utilisé sur la machine du data store de cache tuilé.

Remarque :

Par ailleurs, l’administrateur de l’organisation ArcGIS Enterprise ou le propriétaire d’une couche de scènes hébergées peut migrer des couches de scènes hébergées individuelles à partir de la page des éléments de la couche de scènes du portail. Pour obtenir des instructions, reportez-vous à la rubrique Gérer les couches de scènes.

Quelle que soit la méthode utilisée, la migration du cache de la couche sollicite grandement le processeur des machines du data store de cache tuilé et de l’object store.

Raison justifiant la migration de couches de scènes hébergées

Le data store de cache tuilé ArcGIS Data Store devient obsolète à compter de la version 11.4. La prise en charge du data store de cache tuilé ne sera plus d’actualité dans une version ultérieure. C’est la raison pour laquelle vous êtes invité à déplacer les caches de couches de scènes hébergées vers un magasin d’objets système.

Conditions préalables à la migration

Pour pouvoir migrer des caches de couches de scènes hébergées, vous devez :

  • Mettre à niveau le déploiement ArcGIS Enterprise vers la version 11.4.
  • Si aucun magasin d’objets n’est configuré pour le déploiement ArcGIS Enterprise, vous devez en configurer un.

Il est vivement recommandé de créer une sauvegarde avant de migrer des caches de couches de scènes. Consultez les rubriques Sauvegardes ArcGIS Enterprise et Utilitaire backupdatastore pour plus d’informations sur la création de sauvegardes.

Paramètres et syntaxe de l’utilitaire MigrateSceneServices

La syntaxe permettant d’exécuter l’utilitaire MigrateSceneServices est la suivante :

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>]

Chaque paramètre est décrit ci-après :

ParamètreDescription
-m, --mode

Deux modes sont pris en charge.

  • analysis : il s’agit du mode par défaut. Exécutez l’utilitaire en mode analysis pour évaluer si des caches de couches de scènes peuvent être migrés et recevoir une liste de services éligibles pour la migration.
  • execution : après avoir confirmé que ArcGIS Enterprise est configuré pour permettre la migration et qu’il a identifié les caches de couches de scènes qui peuvent être migrés, exécutez l’utilitaire en mode execution pour déplacer tous les caches de couches de scènes hébergées éligibles vers le magasin d’objets à partir du data store de cache tuilé.
-s, --server_url

Fournir l’URL du site du serveur d’hébergement.

-u, --username

Spécifiez le nom d’utilisateur d’une connexion membre du rôle administrateur par défaut dans le portail ArcGIS Enterprise associé à ce site de serveur d’hébergement.

-p, --password

Indiquez le mot de passe du compte administrateur que vous avez spécifié avec le paramètre -u.

-r, --referrer

Le référent du jeton de portail. Utilisez-le pour limiter l’utilisation et désigner les URL ou adresses IP référentes qui peuvent accéder au service. Par exemple, vous pouvez limiter l’URL de votre organisation ArcGIS Enterprise.

-t, --token

Un jeton peut être généré et utilisé à la place du nom d'utilisateur et du mot de passe. Lorsqu'un jeton est fourni, il remplace le nom d'utilisateur ou le mot de passe indiqué.

Si vous spécifiez un référent, vous devez fournir un jeton de portail.

--select

Ce paramètre facultatif permet de fournir une liste définie de services à migrer. La liste doit se présenter au format suivant :

"[servicename1, servicename2, servicename3]"

-o, --output-dir

Ce paramètre facultatif permet de spécifier le répertoire de création du fichier de rapport de l’utilitaire (lors de l’exécution de l’utilitaire en mode analyse) ou du fichier journal (lors de l’exécution de l’utilitaire en mode exécution). S’il n’est pas défini, l’utilitaire génère le rapport ou le fichier journal dans un répertoire temporaire sur la machine sur laquelle vous exécutez l’utilitaire.

-l, --log_level

Utilisez ce paramètre facultatif pour définir le niveau de journalisation du fichier journal généré lors de l’exécution de l’utilitaire. Le niveau de journalisation par défaut est info si vous ne spécifiez pas ce paramètre avec une autre valeur.

Les valeurs valides, répertoriées de la plus verbose à la moins verbose, sont les suivantes :

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

Remplace le nombre par défaut de threads utilisés pour la migration. Le nombre par défaut de threads utilisés est 16.

Si vous remarquez que la totalité du processeur est utilisée pendant la migration de cache et que la migration n’aboutit pas ou qu’elle n’est pas complète, diminuez le nombre de threads utilisés par l’utilitaire.

Si vous modifiez ce paramètre, il est recommandé de définir le nombre de threads sur le nombre de cœurs présents sur la machine. Par exemple, si la machine dispose de quatre cœurs, définissez --num-threads sur 4.

-h, --help

Utilisez ce paramètre pour renvoyer la syntaxe pour l’utilitaire.

Exécuter l’utilitaire

Sur les machines ArcGIS Server, l’utilitaire MigrateSceneServices est installé dans le dossier <ArcGIS Server installation directory>\tools\MigrateSceneServices.

Vous devez exécuter l’utilitaire à partir de l’une des machines dans le serveur d’hébergement du portail ArcGIS Enterprise.

Lorsque vous exécutez l’utilitaire MigrateSceneServices, quel que soit le mode, un fichier journal est généré. Les deux modes affichent le nombre de services (couches de scènes) éligibles à la migration.

Le rapport généré lors de l’exécution de l’utilitaire en mode analyse donne la taille de chaque cache.

Conseil :

Si le magasin d’objets est installé sur la même machine que le data store de cache tuilé, identifiez la taille de cache la plus importante. Vérifiez que l’espace disque libre sur la machine du data store est suffisant pour recevoir au moins deux fois la taille de ce cache le plus volumineux, car pendant une courte durée lors de la migration, le cache est créé dans le magasin d’objets sans avoir encore été supprimé du data store de cache tuilé.

En mode execution, les entrées de journal relatives à l’opération de migration s’affichent, accompagnées du nombre de services qui ont été migrés.

Pour accéder à l’utilitaire et l’exécuter, procédez comme suit :

  1. Connectez-vous à l’une des machines du site de serveur d’hébergement à l’aide de l’identifiant du compte ArcGIS Server ou à l’aide d’un identifiant disposant des privilèges de lecture sur tous les répertoires ArcGIS Server.
  2. Ouvrez une fenêtre de commande et accédez au répertoire tools indiqué ci-dessus.
  3. Exécuter l’utilitaire MigrateSceneServices en mode analyse.

    Dans l’exemple suivant, l’utilitaire est exécuté en mode analyse et le fichier journal est placé dans un répertoire nommé analysislogs :

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

  4. Si le rapport généré suite à l’exécution de l’utilitaire en mode analyse indique que le déploiement est configuré pour permettre la migration et que des caches de couches de scènes doivent être migrés, exécutez l’utilitaire en mode exécution.

    L’exemple suivant migre les caches de toutes les couches de scènes :

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

  5. Dès que tous les caches de couches de scènes ont été migrés et testés, exécutez l’utilitaire une dernière fois en mode analyse pour vous assurer qu’il ne reste plus de caches à migrer.

Exemple d’utilisation

Une fois que l’administrateur a configuré un object store, l’administrateur ArcGIS Server exécute l’utilitaire MigrateSceneServices en mode analyse pour déterminer les services de scène qui doivent être migrés.

L’administrateur ArcGIS Server se connecte à l’une des machines du site ArcGIS Server utilisé comme serveur d’hébergement. L’administrateur utilise l’identifiant qui permet d’exécuter le service ArcGIS Server Microsoft Windows.

L’administrateur ouvre une fenêtre de commande, accède au répertoire tools et exécute la commande en mode analyse. Étant donné que le rapport est destiné à être partagé, l’administrateur spécifie un répertoire partagé pour la sortie.

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

L’utilitaire exécute et détermine que les caches de quatre des couches de scènes se trouvent dans le data store de cache tuilé et qu’ils peuvent être migrés. Les résultats sont présentés sur la ligne de commande et figurent dans le rapport créé dans le répertoire utiloutput. Le rapport montre que le cache de sceneservice1, sceneservice2, sceneservice3 et sceneservice4 se trouvent toujours dans le data store de cache tuilé.

Dans le rapport, chaque service est répertorié avec sa taille de cache, comme indiqué ci-dessous :

{
  "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)"
        ]
      }
    }
  ]
}

Les membres de l’équipe SIG consultent le rapport destiné à être partagé et vérifient chaque couche de scènes avant de procéder à la migration. Ils peuvent ainsi comparer le contenu et les performances de la couche avant et après la migration. Ils constatent que sceneservice3 est associé à un service d’entités qui est en train d’être activement mis à jour. Par conséquent, sceneservice3 ne sera pas migré tant que l’éditeur n’aura pas terminé le travail.

L’administrateur ArcGIS Server exécute l’utilitaire MigrateSceneServices pour déplacer les caches des trois autres couches de scènes.

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

Lorsque l’utilitaire a terminé, chaque cache de couche de scènes éligible a été migré. L’administrateur ArcGIS Server exécute de nouveau l’utilitaire MigrateSceneServices en mode analyse pour vérifier que plus aucun cache de couche de scènes ne doit être migré.

Après avoir testé et confirmé le fonctionnement de toutes les couches de scènes migrées, l’administrateur ArcGIS Data Store exécute l’utilitaire disabledatastore pour désinscrire le data store de cache tuilé du serveur d’hébergement et supprimer la totalité de son contenu.