Joindre un site existant

Un site est un déploiement de ArcGIS Server. Si vous avez installé ArcGIS Server sur une machine en vue de l’ajouter à un site existant, vous pouvez indiquer ce site la première fois que vous ouvrez ArcGIS Server Manager. Vous pouvez également ajouter une machine à un site au moyen d’un utilitaire de ligne de commande

Remarque :

Si votre site existant a été configuré pour utiliser le protocole HTTP uniquement, vous devez ajouter le nouveau serveur au site, comme décrit dans la rubrique Ajouter une machine ArcGIS Server à un site.

Considérations avant de rejoindre un site

L’opération Join Site (Se joindre au site) ajoute une nouvelle machine à un site ArcGIS Server. Cet ajout peut être temporaire, pour migrer vers de nouvelles machines, ou permanent, pour accroître les ressources et la puissance de traitement de votre site serveur. Si vous exécutez l’opération Join Site (Joindre au site) pour la migration, il n’est pas nécessaire que les machines nouvelles et existantes correspondent, mais si vous avez l’intention de conserver toutes les machines du site, vérifiez qu’elles respectent les critères suivants :

• La nouvelle machine doit s’exécuter sur la même plateforme de système d’exploitation que les autres machines ArcGIS Server du site. Il est recommandé d'utiliser la même version du système d'exploitation et les mêmes ressources matérielles pour toutes les machines dans votre site. Par exemple, si un site est composé de machines ArcGIS Server qui s’exécutent sous Red Hat Enterprise Linux Server 8 avec un processeur de 3 GHz et une mémoire RAM de 8 Go, la machine que vous ajoutez au site doit présenter les mêmes spécifications matérielles et le même système d’exploitation.
• La nouvelle machine doit s’exécuter sous le même numéro de version que les autres machines ArcGIS Server du site.
• La nouvelle machine doit être concédée avec la même licence que les autres machines ArcGIS Server du site.
• La nouvelle machine doit détenir des autorisations en lecture et en écriture sur l’emplacement de la configuration et les répertoires de serveur du site.
• La nouvelle machine doit pouvoir communiquer avec toutes les autres machines ArcGIS Server du site via les ports répertoriés à la rubrique Ports utilisés par ArcGIS Server. Il faudra éventuellement ajuster les paramètres de pare-feu.
• La nouvelle machine doit pouvoir lire les données référencées par les services du site. Pour le savoir, vérifiez si la machine détient des autorisations sur tous les emplacements de stockage des données inscrits auprès du site. Reportez-vous à la rubrique Sources de données pour ArcGIS Server pour en savoir plus sur les emplacements inscrits.
• La nouvelle machine doit être configurée avec le même fuseau horaire que les autres machines ArcGIS Server du site ; dans le cas contraire, l’opération joinSite échoue avec une erreur de licence.
• Toutes les machines ArcGIS Server doivent détenir des autorisations en lecture et en écriture sur les mêmes répertoires partagés via NFS en utilisant le même point de montage sur tous les systèmes. Par exemple, si vous montez un répertoire partagé de serveur de fichier sur /arcgis sur une machine et que vous l’utilisez comme votre répertoire de configuration et pour vos répertoires de serveur, toutes les machines doivent également monter ce même répertoire sur /arcgis.
• Toutes les machines ArcGIS Server doivent s’exécuter avec le même ID utilisateur (uid) ou ID de groupe (gid) pour pouvoir accéder en lecture et en écriture aux emplacements partagés du répertoire de configuration et des répertoires de serveur.

Approfondissement :

Lorsque vous créez ou joignez une machine à un site, les journaux de niveau Verbose (Commentaires) sont écrits dans <ArcGIS Server installation directory>/usr/logs/<machine name>/server. Si la création ou l'ajout du site échoue, vous pouvez ouvrir les journaux avec un éditeur de texte pour obtenir davantage d'informations sur le problème.

Une fois la jointure ou la création du site terminée, les journaux sont déplacés vers <ArcGIS Server installation directory>/arcgis/server/usr/logs et le niveau de consignation est défini sur Warning (Avertissement). Si le compte ArcGIS Server n'est pas autorisé à créer ce dossier ou à y écrire des informations, la jointure ou la création du site échoue. Si vous ne souhaitez pas accorder au compte ArcGIS Server les autorisations nécessaires pour créer des dossiers sur la totalité de votre lecteur, vous pouvez créer manuellement ce dossier au préalable et accorder au compte ArcGIS Server les autorisations nécessaires pour y consigner des informations.

Joindre à un site à l’aide de Server Manager

Pour joindre une machine à un site à l’aide de l’application ArcGIS Server Manager, procédez comme suit :

