In most cases, the default settings and parameters of your ArcGIS Notebook Server site ensure adequate system performance. Starting at 10.8, ArcGIS Notebook Server Manager allows you to change some advanced settings governing your site and its Docker component. As an administrator, you can modify settings to improve system performance, increase site limits, or accommodate your organization's IT practices. Be sure you understand each setting and its effects before making changes to the default values.
Settings available in Server Manager
The following site settings can be viewed and changed in ArcGIS Notebook Server Manager:
- WebSocket size (MB)—The maximum size (in megabytes) of a packet that can be passed between the server and client browsers using the WebSocket protocol. ArcGIS Notebook Server uses WebSocket to facilitate efficient, secure two-way communication with clients. The default value of this property is 16 MB. You may need to raise this limit if a particularly large piece of data is being passed by a notebook to the server site.
- Max containers per node—This property limits the number of containers that can be opened interactively at one time per ArcGIS Notebook Server machine. The default value is 20 containers; after the limit is reached, additional containers cannot be opened. Containers that are opened for automated running using the executeNotebook operation have their own limit property and do not count toward this limit.
- Idle notebook threshold—This property governs when idle notebooks are closed. Notebooks that are open but have been inactive for this amount of time (in minutes) are automatically closed. The notebook's kernel is stopped. The default is 1440 (24 hours). You may want to lower this value if you have many authors and limited server resources.
- Container created threshold—This property sets how long a container can remain open (in minutes) without running any active notebooks. After this value is reached, the container is automatically closed. The default is 60 minutes. As with the idle notebook threshold, you may want to reduce this value to conserve resources.
View and change settings in Server Manager
Follow these steps to access the site settings.
- Sign in to your ArcGIS Enterprise portal as an administrator and open ArcGIS Notebook Server Manager.
- Open the Settings page, and click Site.
If you change any of the setting values, the Save button becomes available.
- Click it to save your edits.
The ArcGIS Notebook Server site will restart.
Configure a disconnected environment
When configuring ArcGIS Notebook Server in an environment without internet access, you must configure the jsapiCDN system property to render layers using the map widget in a notebook.
Follow the steps below to configure the jsapiCDN system property.
Note:
Ensure that there are no active notebooks in use before making this change, as updating the notebook server's system properties will terminate all active notebook containers.
- Sign in to the ArcGIS Notebook Server Administrator Directory as an administrator.
The directory is commonly accessible at https://notebookserver.domain.com:11443/arcgis/admin or https://notebookserverwebadaptor.domain.com/webadaptor/admin.
- Click System > Properties.
- Click Update Properties.
- Add "jsapiCDN": "https://my.disconnected-domain.com/portal/jsapi/jsapi4" to the end of the existing list of properties.
- Click Update Properties to save the changes.
All newly opened notebooks will now use the updated JavaScript API for rendering the map widget.