Skip To Content

Problèmes courants et solutions

Les questions ou les problèmes susceptibles de surgir lors de l’utilisation de ArcGIS Notebook Server et les solutions possibles sont répertoriées ci-après. Si le problème que vous rencontrez n'est pas répertorié ici, pensez à le rechercher dans les articles proposés sur le site Web du Centre de support technique Esri.

Installation

Accès aux notebooks

Notebooks

Installation

Le répertoire d’administration de ArcGIS Notebook Server sur Windows ne répond pas après l’installation ou le redémarrage de la machine Notebook Server.

Ce problème peut se produire si le service ArcGIS Notebook Server Windows et le service Docker ne démarrent pas dans l’ordre approprié après l’installation ou le redémarrage de la machine.

Pour résoudre ce problème, définissez le service ArcGIS Notebook Server Windows de façon à le démarrer automatiquement en différé. Ce faisant, vous permettez au service Docker Windows de s’initialiser complètement avant le démarrage du service ArcGIS Notebook Server Windows.

Pour configurer le service ArcGIS Notebook Server Windows de façon à le démarrer automatiquement en différé, procédez comme suit :

  1. Ouvrez l’application Services sur votre machine ArcGIS Notebook Server Windows.
  2. Cliquez avec le bouton droit sur le service ArcGIS Notebook Server et sélectionnez Properties (Propriétés).
  3. Cliquez sur Général.
  4. Dans Startup type, sélectionnez Automatic (Delayed Start) (Automatique [début différé]).
  5. Cliquez sur Apply (Appliquer).
  6. Redémarrez votre machine pour appliquer les modifications.
  7. Si plusieurs machines font partie de votre site ArcGIS Notebook Server, répétez ces étapes sur chacune d’entre elles.

Lors du chargement des images runtime Notebook, le message d’erreur no space left on device (espace insuffisant sur l’appareil) s’affiche alors qu’il reste de l’espace sur le disque où sont installés ArcGIS Notebook Server et Docker.

Examinez l’allocation avancée des ressources dans les paramètres de bureau Docker, et vérifiez que la taille d’image disque allouée est suffisante pour l’emplacement de l’image disque. Augmentez l’espace disque alloué et réessayez de charger les images runtime Notebook.

Comment supprimer les images de conteneur précédentes d’une machine ?

Sur Windows Server avec Mirantis Container Runtime, les images de conteneur se trouvent dans le dossier C:\ProgramData\docker\windowsfilter. Pour supprimer toutes les images de conteneur précédentes d’une machine et libérer de l’espace disque, exécutez la commande ci-après dans PowerShell avec les privilèges d’administrateur.

docker system prune -af

Si toutes les couches d’images ne sont pas supprimées de C:\ProgramData\docker\windowsfilter, redémarrez la machine et exécutez les commandes ci-après dans PowerShell avec les privilèges d’administrateur.

Remarque :

Effectuez ces opérations avant de charger l’image de conteneur Windows ArcGIS Notebook Server, car ce processus supprime toutes les images de conteneur de la machine.

  • $FolderPath = "C:\ProgramData\docker\windowsfilter"
  • Get-ChildItem -Path $FolderPath -Directory | % {Rename-Item $_.FullName "$($_.FullName)-removing" -ErrorAction:SilentlyContinue}
  • while ((Get-ChildItem -Path $FolderPath -Force | Measure-Object).Count -gt 0)
    {
    Restart-Service docker
    }

Accès aux notebooks

Lorsque j’essaie d’ouvrir un notebook, le message d’erreur ci-après s’affiche : Connection failed. A connection to the notebook server could not be established. The notebook will continue trying to reconnect. Check your network connection or notebook server configuration. (Échec de la connexion. Impossible d’établir une connexion au serveur de notebooks. Vérifiez votre connexion réseau ou la configuration du serveur de notebooks.)

Si votre instance ArcGIS Web Adaptor est exécutée sur un serveur Web IIS, cette erreur se produit lorsque le protocole WebSocket est désactivé sur cette machine. À compter de la version 10.8, ArcGIS Web Adaptor active automatiquement le protocole WebSocket sur les serveurs web Services Internet (IIS). Vous ne devez pas désactiver le protocole.

