Joindre des machines supplémentaires à un site ArcGIS Notebook Server

ArcGIS Notebook Server prend en charge les sites à plusieurs machines à partir de la version 10.7.1. Sur un site à plusieurs machines, toutes les machines sont configurées de manière identique, avec les mêmes paramètres Docker et toutes peuvent exécuter ArcGIS Notebooks.

Héritage :

La version 10.7 prenait en charge uniquement les sites à une seule machine.

Les sites ArcGIS Notebook Server à plusieurs machines vous permettent de prendre en charge davantage d’utilisateurs de notebooks simultanés. Si vous avez de nombreux utilisateurs actifs ou si les ressources de votre machine unique ne sont pas adaptées aux besoins de vos utilisateurs, l’extension à un site à plusieurs machines peut être une bonne idée.

Remarque :

Si quelques-uns de vos utilisateurs de notebook ont besoin de davantage de ressources machine, vous pouvez envisager de modifier les limites de ressources de votre site plutôt que d’ajouter des machines.

Le même logiciel est installé sur toutes les machines d’un site ArcGIS Notebook Server, avec la même version et le même fichier de licence. Sur la première machine que vous configurez, vous devez créer le site ArcGIS Notebook Server. Vous pourrez alors y joindre des machines ArcGIS Notebook Server supplémentaires.

Remarque :

Contrairement aux autres rôles ArcGIS Server, ArcGIS Notebook Server ne prend pas en charge l’ajout de machines supplémentaires à un site à partir de la première machine. Vous devez tour à tour accéder à chaque machine et les joindre au site à l’aide de l’assistant de configuration ArcGIS Notebook Server ou de l’utilitaire joinsite.

Avant de procéder à l'installation

Lorsque vous créez un site, vous choisissez l’emplacement de stockage de la configuration, d’un répertoire hébergeant les fichiers importants et des informations de configuration de votre site. Votre site comporte également des répertoires de serveur system et workspace.

Lorsque vous créez pour la première fois un site ArcGIS Notebook Server, vous indiquez l’emplacement de stockage de la configuration et des répertoires de serveur. Sur un site à plusieurs machines, vous devez partager le stockage de la configuration et les répertoires de serveur pour que les autres machines puissent y accéder. Chaque machine qui est ajoutée au site doit disposer des autorisations de lecture et d’écriture sur ces emplacements partagés.

Installer et configurer un site à plusieurs machines

Lorsque vous prévoyez de configurer un site ArcGIS Notebook Server à plusieurs machines, vous devez suivre certaines étapes supplémentaires, indiquées dans ce guide d’installation.

1. Examinez la configuration système requise pour ArcGIS Notebook Server afin de vérifier que toutes vos machines sont compatibles. Sur chaque machine, ajustez les pare-feux pour ouvrir le port 11443 pour la communication à partir de chaque machine de votre déploiement ArcGIS Enterprise.

   Veillez à effectuer l'installation en spécifiant le même utilisateur du système d'exploitation sur les deux machines. Le compte d’utilisateur qui a servi à installer ArcGIS Notebook Server est celui qui sera utilisé pour exécuter le logiciel. Les utilisateurs de groupe et tous les autres utilisateurs doivent au moins disposer d’autorisations d’exécution sur le répertoire d’installation ArcGIS Notebook Server. Notez que l’installation de ArcGIS Notebook Server avec le compte racine n’est pas pris en charge. Le compte d’utilisateur qui a servi à l’installation sur deux machines différentes, par exemple, peut être comme suit :

   1. Installez ArcGIS Notebook Server sur la première machine à l’emplacement /data/ags en tant qu’utilisateur ags, avec l’ID d’utilisateur 58103.
   2. Installez ArcGIS Notebook Server sur une deuxième machine à l’emplacement /data/ags avec le même nom d’utilisateur et le même ID (ags, ID d’utilisateur 58103).
2. Assurez-vous d’avoir effectué les actions suivantes pendant l’installation :
   1. Installez Docker sur chaque machine. Sur chaque machine, téléchargez les images Docker fournies par Esri et enregistrez-les à un emplacement auquel le système a accès.
   2. Installez et autorisez ArcGIS Notebook Server sur chaque machine. Vous pouvez également installer le logiciel en mode silencieux.
   3. Exécutez la ligne de commande de l’utilitaire PostInstaller (disponible ici : <ArcGIS Notebook Server installation directory>/tools/postInstallUtility) pour charger les images Docker dans le référentiel local sur chaque machine.
   4. Suivez la procédure pour configurer ArcGIS Notebook Server après l’installation.
