Start a New Session

The first step to run a project in the workbench is to start a new session.

  1. Navigate to your project's Overview page.
  2. Click New Session.
    The information presented on this page will depend on which default engine you have chosen for your project: Runtime or Legacy Engines. You can change the default engine later in this task.
    The Start A New Session dialog box opens.
  3. 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, for example Python 3.7, R4.0.
    Edition
    Selects the Runtime Edition. Initially only Standard variants are supported.
    Version
    Selects the ML Runtimes version.
    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
    Selects the engine image. Click Configure to display the Project Setting > Advanced window to modify your environment variables and shared memory limit.
  4. If your project is using Legacy Engines, you can modify the engine image used by this session:
    1. By Engine Image, click Configure.
      Cloudera Machine Learning 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.
  5. Specify your Resource Profile.
    This attribute will define how many vCPUs and how much memory will be reserved to run the workload (for example, session including the runtime itself). The minimum configuration is 1vCPU and 2 GB memory.
  6. 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.