Launch a Session

Sessions allow you to perform actions such as run R or Python code. They also provide access to an interactive command prompt and terminal. This topic demonstrates how to launch a new session.

Navigate to your project's Overview page.
Click New Session.
The information presented on this page will depend on which default engine you have chosen for your project: ML Runtimes or Legacy Engines. You can change the default engine later in this task.
Check the settings for your session:
If your project is using ML Runtimes, you will see the following settings:

Editor

Selects the Editor; currently only Workbench is supported and therefore the selector is static.

Kernel

Selects the Kernel. Initially only Python Runtimes are supported.

Edition

Selects the Runtime Edition. Initially only Standard variants are supported

Version

Selects the Version for the selected Kernel. Initially version 3.6, 3.7 and 3.8 Python versions are supported.

note
The selector options only consider the configurations supported by the actual deployments and certain selections will automatically limit others. For example, certain versions are only relevant for Python or certain editors are supported only with certain kernels.

If your project is using Legacy Engines, you will see the following settings:

Editor

Selects the Editor; currently only Workbench is supported and therefore the selector is static.

Kernel

Selects the Kernel. Initially only Python Runtimes are supported.

Engine Image

Displays the Advanced tab in Project Settings and allows you to set environment variables and the shared memory limit.
If your project is using Legacy Engines, you can modify the engine image used by this session:
1. By Engine Image, click Configure.
  Cloudera Data Science Workbench displays the Project Settings page.
2. Select the Runtime/Engine tab.
3. Next to Default Engine, select ML Runtime or Legacy Engine.
4. Click Save Engine.
Specify your Resource Profile.
The minimum configuration is 1vCPU and 2 GB memory.
Click Start Session.
The command prompt at the bottom right of your browser window will turn green when the engine is ready. Sessions typically take between 10 and 20 seconds to start.