ArcGIS Notebook Server

Question 1

The ArcGIS Notebook Server administrative directory on Windows is unresponsive after installation or after a restart of the notebook server machine.

Answer

This issue can occur if the ArcGIS Notebook Server Windows service and the Docker service do not start in the correct order after installation or machine restart.

To resolve this issue, set the ArcGIS Notebook Server Windows service to start automatically with a delay. Doing this will allow the Docker Windows service to fully initialize before the ArcGIS Notebook Server Windows service starts.

To configure the ArcGIS Notebook Server Windows service to automatically start with a delay, complete the following steps:

Open the Services application on your ArcGIS Notebook Server Windows machine.
Right-click the ArcGIS Notebook Server service and select Properties.
Click General.
In Startup type, select Automatic (Delayed Start).
Click Apply.
Restart your machine to apply the changes.
If there is more than one machine that is part of your ArcGIS Notebook Server site, repeat these steps on each machine.

Question 2

When loading notebook runtime images, I get the error no space left on device, despite having room left on the drive where ArcGIS Notebook Server and Docker are installed.

Answer

Check the Docker desktop settings for advanced resource allocation and verify that there is a sufficient disk image size allocated for the disk image location. Increase the disk space allocated and retry loading the notebook runtime images.

Question 3

How do I remove the previous container images from my machine?

Answer

On Windows Server with Mirantis Container Runtime, the container images are located in the C:\ProgramData\docker\windowsfilter folder. To remove all previous container images on your machine and free up disk space, run the following command in PowerShell with Administrator privileges.

docker system prune -af

If not all of the image layers are removed from C:\ProgramData\docker\windowsfilter, restart your machine and run the following commands in PowerShell with Administrator privileges.

Note:

Perform these operations before loading the ArcGIS Notebook Server Windows container image, as this process will remove all container images on the 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
}

Question 4

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.

Answer

If your ArcGIS Web Adaptor runs on an IIS web server, this error occurs when the WebSocket protocol is disabled on that machine. Starting at 10.8, ArcGIS Web Adaptor automatically enables the WebSocket protocol on IIS web servers; you must not disable the protocol.

Question 5

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

Answer

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.

Question 6

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.

Answer

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:

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

Question 7

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

Answer

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

Question 8

With ArcGIS Notebook Server using Windows containers, when I run two or more notebooks in the notebook editor that import the torch library or Python libraries that have Torch as a dependency, the import statements fail in all but the first notebook I ran with [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.

Answer

This behavior is due to the default maximum paging file size configured for the virtual memory on the Notebook Server machines. Follow these steps to increase the default paging file size and the maximum CPU and memory allotted to a notebook.

Note:

Consult your system administrator for the appropriate paging file size before making these changes.

On each ArcGIS Notebook Server machine, click Start > Settings > System > About > Advanced system settings.
On the Advanced tab of the System Properties dialog box, click Settings in the Performance section.
On the Performance Options dialog box, click the Advanced tab.
Click Change in the Virtual memory section.
On the Virtual memory dialog box, uncheck Automatically manage paging file size for all drives.
Select Custom size.
Enter values for Initial size (MB) and Maximum size (MB).
Click OK and restart your machine.

Once your machine has restarted, follow these steps in ArcGIS Notebook Server Manager:

Click Settings > Runtimes.
Select the runtime you use for running notebooks that import torch and click Edit.
Update the Max CPU to 4 cores and the Max Memory to 12 GB.
Click Save to confirm the update.
Close ArcGIS Notebook Server Manager.

Question 9

With ArcGIS Notebook Server using Windows containers, when I run a notebook that imports the mljar-supervised library, the import statement takes a long time or results in a Kernel died error.

Answer

This behavior is the result of the mljar-supervised library having many dependencies. Follow these steps to increase the maximum CPU allotted to a notebook in ArcGIS Notebook Server Manager:

Click Settings > Runtimes.
Select the runtime you use for running notebooks that import mljar-supervised and click Edit.
Update Max CPU to 4 cores.
Click Save to confirm the update.
Close ArcGIS Notebook Server Manager.

Question 10

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.

Answer

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.

Question 11

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.

Answer

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:

Sign 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.
Click System > Properties > Update Properties.
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" }
```

Question 12

When I run the default first notebook cell (including the string gis = GIS("home")), I get an error stating: 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'))

Answer

When deploying Docker containers, name servers are copied from the resolv.conf file of the host machine. This can result in errors on setups that use public DNS servers for machines, as the Docker containers need to be able to resolve internal DNS names.

The solution is to configure dockerExtraHosts in the ArcGIS Notebook Server system properties:

Open the URL of your ArcGIS Notebook Server Administrator Directory.
Click System > Properties > Update Properties.
On the Update System Properties dialog box, insert a JSON string of the host names and IP addresses in the following format:
```
{ "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }
```

Installation

Access to notebooks

Notebooks

Installation

Note:

Access to notebooks

Notebooks

Note:

In this topic