Skip to main content

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

ArcGIS Notebook Server prend en charge les sites à plusieurs machines. Sur un site comportant plusieurs ordinateurs, tous les ordinateurs sont configurés à l’identique, avec les mêmes configurations Docker, et tous peuvent exécuter des ArcGIS Notebooks.

ArcGIS Notebook Server prend en charge les sites à plusieurs licences, grâce à quoi toutes les machines faisant partie d’un site n’ont plus besoin du même niveau de licence. Vous pouvez par exemple configurer un site de trois machines comme suit : une machine configurée avec une licence avancée et deux machines configurées avec des licences standard. Cette fonctionnalité à plusieurs licences permet une meilleure adaptation de différentes machines dotées d’une licence avancée ou standard.

Les sites ArcGIS Notebook Server à plusieurs machines vous permettent de prendre en charge un plus grand nombre 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, pensez à modifier les limites de ressources de votre site plutôt que d’ajouter des machines.

Toutes les machines d’un site ArcGIS Notebook Server ont le même logiciel installé, avec la même version. Sur la première machine que vous configurez, vous devrez créer le site ArcGIS Notebook Server. Vous pouvez ensuite joindre des machines supplémentaires ArcGIS Notebook Server au site.

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 un site ArcGIS Notebook Server, vous spécifiez l’emplacement du configuration store 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 des é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 permis d’installer ArcGIS Notebook Server est celui 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 d’ArcGIS Notebook Server. Notez que l’installation d’ArcGIS Notebook Server avec le compte racine n’est pas prise en charge. Le compte d’utilisateur qui a servi à l’installation sur deux machines, 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 un moteur de conteneurisation pour ArcGIS Notebook Server. 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 post-installation (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 le propriétaire ags avec l'ID utilisateur 58103. Accordez au moins 700 autorisations sur le 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 le propriétaire ags avec l'ID utilisateur 58103. Accordez au moins 700 autorisations sur le 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. Depuis l’une des 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 d’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 informations d’identification de votre site ArcGIS Notebook Server créés à l’étape 4.

    5. Répétez les sous-é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. Assurez-vous que vous êtes connecté à la machine via 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 :

      Le paramètre

      Description

      -u ou --username

      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

      URL du site ArcGIS Notebook Server existant à rejoindre, au format https://notebookserver.domain.com:11443.

      -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

      Si les informations d’identification du compte et l’URL du site sont saisies correctement, 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. Continuez pour installer et configurer ArcGIS Web Adaptor avec votre site. Vous allez ensuite configurer votre site avec le portail ArcGIS Enterprise.

Rejoindre un site à partir de la ligne de commande

Vous pouvez également employer l’utilitaire de ligne de commande joinSite pour joindre la 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. Pensez à 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 en une seule opération.

L’utilitaire join-site est installé dans \tools\JoinSiteUtility, au sein du répertoire d’installation d’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 ArcGIS Notebook Server.

  1. Accordez un accès en lecture et en écriture au dossier du configuration store 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 configuration store du site ArcGIS Server existant :

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

    Dans cet exemple, le chemin d’accès au configuration store 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 du configuration store (connection.json) est censé 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.

ArcGIS Notebook Server prend en charge les sites à plusieurs machines. Sur un site à plusieurs machines, toutes les machines doivent avoir la même configuration, avec le même système d’exploitation, une configuration de moteur de conteneurisation identique et un lecteur réseau mappé avec la même lettre de lecteur pour le répertoire d’espace de travail.

Installer et configurer un site à plusieurs machines (conteneurs Windows)

Lorsque vous prévoyez de configurer un site ArcGIS Notebook Server à plusieurs machines, vous devez suivre des é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 43 pour la communication à partir de chaque machine de votre déploiement ArcGIS Enterprise.

    La version installée d’ArcGIS Notebook Server et son fichier de licence doivent être identiques sur chaque machine. Indiquez le même compte ArcGIS Notebook Server pour chaque installation. Il est conseillé d’utiliser un domaine ou un compte Active Directory. Cependant, si vous choisissez un compte local, il doit figurer sur toutes les machines et présenter une combinaison identique de nom et de mot de passe. N’oubliez pas que le compte que vous spécifiez n’a pas besoin de faire partie du groupe des administrateurs.

  2. Assurez-vous d’avoir effectué les actions suivantes pendant l’installation :

    1. Installez un moteur de conteneurisation pour ArcGIS Notebook Server 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. ArcGIS Notebook Server sur Windows prend uniquement en charge les conteneurs Windows. Téléchargez les images de conteneur correspondant à votre installation à partir de My Esri et exécutez la ligne de commande de l’utilitaire post-installation (situé dans <ArcGIS Notebook Server installation directory>\tools\postInstallUtility) afin d’installer les images de conteneur pour ArcGIS Notebook Server. Répétez cette étape sur toutes les machines ArcGIS Notebook Server. 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. L’un d’eux est destiné au stockage de la configuration et l’autre à certains des répertoires de serveur. Le répertoire workspace doit être conservé sur un partage UNC mappé comme lecteur réseau. Accordez des autorisations d’accès en lecture et en écriture à ces deux répertoires au compte ArcGIS Notebook Server sur chaque machine (veillez à le faire sous l’onglet Sharing (Partage) et sous l’onglet Security (Sécurité) de l’Explorateur Microsoft).

    Remarque :

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

    • 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 (UNC).

    • Si le compte ArcGIS Notebook Server n’existe pas sur la machine (dans le cas où vous avez placé le configuration store et les répertoires de serveur sur un serveur de fichiers), vous devez créer le compte ArcGIS Notebook Server en spécifiant le nom et le mot de passe que vous avez utilisés sur toutes les autres machines du déploiement.

    • Si vous utilisez un compte de service administré de groupe (gMSA) comme compte ArcGIS Notebook Server, vous devez accorder aux comptes de service les autorisations de contrôle total sous les onglets Sharing (Partage) et Security (Sécurité). Dans l’éditeur Permissions (Autorisations), cliquez sur Add (Ajouter) et ouvrez la boîte de dialogue Object Types (Types d’objets). Cochez la case Service Accounts (Comptes de service).

  4. Depuis l’une des 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 d’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 informations d’identification de votre site ArcGIS Notebook Server créés à l’étape 4.

    5. Répétez les sous-étapes a à d pour chaque machine supplémentaire que vous souhaitez joindre au site.

    Lorsque des machines supplémentaires sont ajoutées au site, elles sont considérées égales sur le site, c’est-à-dire qu’il n’existe pas de machine principale.

  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. Assurez-vous que vous êtes connecté à la machine via 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.bat. Voici les paramètres de ligne de commande de l’utilitaire :

      Le paramètre

      Description

      -u ou --username

      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

      URL du site ArcGIS Notebook Server existant à rejoindre, au format https://notebookserver.domain.com:11443.

      -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.bat -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443

      Si les informations d’identification du compte et l’URL du site sont saisies correctement, l’utilitaire joint la machine au site ArcGIS Notebook Server. Recommencez cette étape pour chaque machine supplémentaire.

  7. Accordez un accès en lecture et en écriture au dossier du configuration store 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.

  8. Créez un fichier JavaScript Object Notation (JSON) nommé connection.json.

  9. Ajoutez la ligne suivante au fichier en remplaçant <path to the configuration store> par l’emplacement du configuration store du site ArcGIS Server existant :

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

    Dans cet exemple, le chemin d’accès au configuration store du site existant est \\\\myshare\\arcgisserver\\config-store

    {" configPersistenceType": "FILESYSTEM", "connectionString": "\\\\myshare\\arcgisserver\\config-store"}

Configurer un lecteur réseau mappé pour le répertoire d’espace de travail

Ce traitement facultatif est requis uniquement si vous prévoyez de configurer un site Notebook Server comprenant plusieurs machines.

  1. Créez un partage UNC pour le répertoire d’espace de travail ArcGIS Notebook Server sur une machine distincte, accessible à Notebook Server.

    Remarque :

    Ce répertoire doit disposer d’un accès en lecture et en écriture sur le compte Exécuter en tant que d’ArcGIS Notebook Server Windows. Il est recommandé de créer un partage UNC pour le répertoire d’espace de travail ArcGIS Notebook Server sur une machine distincte de celle participant au site ArcGIS Notebook Server. Il existe un problème connu concernant les partages SMB créés sur la même machine que Notebook Server qui se déconnectent au redémarrage de la machine.

  2. Sur la machine Notebook Server, ouvrez une fenêtre PowerShell en tant qu’administrateur.

  3. Enregistrez votre mot de passe de compte utilisateur ArcGIS Notebook Server sous forme de chaîne sécurisée en vue d’une utilisation ultérieure à l’aide de la commande suivante :

    $password = ConvertTo-SecureString '<password>' -AsPlainText -Force

  4. Ajoutez la prise en charge des identifiants de connexion aux fonctions PowerShell :

    $credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password)

  5. Montez le dossier avec l’indicateur Persistent (Persistant) défini :

    New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>:

  6. Répétez les étapes 2 à 5 sur toutes les machines qui participent au site ArcGIS Notebook Server et attribuez la même lettre de lecteur au lecteur mappé sur toutes les machines.

  7. Utilisez le lecteur de réseau partagé créé à l’étape précédente pour configurer le répertoire d’espace de travail à la création du site ArcGIS Notebook Server.