3. Créez et partagez deux répertoires sur votre réseau en désignant l’utilisateur de l’installation comme propriétaire. L'un d'eux est destiné au stockage de la configuration et l'autre aux répertoires du serveur. Vous devez accorder au moins 700 autorisations d'accès aux dossiers.

   Remarque :

   Les répertoires réseau partagés qui sont masqués ou qui utilisent des caractères spéciaux (par exemple, $) ne sont pas pris en charge par ArcGIS Notebook Server.

   Par exemple :
   1. Créez un répertoire appelé config-store. Spécifiez ags comme propriétaire et 58103 comme ID d’utilisateur. Accordez au moins 700 autorisations au répertoire.
   2. Partagez le dossier config-store pour que les deux machines puissent accéder au répertoire via le même chemin, à savoir /net/myserver/config-store.
   3. Créez un répertoire appelé arcgisnotebookserver. Spécifiez ags comme propriétaire et 58103 comme ID d’utilisateur. Accordez au moins 700 autorisations au répertoire.
   4. Partagez le dossier arcgisnotebookserver de sorte que les deux machines puissent accéder au répertoire en utilisant le même chemin, par exemple /net/myserver/arcgisnotebookserver.

      Même si les répertoires se trouvent sur la machine que vous utiliserez pour créer le site, vous devez néanmoins les créer manuellement et les partager, puis y faire référence via un chemin d'accès au réseau.

4. Sur une de vos machines, créez un site ArcGIS Notebook Server. Assurez-vous d’utiliser les chemins d’accès aux répertoires de serveur et au stockage de la configuration que vous avez définis précédemment.
5. Une fois les étapes précédentes effectuées, vous pouvez joindre chaque machine supplémentaire au site que vous avez créé en utilisant un assistant de configuration. Si vous préférez joindre le site à partir de la ligne de commande, reportez-vous à l’étape 6.
   1. Sur la première machine supplémentaire, ouvrez l’assistant de configuration ArcGIS Notebook Server.
   2. Consultez et suivez les instructions de l’assistant, puis cliquez sur Continue (Continuer).
   3. Cliquez sur Joindre un site existant.
   4. Saisissez l’URL du site et les identifiants de connexion pour votre site ArcGIS Notebook Server créés à l’étape 4.
   5. Répétez les étapes a à d pour chaque machine supplémentaire que vous souhaitez joindre au site.
6. Si vous ne souhaitez pas utiliser l’assistant de configuration, vous pouvez joindre la machine au site en utilisant un utilitaire de ligne de commande comme suit.
   1. Vérifiez que vous êtes connecté à la machine avec le compte ArcGIS Notebook Server.
   2. Ouvrez une invite de commande et exécutez l’utilitaire qui se trouve dans le répertoire <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh. Voici les paramètres de ligne de commande de l’utilitaire :

      Paramètre	Description
      -u ou --username	Le nom d’utilisateur de l’administrateur de site principal. Le nom d’utilisateur ne doit pas contenir ces caractères : \/:*?|<>
      -p ou --password	Mot de passe de l’administrateur de site principal. Le mot de passe ne doit pas contenir ces caractères : \/:*?|<>
      -f ou --file	Le fichier de connexion du magasin de configuration pour l’utilitaire joinsite.
      -s ou --siteUrl	L’URL du site ArcGIS Notebook Server existant à rejoindre, au format https://notebookserver.domain.com:11443/arcgis/admin..
      -h ou --help	Affiche l’aide sur la ligne de commande et ferme l’outil.

      Exemple de commande pour l’utilitaire :

      <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443/arcgis/admin

      Si les identifiants de connexion du compte et l’URL du site sont correctement saisis, l’utilitaire joint la machine au site ArcGIS Notebook Server. Recommencez cette étape pour chaque machine supplémentaire.

Une fois que toutes machines sont jointes au site, la suite du processus de configuration est la même que pour les sites à une seule machine. Procédez à l’installation et à la configuration de ArcGIS Web Adaptor avec votre site. Configurez ensuite votre site avec votre portail ArcGIS Enterprise.

Rejoindre un site à partir de la ligne de commande

Vous pouvez aussi utiliser l’utilitaire de ligne de commande joinSite pour ajouter votre machine à un site ArcGIS Notebook 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 Notebook Server sont déjà surchargés de demandes réseau ou si vous souhaitez joindre un grand nombre de machines à votre site simultanément.

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

1. Accordez un accès en lecture et en écriture au dossier de l'emplacement de la configuration du site existant pour le compte réseau utilisé pour exécuter le service ArcGIS Notebook Server sur la ou les machines à joindre 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 :

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

   Dans cet exemple, le chemin d’accès au magasin de configuration du site existant est /net/mymachine/data/arcgisnotebookserver/usr/config-store :

   {"connectionString": "/net/mymachine/data/arcgisnotebookserver/usr/config-store", " configPersistenceType": "FILESYSTEM" }

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 join-site.
La syntaxe est la suivante :
joinSite -f <The file path to the configuration store JSON file>
Dans cet exemple, le fichier JSON de l’emplacement de la configuration (connection.json) est supposé se trouver dans le même répertoire que l’outil join-site (\tools\JoinSiteUtility).
joinsite.bat -f connection.json

La machine est jointe au site ArcGIS Notebook Server.