Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
You can launch several different apps on the Open OnDemand (OOD) interface. All of these apps start of a Slurm batch job on the Oscar cluster with the requested amount of resources. These jobs can access the filesystem on Oscar and all output files are written to the Oscar's file system.
Open https://ood.ccv.brown.edu on any browser of the your choice
If prompted, enter your Brown username and password.
Click on the "Interactive Apps" tab at the top of the screen to see the list of available apps. This will open the form to enter the details of the job.
Follow the instructions on the form to complete it. Some of fields can be left blank and OOD will choose the default option for you.
Click Launch to submit an OOD job. This will open a new tab on the browser It may take a few minutes for this job to start.
Click "Launch <APP>" again if prompted in the next tab.
SLURM limits on resources such CPUs, memory, GPUs or time for each partition still applies for OOD jobs. Please keep these in mind before choosing these options on the OOD form.
When submit a batch job from a terminal of the Desktop app or the Advanced Desktop app, users need to
run "unset SLURM_MEM_PER_NODE"before submitting a job if the job needs to specify --mem-per-cpu
run "unset SLURM_EXPORT_ENV" before submitting an MPI job
Open OnDemand (OOD) is a web portal to the Oscar computing cluster. An Oscar account is required to access Open OnDemand. Visit this link in a web browser and sign in with your Brown username and password to access this portal.
OOD provides with a several resources for interacting with Oscar.
Use the File Explorer in the portal to view, copy, download or delete files on Oscar.
Launch interactive apps/softwares, like Matlab and Jupyter Notebook, inside your web browser.
Access the Oscar shell with your browser without needing a separate terminal emulator. This is especially handy for Windows users, since you do not need to install a separate program.
No installation needed. Just use your favorite browser!
No need to enter your password again. SSH into Oscar in seconds!
No need to use two-factor authentication multiple times. Just do it once, when you log into OOD.
Use it with, or without, VPN. Your workflow remains the same.
Open OnDemand offers a browser-based terminal app to access Oscar. Windows users who do not want to install an SSH client like Putty will find this app very useful.
Log in to https://ood.ccv.brown.edu
In the top menu, click Clusters -> >_OSCAR Shell Access
A new tab will open and the web-based terminal app will be launched in it. The shell will be launched on one of the login nodes.
The shell DOES NOT start on a compute node. Please do not run computations or simulations on the login nodes, because they are shared with other users. You can use the login nodes to compile your code, manage files, and launch jobs on the compute nodes.
3. You are logged into one of the login nodes. You can launch batch jobs from this terminal or start an interactive job for anything computationally intensive.
No installation needed. Just use your favorite browser!
No need to enter your password again. SSH into Oscar in seconds!
No need to use two factor authentication again. Just do it once, when you log into OOD.
Use it with, or without, VPN. Your workflow remains the same.
We recommend all users to install Python packages within an environment. This can be a Conda to a python virtual environment. More information can be found here. Follow these steps to use such environments in the Jupyter app.
Open a terminal on Oscar.
Load the relevant python module and create and/or activate the environment. See this page for more information about creating virtual environments.
Run pip install notebook to install Jupyter notebook, if not already installed.
Run pip install ipykernel to install ipykernel in this environment.
Run python -m ipykernel install --user --name=<myenv> where <myenv> is the name of the environment.
Open the "Basic Jupyter Notebook for Python Environments" app on the Open OnDemand interface
Under "Python Module on Oscar", choose the python module you loaded when the environment was created.
Under "Python Virtual Environment", add the name of the Virtual Environment you created. Note: If your virtual environment is not at the top level of your home directory, you should input the absolute path to the environment directory.
Under the "Modules" , enter the name of the python module used to create the environment. Add any additional modules you may need separated with a space.
Choose the other options as required.
Click "Launch" to start the job
Click "Connect to Jupyter" on the next screen.
To start a new notebook, click "New" -> <myenv> where <myenv> is the environment.
For starting a pre-existing notebook, open the notebook. In the Jupyter interface, click "Kernel" -> "Change Kernel" -> <myenv> where myenv is the name of the environment.
Open a terminal on Oscar.
Activate the conda environment.
Run pip install notebook to install Jupyter notebook, if not already installed.
Run pip install ipykernel to install ipykernel in this environment.
Run python -m ipykernel install --user --name=<myenv> where <myenv> is the name of the environment.
Open the "Basic Jupyter Notebook with Anaconda" app on the Open OnDemand interface
Under "Oscar Anaconda module", choose "anaconda/2020.02"
Enter the name of the conda environment in "Conda Env"
Choose the other options as required.
Click "Launch" to start the job
Click "Connect to Jupyter" on the next screen.
To start a new notebook, click "New" -> <myenv> where <myenv> is the environment.
For starting a pre-existing notebook, open the notebook. In the Jupyter interface, click "Kernel" -> "Change Kernel" -> <myenv> where myenv is the name of the environment.
The Desktop app on Open OnDemand is a replacement for the older VNC Java client. This app allows you to launch a Desktop GUI on Oscar.
Advanced users looking for more resources can try the Desktop (Advanced) app.
Do not load any anaconda module in your .modules or .bashrc file. These modules prevent Desktop sessions from starting correctly. You may load them inside the Desktop session.
Click here to launch Open OnDemand (OOD) and log in with you Brown Credentials.
Desktop option in Interactive Apps dropdown list:You may change the Image Quality if your internet connection is bad. Image quality can be changed in the middle of the session.
A session may get disconnected if it is not active for a while:
If the session disconnects as shown above, please don't click the "Connect" button on the screen. You may go to Open OnDemand page and click “My Interactive Sessions” to find the session again:
Please don’t launch a new session if you have an existing session. You cannot launch two desktop sessions at the same time.
Sometimes, the “My interactive Sessions” button is shortened to look like:
If you are using Google Chrome, switch on the "Clipboard" permission and you can directly copy and paste text into the OOD Desktop from any other program.
Click the Lock icon to the left of the URL
Switch on the "Clipboard" permission
Click the side panel button on the extreme left hand side of the screen.
To copy text into the Desktop session, paste the data into the Clipboard. It will be available to paste inside the Desktop session.
To copy text from the Desktop session, open the Clipboard. The copied text will be displayed inside it. You can select and copy the text inside the Clipboard and paste it to an external program.
If you need more or different resources than those available from the default Desktop session, you should use the Advanced Desktop app. Resources requested here count against the resources allowed for your Oscar account.
Fill out the form with your required resources.
Account: Enter your condo account name. If you are not a member of a condo, leave this blank
Desktop Environment: Choose XFCE. KDE works for CPU jobs, but may not be able to use GPU acceleration correctly.
Number of hours: Choose appropriately. Your Desktop session will end abruptly after this time has lapsed. Requesting a very long session will result in a lower job priority.
Partition: Equivalent to #SBATCH -p option. The desktop session will run on this partition.
Num Cores: Equivalent to the #SBATCH -n option.
Num GPUs: Equivalent to the #SBATCH --gres=gpu: option. This field is ignored if the partition does not have any GPU nodes, e.g. batch
Memory (GB): Equivalent to the #SBATCH --mem= option.
Reservation: Equivalent to the #SBATCH --reservation= option. Leave blank if you are not using a reservation.
Wait and launch this session like the regular Desktop session.
Inside the Desktop session , click on Applications in the top left
Applications -> Settings -> Default Applications
In the new Window, click on the "Utilities" tab and choose "Gnome Terminal" in the drop down menu under "Terminal Emulator"
Then click on "Applications -> Terminal Emulator" to launch the terminal:
Close the Desktop session
Inside a terminal (outside the Desktop session), run this command:
rm -r ~/.ood_config
Start a new desktop session .
Please drag and drop the "Terminal Emulator" icon from the "Applications" menu to the launcher panel at the bottom of the screen, it will be inserted to the launcher panel:
Then click on "Create Launcher":
You may remove the old terminal icon after adding the new icon:
The filesystem on Oscar can be accessed through the file explorer on this web portal. The file explorer allows you
List files
Create a directory
Rename files
Copy/Move files
To access the file explorer, click "Files" -> "Home Directory" at the top of the screen.
Check the documentation below for some of these services below:
To access a directory, click "Change directory" and enter the path name
Do not use "~" in your directory path name. The path should start with "/users" or "/gpfs/"
To access your home directory, click the "Home Directory" link on the left. The path name at the top of the page should change to "/users/<username>"
To access your scratch directory, click the "scratch" directory in your home directory OR click "Change directory" and enter "/users/<username>/scratch"
To access your data directory, click the "data" directory in your home directory OR click "Change directory" and enter "/users/<username>/data"
Click the icon with the three dots -> Edit
The file will open in a text editor in a new tab
Click the icon with the three dots -> Download
To download multiples files:
Click the check-box to the left of the file name.
Scroll to the top of the page and click "Download"
Directories are downloaded as zipped files on your computer.
Click the "Upload" button.
Follow the instructions on the screen. You can click the "Browse" buttons or drag and drop files.
Click "Open in Terminal" at the top of the page.
A web-based terminal will open in a new tab of your browser. You will be logged into one of the login nodes.
RStudio is an IDE for R that can be run on Oscar.
Open the Open On Demand Dashboard by following . Select RStudio (under "Default GUI's"). Fill in the form to allocate the required resources, and optionally select your R modules. Finally, click the "Launch Session" button.
Plotting figures may not work within RStudio. If this is the case, save the plots to a file, and view them through the Open On Demand Desktop App. If plots are required for your task, launch RStudio through the Desktop App.
To learn about using the Open On Demand Desktop App, look .
that contains the plain-text file.
that contains the file or directory.
where you need to upload the files.
where you would like to open the terminal
