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éder 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.)
• Lorsque j’essaie d’ouvrir un notebook, le message d’erreur ci-après s’affiche : Unable to load.
• 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.
• Lorsque j’essaie d’ouvrir un notebook, un message d’erreur indiquant que le conteneur « ne fonctionne pas » s’affiche.

Notebooks

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

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

• Mon portail ArcGIS Enterprise 10.7 est dans un environnement déconnecté et mes notebooks de dessinent aucune carte.

Installation

Accéder 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 n’est pas activé sur cette machine. Suivez ces étapes dans la documentation Microsoft pour activer le protocole.

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

The SSL certificate configured with the ArcGIS Notebook Server Site Web Adaptor is not trusted by your web browser. (Chargement impossible. Votre serveur web considère que le certificat SSL configuré avec le composant Web Adaptor du site ArcGIS Notebook Server n’est pas fiable.) 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 :

• Installer Docker pour ArcGIS Notebook Server
• Configurer ArcGIS Notebook Server après l’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 indiquant que le conteneur « ne fonctionne pas » s’affiche.

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 le rendre accessible, vous devez arrêter le conteneur à l’aide du répertoire administrateur. Veillez à terminer le conteneur spécifié 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

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 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 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 d’administrateur 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 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"

Mon portail ArcGIS Enterprise 10.7 est dans un environnement déconnecté et mes notebooks de dessinent aucune carte.

Héritage :

Ce problème et sa solution s’appliquent uniquement à la version 10.7. Le problème sous-jacent a été résolu dans la version 10.7.1.

Chaque fois qu’un notebook ArcGIS dessine une carte, il extrait ArcGIS API for JavaScript 4.10 à partir d’un réseau de diffusion de contenu (CDN). Dans le cas des environnements déconnectés, vous pouvez accéder à ce réseau de diffusion de contenu à partir du portail via le format d’URL https://portal.domain.com/portal/jsapi/jsapi4. Dans les environnements déconnectés où le portail utilise l’authentification Windows intégrée (IWA), cet accès est bloqué par IWA (il s’agit d’un problème connu). Les cartes ne sont donc pas tracées dans les notebooks.

Pour contourner ce problème, indiquez le chemin du CDN à l’aide de la valeur privatePortalURL, comme indiqué ci-après :

1. Si vous ne connaissez pas la propriété privatePortalURL de votre portail, connectez-vous à ArcGIS Portal Directory en tant que membre du rôle Administration par défaut dans l’organisation de votre portail. L’URL est au format https://portal.domain.com:7443/arcgis/portaladmin. Cliquez sur System (Système) > Properties (Propriétés). Localisez et enregistrez la valeur privatePortalURL.
2. Indiquez aux créateurs de notebook d’exécuter la cellule suivante dans chacun de leurs notebooks :
   from arcgis.widgets import MapView
   MapView.set_js_cdn("https://<privatePortalURL>:7443/arcgis/jsapi/jsapi4")

Une fois le chemin du CDN défini, les notebooks de vos créateurs utiliseront privatePortalURL pour accéder à ArcGIS API for JavaScript lors du dessin des cartes.