Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This app will start the RStudio application on one of the O2 cluster compute node. This application allows you to write R code, run it, and create graphs interactively.

...

...

Description of the available fields for customizing the O2 Portal job

...

The number of CPU cores you want to allocate for this job.

GPUs (optional):

If you selected a GPU partition, then specify the GPUs to allocate for the RStudio job.

GPU card type (optional):

If you selected a GPU partition, then select a GPU card type

Wall Time requested in hours:

...

Enter the O2 modules to be loaded, typically gcc and R. Default is gcc/9.2.0 R/4.1.2

GPUs (optional):

If you selected a GPU partition, then specify the GPUs to allocate for the RStudio job.

GPU card type (optional):

If you selected a GPU partition, then select a GPU card type

Receive an Email

A checkbox to receive an email when the session starts

Show advanced settings

A checkbox to bring up a set of advance options

Optional Environment Setup

...

You can add additional commands here that will be executed before the RStudio server is started. This is an optional field and might not be necessary for most users

...

Filesystem to make available

...

.

...

Slurm Custom Arguments

This is an optional text field that can be used to pass additional flags to the Slurm scheduler when submitting the job.

Shared R Personal Library

Enter a path to a shared R Personal Library, which overwrites the ~/.Renviron file configuration.

For more information about the different jobs submission flags please read our main O2 wiki page at https://wiki.rc.hms.harvard.edu/display/O2.

...

The Session ID highlighted link can be used to see the log files created for the current jobs on a new OOD browser tab. Alternatively, you can click on the output.log hyperlink within the Progress & Error log section.

When the job is dispatched and ready to run you should see a screen like:

...

After you finish using the app, you need to close the RStudio browser tab and click on Delete from within the Open OnDemand Interactive session.Image Removed 

...

Note: Closing the browser will not terminate the active application. The OOD job will keep running until it reaches the requested Wall Time limit or the "Delete" button is used.

...

If something does not work properly please make sure to record the actual O2 jobid  printed at the top of the interactive app window Image Removed

...

( 26733893 in 33226137 in this example) and click on the Session ID highlighted link which should open a web browser page like:

...

To debug your problem you can start by checking the output log in the file output.log. Select the file and click the "View" button to see the content of the ouput.log hyperlink (circled in red):

image-20240301-210419.pngImage Added

Once you click there, a new tab opens with information about the RStudio session. For example:

...

Often the reason of why a job failing is capture near or at the end of the output.log file.

If you need additional help you can reach out to rchelp@hms.harvard.edu, make sure to include the full path listed on the OOD file page along with any content printed in the output.log file.

...