Configurer les répertoires ArcGIS Notebook Server

ArcGIS Notebook Server enregistre les configurations basées sur des fichiers et le contenu nécessaire à son fonctionnement dans des répertoires de serveur. Vous pouvez ajouter ces répertoires pendant l’installation et la configuration de ArcGIS Notebook Server ou les ajouter ultérieurement à l’aide de ArcGIS Notebook Server Manager.

Il existe quatre types de répertoires, chacun jouant un rôle spécifique dans les opérations du serveur : le répertoire d’espace de travail, le répertoire de données, le répertoire en sortie et le répertoire système. Le répertoire d’espace de travail et le répertoire de données sont décrits ci-dessous ; le répertoire en sortie et le répertoire système sont destinés à des usages internes à ArcGIS Notebook Server.

Répertoire d’espace de travail

Le répertoire d’espace de travail permet aux créateurs des notebooks d’enregistrer et de lire les fichiers utilisés dans leurs notebooks. Chaque créateur de notebook du portail ArcGIS Enterprise dispose d’un dossier unique dans le répertoire d’espace de travail. Le dossier unique d’un utilisateur est monté sur chaque ArcGIS Notebooks de façon à ce que le notebook puisse lire et écrire dans le répertoire d’espace de travail. Un notebook peut uniquement lire et écrire des données dans le dossier du répertoire d’espace de travail de son utilisateur. Ce dossier n’est pas accessible à partir des notebooks des autres utilisateurs.

Par défaut, les répertoires d’espace de travail privé des utilisateurs sont créés dans les dossiers /directories/arcgisworkspace/<userid>, les autorisations étant définies comme -rwxrwxrwx. Ce niveau d’autorisation est nécessaire car par défaut, le compte utilisateur Linux qui s’exécute dans le conteneur a un UID et un GID (ID de groupe) différents de ceux du compte utilisateur de votre système d’exploitation exécutant le démon ArcGIS Notebook Server.

Si vous ne souhaitez pas utiliser le modèle d’autorisation ouvert pour des raisons de sécurité, vous pouvez modifier le modèle à l’aide d’une propriété système nommée applyDefaultUserWorkspacePermissions. Lorsque cette propriété est définie sur true, les répertoires d’espace de travail sont créés en utilisant le paramètre par défaut de votre système, comme -rwx------, plutôt qu’avec le paramètre -rwxrwxrwx ouvert.

Pour utiliser cette fonction, l’utilisateur du système d’exploitation exécutant le démon ArcGIS Notebook Server doit avoir un UID de 1050 et un GID de 100 (pour correspondre à l’UID et au GID de l’utilisateur du conteneur).

1. Connectez-vous au répertoire administrateur. L’URL est au format https://notebookserver.domain.com:11443/arcgis/admin.
2. Accédez à System (Système) > Properties (Propriétés) et cliquez sur Edit (Modifier).
3. Ajoutez la chaîne JSON dans la zone des propriétés, puis enregistrez vos mises à jour :

   {
      "applyDefaultUserWorkspacePermissions":"true"
   }

Répertoire de données

Les données sont essentielles aux ArcGIS Notebooks. Lorsqu’ils créent des notebooks, les utilisateurs peuvent ajouter des couches de données à partir d’éléments du portail ArcGIS Enterprise, de serveurs SIG externes ou de répertoires de fichiers locaux.

Un répertoire local contenant des données peut être mis à la disposition des notebooks sous la forme d’un chemin d’accès à un fichier en l’inscrivant auprès du site ArcGIS Notebook Server. Il est possible d’inscrire plusieurs répertoires de données auprès d’un site de serveur. Chaque répertoire de données inscrit peut être utilisé par tous les notebooks qui s’exécutent sur ce site.

Les notebooks qui utilisent des processus d’analyse raster présentent un usage particulier des répertoires de données. Vous pouvez inscrire un répertoire de données raster sur fichier comme répertoire de données, afin que la sortie des outils d’analyse raster soit immédiatement disponible sur les notebooks.

Considérations relatives aux répertoires de données

Pour que les notebooks aient accès à un répertoire de données inscrit, définissez le mode d’autorisation 755 pour le répertoire.

Tous les créateurs de notebooks de votre organisation peuvent ajouter des données provenant de n’importe quel répertoire de données inscrit à leurs notebooks. Il est impossible de limiter les répertoires de données à certains utilisateurs ou groupes sur le portail.

Dans les processus d’apprentissage profond qui impliquent la création de fragments d’image pour entraîner un modèle, les fragments sont hébergés dans un répertoire de données raster sur fichier. Lorsque vous suivez un processus de ce type, inscrivez le répertoire de données raster auprès de ArcGIS Notebook Server sous forme de répertoire de données pour que les fragments d’image soient mis à la disposition de vos notebooks.

Les données d’un répertoire de données inscrit ne font pas partie du portail ArcGIS Enterprise. En conséquence, lors du partage d’un notebook, vous devez vous assurer que tous les utilisateurs qui verront le notebook partagé auront accès aux répertoires de données inscrits auxquels le notebook fait référence.

Inscrire un nouveau répertoire de données

Vous pouvez inscrire un répertoire de données auprès de ArcGIS Notebook Server Manager pour mettre à disposition un répertoire local sur le site de serveur.

1. Connectez-vous à votre portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.
2. Ouvrez la page Settings (Paramètres), et cliquez sur Directories (Répertoires).
3. Cliquez sur Register Data Directory (Enregistrer le répertoire de données) pour ouvrir la boîte de dialogue d’inscription.
4. Donnez un nom au répertoire et indiquez son chemin d’accès complet sur votre machine.
5. Précisez que le répertoire fonctionnera comme un répertoire DATA.
6. Cliquez sur Save (Enregistrer) pour confirmer.

Vous ne pouvez pas modifier ou mettre à jour le nom ou le chemin d’accès d’un répertoire inscrit auprès de ArcGIS Notebook Server. Pour apporter des modifications, vous devez annuler l’inscription du répertoire existant, puis le réinscrire.

Spécifier un nouvel emplacement pour un répertoire de serveur

Depuis la version 10.8, vous pouvez mettre à jour un répertoire existant dans Manager pour en modifier l’emplacement. Utilisez toujours cette méthode pour passer à un site à plusieurs machines et enregistrer vos répertoires à des chemins partagés.

1. Connectez-vous à votre portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.
2. Ouvrez la page Settings (Paramètres), et cliquez sur Directories (Répertoires).
3. Sélectionnez le répertoire à modifier, puis cliquez sur l’icône Edit (Mise à jour).
4. Remplacez le chemin actuel du répertoire par le nouveau chemin du répertoire. Cliquez sur Save (Enregistrer) pour confirmer.

   Après le redémarrage du site, le nouveau chemin sera utilisé pour accéder au répertoire.

5. Copiez et collez le contenu du répertoire existant au nouvel emplacement.

Répétez cette procédure pour chaque répertoire à mettre à jour.

Remarque :

Si l’emplacement du répertoire d’espace de travail Arcgis est mis à jour, vous devez réexécuter l’utilitaire d’installation afin d’extraire des données d’exemple vers le nouvel emplacement du répertoire d’espace de travail.