Common problems and solutions

Questions or issues that you may encounter when working with ArcGIS Notebook Server are listed, and solutions are suggested. If you don't find the problem you're looking for, you can also search for articles on the Esri Support center website.

Installation

Access notebooks

• When I try to open a notebook, I get this error: 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.
• When I try to open a notebook, I get this error: Unable to load.
• When I try to open a notebook, I get this error: Error opening notebook. Unable to connect to the Docker environment on the notebook server. Please make sure that the notebook server prerequisites to run Docker have been met.
• When I try to open a notebook, I get an error that the container "is not running."

Notebooks

• When I run a notebook cell with Python code that uses an ArcGIS Enterprise portal item, the request times out. This happens whenever I run a cell that contains a remote URL.

• When I run the default first notebook cell (including the string gis = GIS("home")), I get a URL error saying Temporary failure in name resolution.

• My ArcGIS Enterprise 10.7 portal is in a disconnected environment, and my notebooks cannot draw maps.

Installation

Access notebooks

When I try to open a notebook, I get this error: 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.

If your ArcGIS Web Adaptor runs on an IIS web server, this error occurs when the WebSocket protocol is not enabled on that machine. Follow these steps in Microsoft documentation to enable the protocol.

When I try to open a notebook, I get this error: Unable to load.

The SSL certificate configured with the ArcGIS Notebook Server site Web Adaptor is not trusted by your web browser. Ensure that you have a CA-signed certificate configured and HTTPS is enabled on your site.

If you're using a self-signed certificate in a development or staging environment, open the URL of your ArcGIS Notebook Server Administrator Directory and add an exception in your web browser to trust the self-signed certificate.

When I try to open a notebook, I get this error: Error opening notebook. Unable to connect to the Docker environment on the notebook server. Please make sure that the notebook server prerequisites to run Docker have been met.

One or more of the prerequisite settings that allow the Docker Engine component to work with ArcGIS Notebook Server have not been configured. Refer to the following topics in the installation guide for more information:

• Install Docker for ArcGIS Notebook Server
• Configure ArcGIS Notebook Server after installation

When you verify that all necessary settings have been configured, run the following in a command prompt to confirm that Docker is running on your ArcGIS Notebook Server machine:

docker version
docker run hello-world

When I try to open a notebook, I get an error that the container "is not running."

If this error message appears, the container is available but is not in a running or usable state. To make it accessible, you must terminate the container using the Administrator Directory. Ensure you're terminating the container specified in the error message. Once it's been terminated, have the notebook owner reopen the notebook, which will relaunch the container.

Notebooks

When I run a notebook cell with Python code that uses an ArcGIS Enterprise portal item, the request times out. This happens whenever I run a cell that contains a remote URL.

The network being used by the Docker containers running in your site is conflicting with your ArcGIS Enterprise network, which blocks the Python code from connecting to the network. Refer to the Docker documentation on configuring networking. When you've configured your network for Docker, run your notebooks again.

When I run the default first notebook cell (including the string gis = GIS("home")), I get a URL error saying Temporary failure in name resolution.

This error can occur when ArcGIS Notebook Server and its Docker component are installed on the same machine as other ArcGIS Enterprise components. It occurs because the default privatePortalUrl property stored in ArcGIS Notebook Server is a shortened version of the fully qualified domain name. This causes a failure when attempting to contact the portal.

The solution is to amend the privatePortalUrl property to be the fully qualified domain name of the ArcGIS Notebook Server site:

1. Log in to the ArcGIS Portal Directory as a member of the default administrator role in your portal. The URL format is https://portal.domain.com:7443/arcgis/portaladmin.
2. Click System > Properties > Update Properties.
3. On the Update System Properties dialog box, insert a JSON string with the fully qualified domain name of the portal, in the following format:
   {
   "privatePortalUrl": "https://portal.domain.com:7443/arcgis"

My ArcGIS Enterprise 10.7 portal is in a disconnected environment, and my notebooks cannot draw maps.

Legacy:

This problem and solution only apply to 10.7; the underlying issue was resolved at 10.7.1.

Each time an ArcGIS Notebook draws a map, it pulls ArcGIS API for JavaScript 4.10 from a content delivery network (CDN). For disconnected environments, this CDN is accessed from the portal using the URL format https://portal.domain.com/portal/jsapi/jsapi4. In disconnected environments where the portal uses Integrated Windows Authentication (IWA), a known issue is that IWA blocks this access. As a result, maps are not drawn in notebooks.

To work around this issue, specify the CDN path using the privatePortalURL value, as shown in the following steps:

1. If you don't know your portal's privatePortalURL, sign in to the ArcGIS Portal Directory as a member of the default administrator role in your portal organization. The URL is formatted https://portal.domain.com:7443/arcgis/portaladmin. Click System > Properties. Locate and record the privatePortalURL value.
2. Direct your notebook authors to run the following cell in each of their notebooks:
   from arcgis.widgets import MapView
   MapView.set_js_cdn("https://<privatePortalURL>:7443/arcgis/jsapi/jsapi4")

Once this CDN path has been set, your authors' notebooks will use the privatePortalURL to access ArcGIS API for JavaScript when drawing maps.