Joindre un site existant

Un site est un déploiement d'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 (Rejoindre le site) ajoute une nouvelle machine à un site ArcGIS Server existant. 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 utilisez l’opération Se joindre au site pour procéder à 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, il est conseillé de vérifier 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 votre site se compose de machines ArcGIS Server qui s'exécutent sous Red Hat Enterprise Linux Server 6 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 posséder 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 Comment inscrire vos données auprès de ArcGIS Server pour en savoir plus sur ces emplacements inscrits.
• 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 emplacement de votre 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 les mêmes ID utilisateur (uid) ou ID de groupe (gid) pour pouvoir accéder en lecture et en écriture aux emplacements partagés de l’emplacement de la configuration et des répertoires de serveur.

Approfondissement :

Lorsque vous créez ou joignez une machine à un site, les journaux de niveau Verbeux 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 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.

Rejoindre un site à l’aide de Server Manager

Pour joindre une machine à un site avec 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 ou vous pouvez 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 (l'administrateur de site principal) ou d'un autre compte d'utilisateur d'ArcGIS Server auquel l'administrateur du serveur a accordé des privilèges administratifs.

   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 votre site a inscrit des types de data store relationnel, vous devez redémarrer ArcGIS Server sur chaque machine nouvellement ajoutée en exécutant les scripts stopserver/startserver en tant qu’administrateur de votre 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 utiliser l’utilitaire de ligne de commande join-site pour joindre votre 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 de faire appel à cet utilitaire si les machines de votre site ArcGIS Server sont déjà surchargées de demandes réseau ou si vous souhaitez joindre en même temps un nombre élevé de machines à votre site.

Les mêmes critères et recommandations s’appliquent aux machines pour utiliser l’utilitaire join-site que pour rejoindre un site à l’aide de Server Manager.

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

À partir de la version 10.8, l’utilitaire inclut un drapeau facultatif, -m, pour déterminer le moment auquel la machine nouvellement ajoutée peut commencer à traiter des demandes. Si vous incluez -m true dans la commande d’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’incluez pas -m ou incluez -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 autorisation 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 la ou 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 de la 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 rejoint le site.

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

La machine est jointe au site ArcGIS Server.