Chapter 4. Managing Jupyter notebook servers

Procedure

1. On the page that opens when you launch Jupyter, click the Administration tab.

2. On the Administration tab, perform the following actions:

   1. In the Users section, locate the user whose notebook server you want to start.
   2. Click Start server beside the relevant user.
   3. Complete the Start a notebook server page.
   4. Optional: Select the Start server in current tab checkbox if necessary.

   5. Click Start server.

      After the server starts, you see one of the following behaviors:

      • If you previously selected the Start server in current tab checkbox, the JupyterLab interface opens in the current tab of your web browser.

      • If you did not previously select the Start server in current tab checkbox, the Starting server dialog box prompts you to open the server in a new browser tab or in the current tab.

        The JupyterLab interface opens according to your selection.

Procedure

1. On the page that opens when you launch Jupyter, click the Administration tab.

2. On the Administration page, perform the following actions:

   1. In the Users section, locate the user that the notebook server belongs to.
   2. Click View server beside the relevant user.
   3. On the Notebook server control panel page, click Access notebook server.

Procedure

1. On the page that opens when you launch Jupyter, click the Administration tab.

2. Stop one or more servers.

   • If you want to stop one or more specific servers, perform the following actions:

     1. In the Users section, locate the user that the notebook server belongs to.

     2. To stop the notebook server, perform one of the following actions:

        • Click the action menu (⋮) beside the relevant user and select Stop server.

        • Click View server beside the relevant user and then click Stop notebook server.

          The Stop server dialog box appears.

     3. Click Stop server.

   • If you want to stop all servers, perform the following actions:

     1. Click the Stop all servers button.
     2. Click OK to confirm stopping all servers.

Procedure

1. From the OpenShift AI dashboard, click Settings Cluster settings.
2. Under Stop idle notebooks, select Stop idle notebooks after.
3. Enter a time limit, in hours and minutes, for when idle notebooks are stopped.
4. Click Save changes.

Procedure

1. From the OpenShift AI dashboard, click Settings Notebook images.

   The Notebook images page appears. Previously imported notebook images are displayed. To enable or disable a previously imported notebook image, on the row containing the relevant notebook image, click the toggle in the Enable column.

   Note

   If you have already configured an accelerator identifier for a notebook image, you can specify a recommended accelerator for the notebook image by creating an associated accelerator profile. To do this, click Create profile on the row containing the notebook image and complete the relevant fields. If the notebook image does not contain an accelerator identifier, you must manually configure one before creating an associated accelerator profile.

2. Click Import new image. Alternatively, if no previously imported images were found, click Import image.

   The Import Notebook images dialog appears.

3. In the Image location field, enter the URL of the repository containing the notebook image. For example: quay.io/my-repo/my-image:tag, quay.io/my-repo/my-image@sha256:xxxxxxxxxxxxx, or docker.io/my-repo/my-image:tag.
4. In the Name field, enter an appropriate name for the notebook image.
5. Optional: In the Description field, enter a description for the notebook image.
6. Optional: From the Accelerator identifier list, select an identifier to set its accelerator as recommended with the notebook image. If the notebook image contains only one accelerator identifier, the identifier name displays by default.

7. Optional: Add software to the notebook image. After the import has completed, the software is added to the notebook image’s meta-data and displayed on the Jupyter server creation page.

   1. Click the Software tab.
   2. Click the Add software button.
   3. Click Edit ( ).
   4. Enter the Software name.
   5. Enter the software Version.
   6. Click Confirm ( ) to confirm your entry.
   7. To add additional software, click Add software, complete the relevant fields, and confirm your entry.

8. Optional: Add packages to the notebook images. After the import has completed, the packages are added to the notebook image’s meta-data and displayed on the Jupyter server creation page.

   1. Click the Packages tab.
   2. Click the Add package button.
   3. Click Edit ( ).
   4. Enter the Package name.
   5. Enter the package Version.
   6. Click Confirm ( ) to confirm your entry.
   7. To add an additional package, click Add package, complete the relevant fields, and confirm your entry.
9. Click Import.