Versions Compared

Key

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

...

...

...

...

...

...

...

...

...

...


Table of Contents


O2 cluster logins originating from outside of the HMS network require two-factor authentication.

Please see the Two Factor Authentication page for more information.

Once you have an O2 account, you can login 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.

If you do not currently have an O2 account and would like to request one, please use the O2 Account Request Form.

  • Note: the "HMS ID" was formerly known as an "eCommons ID"

Quick start

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:

...

Open the Terminal application (found through Applications > Utilities). Enter the ssh command with your eCommons in lowercase, and press enter. When prompted, enter your HMS ID password. Image Removed

...

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.Image Removed

...

After you have successfully authenticated, you will see a welcome message, and will be able to enter commands after the prompt. Image Removed

...

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.

Using MobaXterm

First, download and install MobaXterm for Windows: https://mobaxterm.mobatek.net/

Open the MobaXterm software and enter the ssh command with your eCommons in lowercase, 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.Image Removed

...

After you have authenticated, you will see a welcome message, and will be able to enter commands after the prompt.Image Removed

...

Using PuTTY

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. 

...

Open the PuTTY software and enter the ssh command with your eCommons in lowercase@o2.hms.harvard.eduImage Removed

...

If you need X11 support, on the left panel, select Connection->SSH->Auth-X11, click the check box for "Enable X11 forwarding". Image Removed

...

 Click button "Open". When prompted, enter your HMS ID password.Image Removed

...

After you have authenticated, you will see a welcome message, and will be able to enter commands after the prompt.Image Removed

...

Troubleshooting logging into O2

Please do NOT do NOT send us or anyone else your password. Ever. We can assist you without knowing your password, and sharing accounts on the cluster is prohibited by Harvard security policy.

If you're having difficulty logging in to O2, make sure you're using your HMS ID and eCommons password. Your HMS ID must be in lowercase. If that does not resolve the problem, then try then try logging in to in to https://myaccount.hms.harvard.edu. Contact the IT Service Desk (itservicedesk@hms.harvard.edu, or 617-432-2000) if you're unable to login to the eCommons website. Your eCommons may have been locked due to too many failed login attempts to the O2 cluster. Once you are able to login to eCommons, wait 1 hour and try logging in to O2 again. If you're still facing problems, then send in a ticket to us.