Skip to main content

Problèmes courants et solutions

Les questions ou les problèmes susceptibles de surgir lors de l’utilisation d’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éder aux notebooks

Notebooks

Le répertoire d’administration d’ArcGIS Notebook Server sous 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 Windows 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 du 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 Docker Desktop 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 du 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 du dossier 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 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
}

Le chargement de l’image de conteneur Docker reçue de My Esri se solde par un échec et par l’affichage du message no space left on device (espace insuffisant sur l’appareil).

Docker utilise le lecteur /var pour charger les images de conteneur. Vérifiez que le lecteur /var dispose d’au moins 50 Go d’espace pour installer ArcGIS Notebook Server ou déplacez le registre local pour Docker à un autre emplacement qui dispose de l’espace nécessaire.

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 notebook.) **

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 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 (Impossible de charger).

Le certificat SSL configuré avec l’instance Web Adaptor 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 auto-signé dans un environnement de développement ou de transition, ouvrez l’URL du répertoire d’administration d’ArcGIS Notebook Server et ajoutez une exception dans votre navigateur Web pour que le certificat auto-signé 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 Notebook Server exécute 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 dans l’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 en cours d’exécution.

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 arrêter le conteneur à l’aide du répertoire d’administration. 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.

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 ArcGIS Notebook Server Manager.

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 ArcGIS Notebook Server Manager.

Lorsque j’exécute une cellule d’un notebook avec du code Python utilisant un élément du portail ArcGIS Enterprise, le délai d’attente de la requête a expiré. 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 est incompatible 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 la même machine 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 System (Système) > Properties (Propriétés) > Update Properties (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 d’administration d’ArcGIS Notebook Server.

  2. Cliquez sur System (Système) > Properties (Propriétés) > Update Properties (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" : "portal.domain.com", "ip" : "12.34.56.78" } ] }