Si vous avez décidé de migrer ArcGIS Enterprise avec WebGISDR, les processus fournis sur cette page peuvent vous servir de base pour vous aider à effectuer votre migration. Les scénarios sur lesquels repose chaque processus sont destinés à fournir des indications générales pour des déploiements courants et peuvent ne pas être totalement adaptés à votre organisation.
Migrer un déploiement sur une seule machine
Si vous migrez un déploiement basé sur une seule machine, vous pouvez utiliser le même nom pour le nouvel et l’ancien environnement à l’aide du fichier \etc\hosts. Il existe deux modèles courants pour les déploiements sur une seule machine :
- Le nom de domaine complet de la machine correspond à celui de l’hôte dans l’URL utilisée pour accéder au déploiement.
- Le nom de domaine complet de la machine ne correspond pas à celui de l’hôte dans l’URL utilisée pour accéder au déploiement. Les utilisateurs accèdent au déploiement via un alias ou un enregistrement CNAME.
La façon d’ajouter des entrées dans le fichier \etc\hosts varie selon votre environnement.
Migrer lorsque le nom d’hôte de la machine correspond à l’URL de l’organisation
Dans ce scénario, ArcGIS Enterprise est installé sur une machine nommée enterprise.domain.com et fonctionne sur Windows Server 2016. Le nom d’hôte de la machine correspond au nom d’hôte de l’URL de l’organisation.
Les membres peuvent accéder à ArcGIS Enterprise des façons suivantes :
Accès des membres de l’organisation :
- Contenu et éléments : https://enterprise.domain.com/portal
- Extrémités du service : https://enterprise.domain.com/server/rest
Accès des administrateurs et éditeurs de l’organisation :
- ArcGIS Server Manager : https://enterprise.domain.com:6443/arcgis/manager
- Répertoire administrateur d’ArcGIS Portal : https://enterprise.domain.com:7443/arcgis/portaladmin
- Répertoire ArcGIS Portal : https://enterprise.domain.com:7443/arcgis/sharing/rest
Pour migrer ce type d’environnement, procédez comme suit :
- Activer le mode de lecture seule dans votre déploiement existant.
- Acquérez votre nouvelle machine.
Il peut s’agir d’une machine virtuelle ou d’une machine physique.
Dans cet exemple, le nom d’hôte de la machine est enterprise1.domain.com, son adresse IP est 10.0.0.2 et elle fonctionne sous Windows Server 2022.
- Sur la nouvelle machine, mettez à jour le fichier \etc\hosts pour résoudre l’adresse IP de la nouvelle machine sur enterprise.domain.com :
10.0.0.2 enterprise.domain.com
Vous devez mettre à jour le fichier \etc\hosts avant d’installer tout logiciel sur la nouvelle machine.
- Répétez l’étape 3 sur toute autre machine pouvant être utilisée pour tester et valider le nouveau système.
Remarque :
Ceci n’inclut pas la machine de production existante.
- Installez et configurez les composants ArcGIS Enterprise.
Une fois l’environnement configuré, vous ne pouvez accéder au nouvel environnement via le nom d’hôte enterprise.domain.com qu’à partir de la machine elle-même ou depuis toute autre machine sur laquelle vous avez ajouté l’entrée. Les machines ne possédant pas l’entrée effectueront la résolution enterprise.domain.com sur votre environnement de production original via DNS.
- Créer une sauvegarde avec l’utilitaire WebGISDR.
Il est important de tenir compte du timing lors de la création d’une sauvegarde. Lorsque vous créez une sauvegarde à l’aide de l’outil WebGISDR, seul le contenu présent dans le déploiement est migré. Ceci est particulièrement important à prendre en compte, si vous n’avez pas activé le mode lecture seul à l’étape 1. Pour éviter la perte de tout nouveau contenu, nous vous recommandons d’effectuer la sauvegarde pendant une période d’arrêt.
- Restaurez la sauvegarde sur la nouvelle machine à l’aide de l’outil WebGISDR.
Ceci créera une copie du déploiement existant sur la nouvelle machine.
- Utilisez une machine sur laquelle vous avez ajouté l’entrée \etc\hosts pour vérifier que les utilisateurs, contenus, groupes et services sont accessibles sur la nouvelle machine.
Seules les machines disposant de l’entrée 10.0.0.2 enterprise.domain.com dans le fichier hôtes effectueront la résolution enterprise.domain.com sur la nouvelle machine. Dans le cas contraire, les requêtes seront envoyées à la machine d’origine.
- Une fois l’environnement validé et que vous êtes prêt à effectuer la transition, mettez à jour le DNS pour résoudre enterprise.domain.com sur la nouvelle machine.
Toutes les requêtes adressées à enterprise.domain.com seront maintenant résolues sur la nouvelle machine, y compris le contenu provenant de l’ancien environnement.
- Supprimez l’entrée 10.0.0.2 enterprise.domain.com du fichier \etc\hosts sur la nouvelle machine et sur toutes les machines sur lesquelles vous l’avez ajoutée.
Migrer lorsque l’on accède à ArcGIS Enterprise via un alias
Dans ce scénario, ArcGIS Enterprise est installé sur une machine nommée machinename.domain.local et fonctionne sur un système d’exploitation Windows Server 2016. Votre DNS stocke un CNAME ou un alias pour la machine sous la forme : enterprise.domain.com.
Les membres accèdent à ArcGIS Enterprise des façons suivantes :
Accès des membres de l’organisation :
- Contenu et éléments : https://enterprise.domain.com/portal
- Extrémités du service : https://enterprise.domain.com/server/rest
Accès des administrateurs et éditeurs de l’organisation :
- ArcGIS Server Manager : https://machinename.domain.local:6443/arcgis/manager
- Répertoire administrateur d’ArcGIS Portal : https://machinename.domain.com:7443/arcgis/portaladmin
- Répertoire ArcGIS Portal : https://machinename.domain.com:7443/sharing/rest
Pour migrer vers ce type d’environnement, procédez comme suit :
- Activer le mode de lecture seule dans votre déploiement existant.
- Acquérez votre nouvelle machine.
Il peut s’agir d’une machine virtuelle ou d’une machine physique.
Dans cet exemple, le nom d’hôte de la machine est newmachine.domain.local, son adresse IP est 10.0.0.2 et elle fonctionne sous Windows Server 2022.
- Sur la nouvelle machine, mettez à jour le fichier \etc\hosts pour résoudre l’adresse IP de la nouvelle machine sur newmachine.domain.local ainsi que sur enterprise.domain.com :
10.0.0.2 newmachine.domain.local enterprise.domain.com
Vous devez mettre à jour le fichier \etc\hosts avant d’installer tout logiciel sur la nouvelle machine.
Réperorier le nom d’hôte local dans le fichier \etc\hosts, garantit tout d’abord que le logiciel stockera le nom contenu dans les fichiers de configuration, plutôt que l’alias DNS. Le fait d’ajouter l’alias DNS garantit que le déploiement peut être configuré avec l’alias DNS sans impact sur la production.
- Répétez l’étape 3 sur toute autre machine que vous utiliserez pour tester et valider le nouveau système.
Remarque :
Ceci n’inclut pas la machine de production existante.
- Installez et configurez les composants ArcGIS Enterprise. Utilisez l’alias DNS lors de l’enregistrement de Web Adaptor.
Une fois l’environnement configuré, vous ne pouvez accéder au nouvel environnement via le nom d’hôte enterprise.domain.com qu’à partir de la machine elle-même ou depuis toute autre machine sur laquelle vous avez ajouté l’entrée. Les machines ne possédant pas l’entrée effectueront la résolution enterprise.domain.com sur votre environnement de production original via DNS.
- Créer une sauvegarde avec l’utilitaire WebGISDR.
Il est important de tenir compte du timing lors de la création d’une sauvegarde. Lorsque vous créez une sauvegarde à l’aide de l’outil WebGISDR, seul le contenu présent dans le déploiement est migré. Ceci est particulièrement important à prendre en compte, si vous n’avez pas activé le mode lecture seul à l’étape 1. Pour éviter la perte de tout nouveau contenu, nous vous recommandons d’effectuer la sauvegarde pendant une période d’arrêt.
- Restaurez la sauvegarde sur la nouvelle machine à l’aide de l’outil WebGISDR.
Ceci créera une copie du déploiement existant sur la nouvelle machine.
- Utilisez une machine sur laquelle vous avez ajouté l’entrée \etc\hosts pour vérifier que les utilisateurs, contenus, groupes et services sont accessibles sur la nouvelle machine.
Seules les machines disposant de l’entrée 10.0.0.2 enterprise.domain.com dans le fichier hôtes effectueront la résolution enterprise.domain.com sur la nouvelle machine. Dans le cas contraire, les requêtes seront envoyées à la machine d’origine.
- Une fois l’environnement validé et que vous êtes prêt à effectuer la transition, mettez à jour le DNS pour résoudre enterprise.domain.com sur la nouvelle machine.
Toutes les requêtes adressées à enterprise.domain.com seront maintenant résolues sur la nouvelle machine, y compris le contenu provenant de l’ancien environnement.
- Supprimez l’entrée 10.0.0.2 enterprise.domain.com du fichier \etc\hosts sur la nouvelle machine et sur toutes les machines sur lesquelles vous l’avez ajoutée.
Migrer un déploiement multi-machines
Si vous disposez d’un environnement distribué, vous devez modifier le fichier \etc\hosts pour garantir que le composant servant d’interface frontale à votre déploiement (ses instances de ArcGIS Web Adaptor ou proxy inversé) renvoie vers le nom d’origine.
Dans ce scénario, les composants ArcGIS Enterprise sont répartis sur deux machines, toutes deux utilisant le système d’exploitation Windows 2016 :
- Deux instances de ArcGIS Web Adaptor sont installées sur une machine nommée enterprise.domain.com
- Portal for ArcGIS, ArcGIS Server et ArcGIS Data Store sont installés sur une machine nommée m1.domain.com
L’objectif de ce scénario est de migrer vers un système d’exploitation plus récent, par exemple ! Windows Server 2022.
Les membres accèdent à ArcGIS Enterprise des façons suivantes :
Accès des membres de l’organisation :
- Contenu et éléments : https://enterprise.domain.com/portal
- Extrémités du service : https://enterprise.domain.com/server/rest
Accès des administrateurs et éditeurs de l’organisation :
- ArcGIS Server Manager : https://m1.domain.local:6443/arcgis/manager
- Répertoire administrateur d’ArcGIS Portal : https://m1.domain.com:7443/arcgis/portaladmin
- Répertoire ArcGIS Portal : https://m1.domain.com:7443/arcgis/sharing/rest
Pour migrer un environnement avec ce scénario, procédez comme suit :
- Activer le mode de lecture seule dans votre déploiement existant.
- Acquérez deux nouvelles machines, l’une pour héberger les instances de ArcGIS Web Adaptor et l’autre pour exécuter le reste des composants.
La seule adresse IP qui importe dans ce cas est celle de la machine Web Adaptor, car les seuls paramètres devant correspondre entre les déploiements sont https://enterprise.domain.com/portal et https://enterprise.domain.com/server. Dans cet exemple, l’adresse IP de la nouvelle machine Web Adaptor est 10.0.0.2.
- Sur chaque nouvelle machine, mettez à jour le fichier \etc\hosts pour résoudre l’adresse IP de la machine Web Adaptor sur enterprise.domain.com :
10.0.0.2 enterprise.domain.com
- Installez les deux instances ArcGIS Web Adaptor sur enterprise1.domain.com.
- Installez Portal for ArcGIS, ArcGIS Server et ArcGIS Data Store sur m2.domain.com
- Créez le portail et les sites serveur.
- Inscrivez le Data Store sur le site du serveur.
- Configurez les instances de ArcGIS Web Adaptor sur enterprise1.domain.com en accédant à la page de configuration via https://enterprise.domain.com/portal/webadaptor et https://enterprise/domain.com/server/webadaptor.
Les requêtes seront résolues sur la nouvelle machine Web Adaptor (qui est actuellement enterprise1.domain.com) via le fichier \etc\hosts.
- Fédérez votre site serveur avec le portail et assurez-vous que l’URL des services utilisée est https://enterprise.domain.com/server.
L’URL d’administration peut être https://enterprise.domain.com/server ou https://m2.esri.com:6443/arcgis.
- Créer une sauvegarde avec l’utilitaire WebGISDR.
Il est important de tenir compte du timing lors de la création d’une sauvegarde. Lorsque vous créez une sauvegarde à l’aide de l’outil WebGISDR, seul le contenu présent dans le déploiement est migré. Ceci est particulièrement important à prendre en compte, si vous n’avez pas été en mesure d’activer le mode lecture seule à l’étape 1. Pour éviter la perte de tout nouveau contenu, nous vous recommandons d’effectuer la sauvegarde pendant une période d’arrêt.
- Restaurez la sauvegarde sur la nouvelle machine à l’aide de l’outil WebGISDR.
Ceci créera une copie du déploiement existant sur la nouvelle machine.
- Utilisez une machine sur laquelle vous avez ajouté l’entrée \etc\hosts pour vérifier que les utilisateurs, contenus, groupes et services sont accessibles sur la nouvelle machine.
Seules les machines disposant de l’entrée 10.0.0.2 enterprise.domain.com dans le fichier hôtes effectueront la résolution enterprise.domain.com sur la nouvelle machine. Dans le cas contraire, ces requêtes seront envoyées à la machine principale.
- Une fois l’environnement validé et que vous êtes prêt à effectuer la transition, mettez à jour le DNS pour résoudre enterprise.domain.com sur la nouvelle machine hébergeant le Web Adaptor et supprimez l’entrée \etc\hosts sur cette machine ainsi que sur m2.domain.com.
Toutes les requêtes adressées à enterprise.domain.com seront maintenant résolues vers la nouvelle machine, ce qui dirigera le trafic vers m2.domain.com. Vous pourrez alors travailler avec la totalité du contenu de votre ancien environnement sur vos nouvelles machines.
Effectuer une migration vers un déploiement dans le cloud
Si vous créez vos environnements à l’aide de modèles ArcGIS Enterprise Cloud Builder for Microsoft Azure ou AWS CloudFormation, vous n’avez pas l’occasion de modifier les entrées \etc\hosts avant d’installer et de configurer le logiciel. Il est donc nécessaire d’utiliser de nouvelles URL pour le déploiement.
Une fois l’environnement créé, vous pouvez mettre à jour les URL publiques de la nouvelle organisation afin de les faire correspondre à l’environnement de production existant. Les URL internes (privatePortalURL et l’URL administrateur utilisée pour la fédération) continuent de désigner le nom du nouveau DNS, ce qui permet au trafic interne de continuer d’aller vers le bon emplacement. Lorsque vous exécutez l’outil WebGISDR, il remplace tout le contenu dans l’environnement cible avec les URL correctes, ce qui finalise la migration.
Dans ce scénario, l’environnement de production existant utilise les URL suivantes :
- URL de l’organisation : https://enterprise.public.com/portal
- URL des services : https://enterprise.public.com/server
- Activer le mode de lecture seule dans votre déploiement existant.
- Créez un nouvel environnement avec des URL différentes.
Ce scénario utilise les URL suivantes :
- URL de l’organisation : https://enterprise-new.public.com/portal
- URL des services : https://enterprise-new.public.com/server
- Mettez l’URL de l’organisation à jour de sorte qu’elle désigne https://enterprise.public.com/portal.
- Mettez l’URL des services à jour de sorte qu’elle désigne https://enterprise.public.com/server.
- Créer une sauvegarde avec l’utilitaire WebGISDR.
Il est important de tenir compte du timing lors de la création d’une sauvegarde. Lorsque vous créez une sauvegarde à l’aide de l’outil WebGISDR, seul le contenu présent dans le déploiement est migré. Ceci est particulièrement important à prendre en compte, si vous n’avez pas été en mesure d’activer le mode lecture seule à l’étape 1. Pour éviter la perte de tout nouveau contenu, nous vous recommandons d’effectuer la sauvegarde pendant une période d’arrêt.
- Restaurez la sauvegarde dans le nouvel environnement à l’aide de l’outil WebGISDR.
Ceci crée un réplica du déploiement existant dans le nouvel environnement.
Vous avez un commentaire à formuler concernant cette rubrique ?