Skip To Content

Configure ArcGIS Notebook Server directories

ArcGIS Notebook Server stores the file-based configurations and content needed for its operations in server directories. These directories can be added during the installation and configuration of ArcGIS Notebook Server, or later using the ArcGIS Notebook Server Administrator Directory.

There are four types of directories, each of which plays a specific role in server operations: the workspace directory, the data directory, the output directory, and the system directory. The workspace and data directories are described below; the output and system directories are for purposes internal to ArcGIS Notebook Server.

Workspace directory

The workspace directory allows notebook authors to store and read the files used in their notebooks. Each notebook author in the ArcGIS Enterprise portal has a unique folder within the workspace directory. A user's unique folder is mounted in each ArcGIS Notebook they create, so the notebook can read and write to the workspace directory. A notebook can only read and write information in its user's respective workspace directory folder; that folder cannot be accessed from other users' notebooks.

By default, users' private workspace directories are created in the /directories/arcgisworkspace/<userid> folders, with permissions set as -rwxrwxrwx. That permission level is necessary because by default, the Linux user account running inside the container will have a different UID and GID (group ID) than your OS user account running the ArcGIS Notebook Server daemon.

If you do not want to use the open permission model for security reasons, you can change the model using a system property named applyDefaultUserWorkspacePermissions. When this property is set to true, workspace directories will be created using your system's default setting, such as -rwx------, rather than the open -rwxrwxrwx setting.

To use this feature, the OS user running the Notebook Server daemon must have a UID of 1050 and a GID of 100 (to match the UID and the GID of the container user).

  1. Sign in to the Administrator Directory. The URL is formatted https://notebookserver.domain.com:11443/arcgis/admin.
  2. Browse to System > Properties and click Edit.
  3. Add the following JSON string to the properties box and save your edit:

    {
       "applyDefaultUserWorkspacePermissions":"true"
    }

Data directory

Data is essential to ArcGIS Notebooks. When authoring notebooks, users can add data layers from items in the ArcGIS Enterprise portal, from external GIS servers, or from local file directories.

A local directory containing data can be made available to notebooks as a file path by being registered with their ArcGIS Notebook Server site. Multiple data directories can be registered with a server site. Each registered data directory is made available for use by every notebook running in that site.

Notebooks that use raster analytics workflows have a particular use for data directories. You can register a file-based raster store as a data directory, making the output of raster analytics tools immediately available in notebooks.

Considerations for data directories

For notebooks to have access to a registered data directory, set 755-mode permissions for the directory.

All notebook authors in your organization can add data from all registered data directories to their notebooks. It is not possible to limit data directories to certain users or groups in the portal.

In deep learning workflows that involve the generation of image chips to train a model, the chips are hosted in a file-based raster store. When performing such a workflow, register the raster store with ArcGIS Notebook Server as a data directory to make the image chips available to your notebooks.

Data in a registered data directory is not part of the ArcGIS Enterprise portal. Accordingly, when a notebook is shared, ensure all users who will view the shared notebook have access to any registered data directory the notebook references.

Register a new data directory with ArcGIS Notebook Server

You can use the Register Server Directory operation in the ArcGIS Notebook Server Administrator Directory to make a local directory available to the server site as a data directory.

  1. Sign in to the Administrator Directory. The URL is formatted https://notebookserver.domain.com:11443/arcgis/admin.
  2. Browse to System > Directories and click Register Server Directory.
  3. Provide the name of the directory, and its full path on your machine.
  4. Indicate that the directory will function as a DATA directory.
  5. Click Register Server Directory to confirm.

You cannot edit or update the name or path for a directory registered with ArcGIS Notebook Server. To make changes, you must unregister the existing directory and then register it again.

Specify a new location for a server directory

You can edit an existing directory using the Administrator Directory to change its location. You should use this method when expanding to a multiple-machine site to place your directories on shared file paths.

  1. Sign in to the Administrator Directory. The URL is formatted https://notebookserver.domain.com:11443/arcgis/admin.
  2. Browse to System > Directories and click the directory you want to modify. Click edit.
  3. Replace the existing Directory Path value with the new path of the directory. Click Edit to confirm.

    After the site restarts, it will use the new path to access the directory.

  4. Copy and paste the contents of the existing directory to its new location.

Repeat these steps for each directory you want to update.