The Firebird computing cluster runs the Open OnDemand system, which provides access to files, jobs, and an interactive desktop via a web browser.

Accessing the site

You must have a Firebird account set up to use Open OnDemand.  To obtain an account, complete a Firebird Account Request. 

• In a web browser, go to https://firebird.swarthmore.edu

• You will be presented with a CILogon page; under Select an Identity Provider, choose Swarthmore College

• Click Log On. You will be directed to Swarthmore’s single sign-on page.

• Once you have authenticated, you should be logged into Open OnDemand.

Features

Open OnDemand is feature-rich, though certain features available from the Open OnDemand menus and interface may be unavailable. The most useful applications are the file browser, Slurm job lists, the interactive desktop, and Jupyter Notebooks.

Interactive Desktop

It is possible to launch an interactive desktop from within Open OnDemand, which provides a graphical Linux desktop environment running on a Firebird worker node. This can be useful for running a graphical program such as MATLAB, Mathematica, Stata, etc. There are time and resource limits, so the interactive use is not designed for long-running or intensive compute jobs. To launch an interactive desktop session after logging in:

• From the top menu bar, click Interactive Apps

• Click Firebird Desktop

• Adjust values in the form (e.g., cores, memory, and whether you require a GPU) and click Launch

• You may have to wait a minute for the session to start; when it does, click Launch Firebird Desktop

  • note that if insufficient resources are available to create the desktop immediately, you may have to wait for resources to become available; if so, you can elect to receive an email when your desktop is available

File Browser

Open OnDemand provides a helpful file browser, which shows a list of your files on Firebird and makes it easy to manage them. It is possible to upload and download files as well as view and edit text files, which can be handy for simple changes.

• From the top menu bar, click Files → Home Directory

Jupyter Notebooks

Users can launch a basic Jupyter Notebook through Open OnDemand. In certain cases, such as when specific Python libraries or a GPU are required, it makes more sense to create a specific miniconda environment and launch custom Jupyter notebooks through the interactive desktop; nevertheless, this generic option can be useful for testing, class use, etc. Moreover, from within the Jupyter interface, it is possible to open an interactive Python console, as well as a shell / terminal session.

• From the top menu bar, click Interactive Apps

• Click Jupyter Notebook

• Adjust form values as needed (most can be left blank or at the default value, but it may especially be helpful to adjust the time needed) and click Launch

• You may have to wait a minute for the session to start; when it does, click Launch Jupyter Notebook

  • note that if insufficient resources are available to create the notebook immediately, you may have to wait for resources to become available; if so, you can elect to receive an email when your notebook is available

Shell / Terminal Session

It is possible to open a terminal session from within Open OnDemand. Doing so, however, requires a password to be associated with your account. If you would like to enable this feature, please open a ticket (by sending an email to support@swarthmore.edu or at https://support.swarthmore.edu) requesting shell access through Open OnDemand. Once you have access, to access the terminal:

• From the top menu bar, click Files → Home Directory

• In the upper-right of the screen, click Open in Terminal

Slurm Jobs

See a list of Slurm jobs running on Firebird.  The default view shows only your jobs, but it can be changed to view all jobs.  Expanding a job shows more details.  While it is also possible to submit jobs from this interface, for most cases it is easier to use the command line:

• From the top menu bar, click Jobs → Active Jobs