Lorsque j’essaie d’ouvrir un notebook, le message d’erreur ci-après s’affiche : Unable to load.

Le certificat SSL configuré avec l’adaptateur Web du site ArcGIS Notebook Server n’est pas approuvé par votre navigateur Web. Assurez-vous de disposer d’un certificat signé par une autorité de certification configurée et que le protocole HTTPS est activé sur votre site.

Si vous utilisez un certificat autosigné dans un environnement de développement ou de transition, ouvrez l’URL de ArcGIS Notebook Server Administrator Directory et ajoutez une exception dans votre navigateur web pour que le certificat autosigné soit considéré comme fiable.

Lorsque j’essaie d’ouvrir un notebook, le message d’erreur ci-après s’affiche : Error opening notebook. Unable to connect to the Docker environment on the notebook server. (Erreur lors de l’ouverture du notebook. Impossible de se connecter à l’environnement Docker sur le serveur de notebooks.) Assurez-vous que la configuration requise pour que le serveur de notebooks exécuter Docker est respectée.

Un ou plusieurs des paramètres prérequis qui permettent au composant Docker Engine d’utiliser ArcGIS Notebook Server n’ont pas été configurés. Pour plus d’informations, reportez-vous aux rubriques du guide d’installation :

Après avoir vérifié que tous les paramètres nécessaires ont été configurés, exécutez la commande suivante en invite de commande pour vous assurer que Docker s’exécute sur votre machine ArcGIS Notebook Server :

docker version
docker run hello-world

Lorsque j’essaie d’ouvrir un notebook, un message d’erreur indique que le conteneur n’est pas exécuté.

Si ce message d’erreur s’affiche, le conteneur est disponible, mais n’est pas en cours d’exécution ou à l’état utilisable. Pour qu’il soit accessible, vous devez terminer le conteneur à l’aide du répertoire administrateur. Veillez à bien arrêter le conteneur indiqué dans le message d’erreur. Une fois qu’il est terminé, demandez au propriétaire du notebook de rouvrir le notebook, ce qui va relancer le conteneur.

Notebooks

