All primary components in the Syntasa application, i.e. Apps, Dashboards, Notebooks, and the folders they are organized in, are created from Workspace -> Folders -> Create New (as shown below).
Selecting the Notebook option presents you with a new screen to provide the details of the notebook.
Creating a new notebook entails several pieces of information, some only affecting the attributes of the notebook object seen within the Syntasa environment, and others relating to the notebook created within JupyterHub. We have categorized different fields of 'Create Notebook' screen into 3 parts:
Syntasa notebook attributes
The following fields define the notebook object within the Syntasa application. The notebook object is connected is a single Jupyter notebook within JupyterHub that can be accessed via the Syntasa application and its specific notebook object.
Notebook Name - Name as seen on the notebook card and searchable within Workspace. This name must be unique across all notebooks in the application, even those that have been deleted and are in the trash.
Copy/Import Notebook - Turning this on allows you to create a new notebook from an existing one instead of starting from scratch. The source notebook may be within the same Syntasa application or from an outside source.
- Copy Notebook - Replicate a notebook from the same Syntasa application. You can only select from notebooks that you have access to given the sharing setting on the source notebook.
- Import Notebook - Replicate a notebook from an outside source by uploading a .ipynb file from your local machine.
Tags - All objects throughout the Syntasa application support tags to help organize and search for related objects. More information on tags can be found here.
Folder - The folder path defines the location of the notebook object within the Syntasa folder structure. The default value will be the folder from where you clicked the 'Create New' button, but this can be changed here. The notebook can also be moved to another folder after it has been created.
Description - Provide information explaining the purpose of the notebook. This is especially useful if the notebook is to be shared with other users.
Jupyter attributes
The following fields are characteristics of the notebook within JupyterHub. The values can be changed or turned on/off after creating the Syntasa notebook object.
Language - This defines the programming language the notebook is using. The accepted values are Python and Scala. When you launch the notebook, the kernel of the selected language will be shown by default on the JupyterHub screen. You also have the option to enable GPU for the kernel which can be done by enabling the toggle 'Enable GPU' (as highlighted below)
Initialization Script - This code area allows you to enter bash code that can be executed on launching the notebook. This code block is helpful when you want to initialize additional libraries, set up environment variables, etc before launching the notebook.
Connect Notebook to Syntasa Runtime - A launched notebook will have a kernel running that can run a variety of functions within the notebook. Still, at times you may need a bigger cluster or custom libraries loaded that will require a Syntasa runtime to be attached to the notebook.
This option is turned off by default. When this option is turned on, you get the option to select the runtime template. Once the runtime template is selected, you get the following 3 options to choose the instance:
- Create a New instance: With this option, you can create a new instance for the selected runtime template.
- Use Existing instance: With this option, you can use any existing runtime instance.
- Use Running Instance: With this option, you can use any existing instance that is already running.
You can overwrite template defaults by enabling the toggle 'Overwrite Template Defaults'. A runtime can also be attached after Launching the Notebook. The article Notebook Runtimes reviews the best practices and when a runtime may be needed.
Sharing and Permissions for Syntasa Notebooks
Starting with version 9.1, notebooks inherit sharing settings and permissions from their Notebook Workspace. As a result, sharing and permissions cannot be configured at the individual notebook level. To learn more about how sharing and permissions work together, please refer to article Sharing & Permissions
Notebook sharing settings are inherited automatically from the workspace they belong to.
- These settings are visible only to the notebook owner, System Admin, or users with Manager permission on the Notebook Workspace.
- The sharing options appear as read-only and cannot be modified at the notebook level by any user, including the owner or System Admin.
To change sharing or permissions, updates must be made at the Notebook Workspace level, not on individual notebooks.