1. Ouvrez Server Manager. L’URL qui permet d’ouvrir Server Manager dans un navigateur est https://gisserver.domain.com:6443/arcgis/manager ; vous pouvez également utiliser le raccourci installé.

   Si vous êtes invité à spécifier un nom d’utilisateur et un mot de passe, cela signifie qu’un autre utilisateur a déjà joint cette machine à un site existant.

2. Cliquez sur Se joindre à un site.
3. Tapez l'URL du site auquel vous souhaitez vous joindre. L’URL suit généralement le format https://gisserver.domain.com:6443/.
4. Tapez le nom d'administrateur et le mot de passe du site auquel vous souhaitez vous joindre. Il peut s’agir du nom d’utilisateur et du mot de passe que vous avez utilisés lorsque vous avez créé le site (administrateur de site principal) ou d’un autre compte d’utilisateur ArcGIS Server auquel l’administrateur du serveur a accordé des privilèges d’administration.

   Cliquez sur Next (Suivant).

5. Consultez le récapitulatif de la configuration, puis cliquez sur Terminer lorsque vous êtes prêt à joindre la machine au site.
6. Si le site comporte des types de connecteur de base de données, vous devez redémarrer ArcGIS Server sur chaque machine nouvellement ajoutée en exécutant les scripts stopserver/startserver en tant que propriétaire de l’instance ArcGIS Server. Ces scripts se trouvent dans le répertoire $AGSHOME. Après le redémarrage, l’instance ArcGIS Server sur chaque machine ajoutée est opérationnelle.

Votre machine est maintenant ajoutée au site.

Rejoindre un site à partir de la ligne de commande

Vous pouvez également employer l’utilitaire de ligne de commande join-site pour joindre la machine à un site ArcGIS Server. Cet utilitaire exige que vous indiquiez l’emplacement de la configuration du site existant plutôt que son URL. Il présente donc un avantage dans certains cas où l’utilisation de l’URL pourrait bloquer la file d’attente des demandes réseau du site. Envisagez d’utiliser cet utilitaire si les machines de votre site ArcGIS Server sont déjà surchargés de demandes réseau ou si vous souhaitez joindre un grand nombre de machines à votre site simultanément.

Les mêmes critères et recommandations s’appliquent aux machines lorsque vous faites appel à l’utilitaire join-site que lorsque vous utilisez Server Manager pour joindre un site.

L’utilitaire join-site est installé dans /tools/JoinSite sous le répertoire d’installation de ArcGIS Server. Exécutez l’utilitaire join-site sur la machine ArcGIS Server que vous souhaitez ajouter à un site existant, en utilisant le compte Run As (Exécuter en tant que) pour ArcGIS Server.

À partir de la version 10.8, l’utilitaire inclut un indicateur facultatif, -m, pour déterminer le moment auquel la machine nouvellement ajoutée peut commencer à traiter des demandes. Si vous indiquez -m true dans la commande de l’utilitaire, la machine est placée en maintenance lorsqu’elle rejoint le site. Lorsqu’une machine est en maintenance, ArcGIS Web Adaptor ne lui envoie aucune demande. Si vous n’indiquez pas -m ou si vous spécifiez -m false, la machine est en mesure de traiter des demandes dès qu’elle est ajoutée au site de serveur.

1. Accordez des autorisations d’accès en lecture et en écriture sur le répertoire de l’emplacement de la configuration du site existant au compte utilisé pour installer ArcGIS Server sur les machines que vous joignez au site.
2. Créez un fichier JavaScript Object Notation (JSON) nommé connection.json.
3. Ajoutez la ligne suivante au fichier en remplaçant <path to the configuration store> par l’emplacement du magasin de configuration du site ArcGIS Server existant :

   {"type": "FILESYSTEM", "connectionString": "<path to the configuration store>"}

   Dans cet exemple, le chemin d’accès à l’emplacement de la configuration du site existant est /net/myserver/share/config-store :

   {"type": "FILESYSTEM", "connectionString": "/net/myserver/arcgis/server/usr/config-store"}

4. Enregistrez et fermez le fichier connection.json.
5. Placez le fichier connection.json sur la machine qui sera jointe au site ou dans un répertoire partagé auquel vous pouvez accéder via la machine qui sera jointe au site.
6. Ouvrez une invite de commande et exécutez l'utilitaire join-site.
   La syntaxe est la suivante :

   ./join-site.sh -f <The file path to the configuration store JSON file> -m <specify true to initially place the machine under maintenance>

   Dans cet exemple, le chemin d’accès au fichier JSON de l’emplacement de la configuration (connection.json) est /usr/serverfiles et la machine n’est pas placée en maintenance lorsqu’elle est jointe au site.

   ./join-site.sh -f "/usr/serverfiles/connection.json"

La machine est jointe au site ArcGIS Server.