Avec ArcGIS Notebook Server et des conteneurs Windows, lorsque j’exécute deux notebooks ou plus dans l’éditeur de notebooks qui importent la bibliothèque Torch ou des bibliothèques Python qui possèdent Torch comme dépendance, les instructions d’importation échouent dans tous les notebooks sauf le premier que j’ai exécuté avec [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies.

Ce comportement est lié à la taille de fichier de pagination maximale par défaut configurée pour la mémoire virtuelle sur les machines Notebook Server. Procédez comme suit pour augmenter la taille de fichier de pagination par défaut, ainsi que le processeur maximal et la mémoire maximale alloués à un notebook.

Remarque :

Contactez votre administrateur système pour connaître la taille de fichier de pagination appropriée avant de réaliser ces changements.

  1. Sur chaque machine ArcGIS Notebook Server, cliquez sur Start (Démarrer) > Settings (Paramètres) > System (Système) > About (À propos) > Advanced system settings (Paramètres système avancés).
  2. Sur l’onglet Advanced (Avancé) de la boîte de dialogue System Properties (Propriétés système), cliquez sur Settings (Paramètres) dans la section Performance (Performances).
  3. Dans la boîte de dialogue Performance Options (Options de performances), cliquez sur l’onglet Advanced (Avancé).
  4. Cliquez sur Change (Modifier) dans la section Virtual memory (Mémoire virtuelle).
  5. Dans la boîte de dialogue Virtual memory (Mémoire virtuelle), décochez Automatically manage paging file size for all drives (Gérer automatiquement la taille du fichier de pagination pour tous les lecteurs).
  6. Sélectionnez Custom size (Taille personnalisée).
  7. Saisissez des valeurs pour Initial size (MB) et Maximum size (MB).
  8. Cliquez sur OK et redémarrez votre machine.

Une fois votre machine redémarrée, procédez comme suit dans ArcGIS Notebook Server Manager :

  1. Cliquez sur Settings (Paramètres) > Runtimes.
  2. Sélectionnez le runtime que vous utilisez pour exécuter les notebooks qui importent Torch et cliquez sur Edit (Mise à jour).
  3. Définissez les valeurs Max CPU (CPU max.) sur 4 cœurs et Max Memory (Mémoire max.) sur 12 Mo.
  4. Cliquez sur Save (Enregistrer) pour confirmer la mise à jour.
  5. Fermez le gestionnaire ArcGIS Notebook Server.

Avec ArcGIS Notebook Server et des conteneurs Windows, lorsque j’exécute un notebook qui importe la bibliothèque mljar-supervised, l’instruction d’importation prend beaucoup de temps ou entraîne une erreur Kernel died.

Ce comportement est lié au fait que la bibliothèque mljar-supervised comporte de nombreuses dépendances. Procédez comme suit pour augmenter le processeur maximal alloué à un notebook dans ArcGIS Notebook Server Manager :

  1. Cliquez sur Settings (Paramètres) > Runtimes.
  2. Sélectionnez le runtime que vous utilisez pour exécuter les notebooks qui importent mljar-supervised et cliquez sur Edit (Mise à jour).
  3. Définissez la valeur Max CPU (CPU max.) sur 4 cœurs.
  4. Cliquez sur Save (Enregistrer) pour confirmer la mise à jour.
  5. Fermez le gestionnaire ArcGIS Notebook Server.

Lorsque j’exécute une cellule d’un notebook avec du code Python utilisant un élément du portail ArcGIS Enterprise, le délai de la demande est dépassé. Cela se produit chaque fois que j’exécute une cellule contenant une URL distante.

Le réseau utilisé par les conteneurs Docker exécutés sur votre site crée un conflit avec votre réseau ArcGIS Enterprise, ce qui empêche la connexion du code Python au réseau. Reportez-vous à la rubrique Documentation de Docker sur la configuration du réseau. Une fois que vous avez configuré votre réseau pour Docker, réexécutez vos notebooks.

Lorsque j’exécute la première cellule de notebook par défaut (y compris la chaîne gis = GIS("home")), un message d’erreur d’URL Temporary failure in name resolution (Échec temporaire de la résolution du nom) s’affiche.

Cette erreur peut se produire lorsque ArcGIS Notebook Server et son composant Docker sont installés sur le même ordinateur que d’autres composants ArcGIS Enterprise. Elle se manifeste du fait que la propriété privatePortalUrl par défaut stockée dans ArcGIS Notebook Server est une version abrégée du nom de domaine complet. Cela entraîne un échec lorsque vous tenez de contacter le portail.

La solution consiste à attribuer à la propriété privatePortalUrl le nom de domaine complet du site ArcGIS Notebook Server :

  1. Connectez-vous au répertoire Portal for ArcGIS en tant que membre du rôle Administration par défaut dans votre portail. Le format de l’URL est https://portal.domain.com:7443/arcgis/portaladmin.
  2. Cliquez sur Système > Propriétés > Mettre à jour les propriétés.
  3. Dans la boîte de dialogue Update System Properties (Mettre à jour les propriétés du système) insérez une chaîne JSON avec le nom de domaine complet du portail au format suivant :
    { "privatePortalUrl": "https://portal.domain.com:7443/arcgis" }

Lorsque j’exécute la première cellule de notebook par défaut (y compris la chaîne gis = GIS("home")), le message d’erreur suivant apparaît : ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

Lors du déploiement des conteneurs Docker, les serveurs de noms sont copiés à partir du fichier resolv.conf de la machine hôte. Cela peut provoquer des erreurs sur les programmes d’installation qui utilisent des serveurs DNS publics pour les machines, les conteneurs Docker devant être en mesure de résoudre les noms DNS internes.

La solution consiste à configurer dockerExtraHosts dans les propriétés du système ArcGIS Notebook Server :

  1. Ouvrez l’URL de votre répertoire administrateur ArcGIS Notebook Server.
  2. Cliquez sur Système > Propriétés > Mettre à jour les propriétés.
  3. Dans la boîte de dialogue Update System Properties (Mettre à jour les propriétés du système), insérez une chaîne JSON des noms d’hôte et des adresses IP au format suivant :
    { "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }