Configurer les répertoires d’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. Il est possible d’ajouter ces répertoires pendant l’installation et la configuration d’ArcGIS Notebook Server ou les ajouter ultérieurement à l’aide d’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. Votre dossier unique est monté sur chacun de vos 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 qui exécute le démon ArcGIS Notebook Server doit posséder l’UID 1050 et le GID 100 (afin de correspondre à l’UID et au GID de l’utilisateur du conteneur).

Connectez-vous au répertoire administrateur.

L’URL est au format https://notebookserver.domain.com:11443/arcgis/admin.
Accédez à System (Système) > Properties (Propriétés) et cliquez sur Edit (Modifier).
Ajoutez la chaîne JSON dans la zone des propriétés, puis enregistrez la mise à jour :
```
{
   "applyDefaultUserWorkspacePermissions":"true"
}
```

Répertoire de données

Les données sont essentielles pour ArcGIS Notebooks. Lorsque vous créez des notebooks, vous pouvez 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. Une fois qu’un répertoire de données a été inscrit auprès de votre site ArcGIS Notebook Server, il est accessible et peut être utilisé par tous les notebooks qui s’exécutent sur ce site. Les répertoires de données sont accessibles depuis l’onglet Files (Fichiers) dans l’éditeur de notebooks. Il est possible d’inscrire plusieurs répertoires de données auprès d’un site de serveur.

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, ce dernier doit accorder des autorisations de lecture et d’exécution à tous les utilisateurs.

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. Vous ne pouvez pas limiter les répertoires de données à certains utilisateurs ou groupes sur le portail.

Dans les processus de Deep Learning qui impliquent la génération de fragments d’image pour entraîner un modèle, il est recommandé d’utiliser votre raster store pour générer les fragments, puis de les télécharger sur votre espace de travail Notebook Server plutôt que d’inscrire le raster store. Une fois les fragments téléchargés, vous pouvez traiter les données et entraîner le modèle depuis votre notebook.

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 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.

Remarque :

Pour télécharger ou écrire dans cet emplacement de répertoire de données personnalisé, le répertoire doit disposer d’autorisations de lecture et d’écriture pour l’utilisateur "arcgis" (groupe "utilisateurs") qui se trouve dans le conteneur de notebook.

Connectez-vous au portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.
Ouvrez la page Settings (Paramètres), et cliquez sur Directories (Répertoires).
Cliquez sur Register Data Directory (Inscrire un répertoire de données) pour ouvrir la boîte de dialogue d’inscription.
Donnez un nom au répertoire et indiquez son chemin d’accès complet sur votre machine.
Précisez que le répertoire fonctionnera comme un répertoire DATA.
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 d’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.

Remarque :

Utilisez un chemin de répertoire local pour le répertoire arcgisworkspace et pour tous les répertoires de données personnalisées que vos utilisateurs inscrivent auprès du site. Le même chemin de répertoire doit exister sur toutes les machines d’un site à plusieurs machines.

Connectez-vous au portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.
Ouvrez la page Settings (Paramètres), et cliquez sur Directories (Répertoires).
Sélectionnez le répertoire à modifier, puis cliquez sur le bouton Edit (Mise à jour).
Remplacez la valeur Directory Path (Chemin du répertoire) existante par le nouveau chemin d’accès au 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.
Copiez et collez le contenu du répertoire existant au nouvel emplacement.

Ajouter un chemin UNC ou un dossier partagé en tant que répertoire de données dans les conteneurs Windows

Pour ajouter un chemin UNC ou un dossier partagé en tant que répertoire de données dans les conteneurs Windows, procédez comme suit :

Suivez les étapes 1 à 5 de la section Configurer un lecteur réseau apparié pour le répertoire d’espace de travail afin de créer un lecteur apparié avec le chemin UNC.
Suivez les étapes de la section Inscrire un répertoire de données ci-dessus pour inscrire le nouveau lecteur mappé.

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.