Creating and Managing Notebook Servers

Describes how to create and manage notebook servers in HPE Ezmeral Unified Analytics Software.

Prerequisites

Sign in to HPE Ezmeral Unified Analytics Software.

TIP
  • When you create a new notebook, the notebook name must consist of lowercase alphanumeric characters, with or without dashes (-). The name cannot start with a number; the name must start with a letter (a-z). For example, you can name a notebook my-notebook-1, but you cannot name a notebook 1-my-notebook.
  • If your username starts with a number, such as 3user, your default user notebook name also starts with a number (3user-notebook), which is not supported. For additional information, see Troubleshooting Notebooks.

About this task

Create and manage notebook servers in HPE Ezmeral Unified Analytics Software.

Procedure

  1. Click Notebooks icon on the left navigation bar of HPE Ezmeral Unified Analytics Software screen.

    You are now in the Notebook Servers screen. You can see a default <notebook-user-namespace-name> Jupyter notebook has been created with tensorflow image by using Kubeflow Notebooks. By default, the Unified Analytics creates the default notebook in a Stopped status.

    A notebook can be created with two types of PVCs: an existing one and a new one. Each notebook usually has a special notebook PVC (workspace volume) that makes the notebook's home folder persistent. The notebook can also contain user data PVCs. The existing PVCs must be created before creating the notebook. The new PVCs are created when you create the notebook.

    • To connect to a default Jupyter notebook (for example, <notebook-user-namespace-name>), follow these steps:
      1. Click the Actions menu.

      2. Select Start and wait for the notebook to be in the Running status.
      3. Click <notebook-user-namespace-name> or select Connect.

    • To create notebook servers, click New Notebook Server. You can choose JupyterLab or Visual Studio Code as your notebook server within Kubeflow Notebooks. To learn more, see Kubeflow Notebooks.

    When any notebook is created, the following volumes are added automatically:
    • <username>: This directory is mounted to user-pvc volume. Only the current user has access to the data stored in the <username> folder.
    • shared: This directory can be accessed by all authorized users. The shared directory contains all the notebook examples.
    • logs: This directory contains the log files. To learn more, see Logging.

    You can run your commands, visualize data, and get outputs and results by using notebook servers.

  2. To view actions that you can perform on Notebook Servers screen, click the menu icon in the Actions column.
    Start:
    To start notebook servers, select Start.
    Stop
    Top stop notebook servers from running, select Stop.
    Connect:
    To connect to notebook servers, select Connect.
    Delete:
    To delete the notebook server, select Delete.
    NOTE
    When you stop or delete the notebook, the PVCs remain and are not deleted along with the notebook, and the processes that were running within the notebook are forcefully stopped. In this case, you must manually restart the notebook processes as required.
  3. Delete multiple notebook servers at once:
    1. To select multiple notebook servers, click the check box besides Name in the table.
    2. Click Delete on the top right pane of the table.
  4. To display notebook servers according to the status, click the Filter icon.
  5. To select the columns to display on your applications table, click the Columns icon.