Once you have an O2 account, you can log in to the O2 cluster and submit jobs. Please reference the "Quick Start" section below to get connected to the cluster. If you need further detail on how to connect, you can refer to the appropriate section based on your operating system.
Note: the "HMS ID" was formerly known as an "eCommons ID"
You can connect to O2 using ssh (secure shell) at the hostname: o2.hms.harvard.edu. If you're on Linux or Mac, you can use the native terminal application. If you're on Windows, you will need to install a program to connect to O2; we recommend MobaXterm. In either terminal or MobaXterm, type the following command:
where you substitute youraccount for your actual HMS ID in lowercase. You will be prompted to enter your HMS ID password, but note that the cursor will not move as you type your password. Once you authenticate, you'll be on one of the O2 login servers. You should not run anything computationally intensive on the login servers. Submit an sbatch job or request an interactive session with srun to run such processes instead. Reference the Using Slurm Basic for further information on submitting jobs.
Open the Terminal application (found through Applications > Utilities). Enter the ssh command with your HMS ID in lowercase (e.g. abc123), and press enter. When prompted, enter your HMS ID password.
If you are logging on from outside the HMS network, then two-factor authentication via your HMS Duo profile is required. You can choose which method to authenticate by: 1 for push, 2, for phone, or 3 for codes send via SMS. In the screenshot below, Duo push was selected. If you want to bypass selecting a method each time you need to authenticate, then you can set DUO_PASSCODE by following these instructions.
After you have successfully authenticated, you will see a welcome message, and will be able to enter commands after the prompt.
Logging in on Windows
To login to the O2 cluster if you have a computer running Windows, you can choose to either use MobaXterm or PuTTY. We recommend MobaXterm, as it has a larger available range of features.
Open the MobaXterm software and enter the ssh command with your HMS ID in lowercase (e.g. abc123), and press enter. When prompted, enter your HMS ID password.
Note: To avoid consecutive DUO authentication while connected to O2, you should set SSH-browser type to None.
After you have authenticated, you will see a welcome message, and will be able to enter commands after the prompt.
To enable graphical forwarding, first download and install Xming (https://sourceforge.net/projects/xming/). Any time you want to use graphical forwarding, double click Xming (all this does is put an icon in your Windows toolbar) before opening PuTTY.
Your HMS DUO profile can, separately, also get locked due to multiple failed login attempts. If this happens, HMS DUO profiles should auto-unlock after 1 hour. If you're still facing problems, then send in a ticket to HMS Research Computing.