This topic lists questions or issues that you may encounter when working with ArcGIS Notebook Server portals and suggests possible solutions. If you don't find the problem you're looking for, you can also search for articles on the Esri Support center website.
During installation
Accessing 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.
Running 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.
The SSL certificate configured with the ArcGIS Notebook Server site's Web Adaptor is not trusted by your web browser. Ensure 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, then 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 for the Docker Engine component to work with ArcGIS Notebook Server has not been configured. Refer to the following topics in the install guide:
When you have verified all necessary settings have been configured, run the following commands in a prompt to confirm Docker is running on your ArcGIS Notebook Server machine:
docker version
docker run hello-worldWhen 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. Consult the Docker documentation on configuring networking. When you've configured your network for Docker, relaunch your notebooks.