Skip to content

Open OnDemand Overview

Overview

We now provide various interactive Apps through the browser-based Open OnDemand service available at https://ood.brc.berkeley.edu.

Apps/services include:

  • Jupyter notebooks
  • RStudio
  • VS Code
  • File browsing
  • Slurm job listing
  • Terminal/shell access (under the "Clusters" tab)

The Open OnDemand service is a new service. Please let us know if you run into problems or have suggestions or feature requests. We'll be adding information to this page in the near future.

Logging In

  1. Visit https://ood.brc.berkeley.edu in your web browser.
  2. Use your BRC username and PIN+one-time password (OTP)
    • These are the same credentials you use to login to Savio via SSH.
    • The username is only your BRC username and should not include the part after any @ sign.
    • CORRECT username format: yourusername
    • INCORRECT username format: yourusername@hpc.brc.berkeley.edu, yourusername@berkeley.edu

Service Unit Charges

Open OnDemand apps may launch Slurm jobs on your behalf when requested. Open OnDemand refers to these jobs as "interactive sessions." Since these are just Slurm jobs, service units are charged for interactive sessions the same way normal jobs are charged.

Interactive sessions running on nodes whose hostnames ending in .testbed0 do not cost service units. Nodes ending in .testbed0 are shared nodes that are provided for low-intensity jobs. These should be treated like login nodes (that is, no intensive computation is allowed).

Job time is counted for interactive sessions as the total time the job runs. The job starts running as soon as a node is allocated for the job. The interactive session may still be running even if you do not have it open in your web browser. You can view all currently running interactive sessions under My Interactive Sessions. When you are done, you may stop an interactive session by clicking "Delete" on the session.

There are several ways to monitor usage:

Using Open OnDemand

Here are the services provided via Open OnDemand.

Files App

Access the Files App from the top menu bar under Files > Home Directory. Using the Files App, you can use your web browser to:

  • View files in the Savio filesystem.
  • Create and delete files and directories.
  • Upload and download files from the Savio filesystem to your computer.
  • We recommend using Globus for large file transfers.

View Active Jobs

View and cancel active Slurm jobs from Jobs > Active Jobs. This includes jobs started via sbatch and srun as well as jobs started (implicitly) via Open OnDemand (as discussed above).

Shell Access

Open OnDemand allows Savio shell access from the top menu bar under Clusters > BRC Shell Access.

Interactive Apps

Open OnDemand provides additional interactive apps. You can launch interactive apps from the Interactive Apps menu on the top menu bar. The available interactive apps include:

  • Jupyter Server (for working with Jupyter notebooks)
  • RStudio Server (for working in RStudio sessions)
  • Code Server (VS Code) (for code editing using Visual Studio Code)

Jupyter Server

See the Jupyter documentation page for instructions on using Jupyter notebooks via Open OnDemand.

This service replaces the JupyterHub service that we formerly provided.

When using the "Jupyter Server - compute in batch queues" service units are charged based on job run time. The job may still be running if you close the window or log out. When you are done, shut down your Jupyter session by clicking "Delete" on the session under My Interactive Sessions. You can confirm that the interactive session has stopped by checking My Interactive Sessions.

RStudio Server

The RStudio server allows you to use RStudio on Savio.

  1. Select RStudio Server - compute in batch queues under Interactive Apps
  2. Provide the job specification you want for the RStudio server.
  3. Once RStudio is ready, click Connect to RStudio Server to access RStudio.

Service units are charged based on job run time. The job may still be running if you close the window or log out. When you are done, shut down RStudio by clicking "Delete" on the session under My Interactive Sessions. You can confirm that the interactive session has stopped by checking My Interactive Sessions.

Code Server (VS Code)

Code Server allows you to use Visual Studio Code from your web browser to edit files. The Code Server runs on shared nodes (.testbed0), so you are not charged any service units for using this app.

  1. Select Code Server from the Interactive Apps menu.
  2. Specify the amount of time you would like the Code Server to run.
  3. Once the Code Server is ready, click Connect to VS Code to access VS Code.

Debugging Open OnDemand

If you have trouble logging into OOD (including if the login pop-up box keeps reappearing after you enter your username and password), you may need to make sure you have completely exited out of other OOD sessions. This could include closing browser tab(s)/window(s), clearing your browser cache and clearing relevant cookies. You might also try running OOD in an incognito window (or if using Google Chrome, in a new user profile).

Logs and scripts for each interactive session with Open OnDemand are stored in:

~/ondemand/data/sys/dashboard/batch_connect/sys

There are directories for each interactive app type within this directory. For example, to see the scripts and logs for an RStudio session, you might look at the files under:

~/ondemand/data/sys/dashboard/batch_connect/sys/brc_rstudio-compute/output/b5733507-a750-4bb9-8d4b-710618ce0de1

The BRC Open OnDemand interactive apps configuration is on GitHub. Additional information about Open OnDemand configuration is available on the Open OnDemand documentation.