Table of Contents
- 1 Odyssey access requires an RC account
- 2 Odyssey access requires the OpenAuth tool for two factor authentication
- 3 Download VPN and install VPN software appropriate for your computer
- 4 Use common terminal application for command line access
- 5 Setup X11 forwarding for lightweight graphical applications
- 6 Consider an NX remote desktop for graphical applications like Matlab and RStudio.
- 7 Mounting Odyssey storage, like home directories and lab shares, on your desktop
Odyssey access requires an RC account
Odyssey resources (storage, software downloads, special workstations, instrumentation scheduling, etc.) can be accessed through a number of paths (see below), but all require an RC account. An account can be requested through the account request web application.
On this first form, please select "Internal" as User type. On the "Services" page, select "Odyssey Cluster Use".
We aim to generate accounts as quickly as possible once they are approved by the sponsor. Please see the following page for more details on the process and turnaround times: How Do I Get an RC Account?
The password that you've set in the account request application will be the password you use to access Odyssey resources. If you later forget the password, you can reset it using the password reset application.
NOTE! You are required to attend the Introduction to Odyssey course within 45 days of your account issue; otherwise you will not be able to run any jobs.
Odyssey access requires the OpenAuth tool for two factor authentication
Unless you're only interested in using the SPINAL scheduling software, logins to Odyssey resources use a two factor authentication scheme that is supported by the OpenAuth tool.
The installation of the OpenAuth tool is a two step process that starts at the RC OpenAuth request page and ends with an email that allows you to download your personalized copy. This link will prompt you for your Harvard FAS Research Computing username and password and send an email with your personalized download link. Since the site uses email verification to authenticate you, you must also have a valid email address on record with us.
All OpenAuth tokens are software-based, and you will choose whether to use a smart phone (using the Google Authenticator or Duo Mobile app, both available for iPhone and Android) or java desktop app to generate your verification codes. Java 1.6 is required for the desktop app. You must close your browser in order to logout of the site when you’re done. Once installed, the OpenAuth tool is a small Java application window that provides a time-limited verification code. This is used whenever you are prompted for a "Verification code" or a second password.
Once you complete the quick steps in the above site, you’ll be all set to use OpenAuth. You may also revisit that site in order to setup your token on an additional device (you’ll still be able to use your original device, too).
For those using OS X, you might want to download and install the OTP Token Paster for OS X. This service enters the current one-time password (OTP) into the current iTerm window using a hotkey.
Please keep in mind the revoke link if you ever lose the device with your token or otherwise insecurely handle your token and need to start over with a new one.
For troubleshooting issues you might have, please see our troubleshooting page.
SPINAL access does not require two-factor authentication
If you are using your RC account mainly for access to the SPINAL instrument scheduling software, the VPN and OpenAuth installations described above are not required.
Download VPN and install VPN software appropriate for your computer
Odyssey resources must be accessed through a virtual private network software (VPN) for any off-campus connections. A VPN ensures that all communication between your computer and RC resources is encrypted even when using a public wireless network. See the VPN page for software download and setup instructions.
Use common terminal application for command line access
If you're using a Mac, the built-in Terminal application (in Applications->Utilities) is very good, though there are replacements available (e.g. iTerm2). After starting a Terminal session, use the
ssh command to login to Odyssey.
To avoid login issues, always supply your username in the ssh connection as above, since omitting this will cause your local login name at your terminal to be passed to the login nodes.
If you're using a Windows PC, Putty is a commonly used terminal tool. After a very simple download and install process, just run putty and enter
login.rc.fas.harvard.edu in the Host Name box.
Just click the Open button and you will get the familiar password and verification code prompts.
Once you've logged in successfully, see below for instructions about how to run jobs.
HUIT (Harvard IT) also provides downloads for SecureCRT and SecureFX, a terminal and file transfer tool respectively, but users have recently reported difficulties with both. If you'd like to try them. go to the HUIT download page (you'll need your Harvard PIN) and download either or both of these tools.
Setup X11 forwarding for lightweight graphical applications
Many graphical applications can be run from Odyssey with a combination of terminal X11 forwarding and an X Windows server. For Macs, the XQuartz X Windows server package is the currently recommended install. For Windows, Xming is a good choice. Both are free.
NOTE: Another X Windows client for Windows called MobaXterm has started to gain users. Please be aware that you may need to use its Tools -> MobApt packages manager to install additional components before some X applications will work. You will almost definitely need to install xset before using any GUI apps (Mathematica, etc.) on Odyssey. See MobaXterm's Help documentation for more.
After installation, run the X Windows server application, and then connect with X11 forwarding enabled. From an X window on Mac or Linux, add the -CY option to the ssh command. Example:
For PCs using Putty, make sure and check the X11 forwarding box under Connection -> SSH -> X11
Consider an NX remote desktop for graphical applications like Matlab and RStudio.
Many graphical applications will run fine with the X11 forwarding steps described above, especially if you are connected to the campus network. However, X11 is a very old protocol designed for local physical networks and so can become very slow when wireless signal is poor or when accessed from home. Also, when you disconnect from the network, there is no way to "suspend" your graphical session for later use.
holynx01 servers host remote desktops served by the NoMachine NX system. Like Windows RDP and VNC, NX allows you to connect to a desktop that is running on a remote server. The network performance makes graphical applications much more responsive. And because it is running on a server, you can disconnect from the desktop (suspend) and reconnect later.
NX connection and usage
Note: You will need to install the noMachine client to use NX. The NX/noMachine software can be downloaded from the NX download site for all OSes.
NOTE: The default, free client for NX obtained when going to the download page will not work correctly with the Odyssey NX servers. The Enterprise Client available from the link above is the best choice.
These screen shots show NX on a Mac. PC software is very similar and the same choices should be made.
- Make sure you are connected to the RC VPN (vpn.rc.fas.harvard.edu)
holynx01servers are not accessible from outside of the RC VPN. In particular, you cannot access them from the FAS VPN (vpn.fas.harvard.edu). If you are unsure how to connect to our VPN, see VPN Setup
REMINDER: When connecting to our VPN you will need to supply your username@realm (example: johnsmith@odyssey - @odyssey is the default realm for most users) as well as your OpenAuth (not Harvard Key) 2 factor token. For everything else, you will just use your username.
- Add a New Connection
After starting the NoMachine client software, you should begin in the new connection wizard. Setup the connection by first clicking on the "Click here to create a connection" link or the "New" button. The example images below use
holynx01.rc.fas.harvard.edu, but both
holynx01.rc.fas.harvard.eduare available for use.
- Select the SSH protocol
The SSH protocol should be chosen, not NX.
- Specify the hostname
This should be
holynx01.rc.fas.harvard.edu. If you have never connected to either machine before, you may be prompted to verify the authenticity of the server.
- Use the NoMachine login
When prompted, select the "Use the NoMachine login" rather that the system login.
- Don't use a proxy
No proxy is needed to access the NX head nodes when connected via RC VPN.
- Give the connection a name
This name will be used to identify the connection on your NX dashboard.
- Select your new connection
Once the connection is setup, you can choose it from the dashboard to start a new session.
- Login using your RC credentials
After selecting your connection, you will be prompted for login credentials. This should be your RC login; no
- Create a new desktop
Once you've logged in, you'll have the option to create a new desktop. Only Gnome desktops are supported by the Odyssey NX login nodes.
- Read or skip through the connection message panels
The NX session wizard will present you with a number of informational panels when you first setup a session. You can read these, or skip through them. Check the "Don't show this message again" boxes to avoid these in the future.
- The top left corner of your new desktop allows you to access a menu panel
If you mouse over the top left corner of the desktop and click on the "curled" image, you'll reveal a menu panel with a number of NX options. One of the most useful is the display panel that allows you to force the desktop to change with the size of the window.
- Use an interactive session
When you've connected to
rcnx01, you should treat them like any other login node. Software should not be run directly on NX login nodes. Use
srunas described in the interactive session section of the Running Jobs page to setup an interactive session. For graphical work, don't forget the
- When closing an NX session, choose Suspend or Terminate
When you close your NX window, you will be prompted to "Suspend" or "Terminate" the session. If you "Suspend" the session, you will be able to access it again later, whereas "Terminate" does pretty much what you'd think.
In addition to connecting to Odyssey servers and launching compute jobs, many scientists use Odyssey file systems for storage of lab data. Many, but not all, file systems can be mounted on your desktop to simplify data transfer. Odyssey file systems which are available to be mounted are shared via the Windows SMB protocol so this process is straightforward(ish).
PLEASE NOTE: Regal scratch space cannot be mounted in this manner. It is only available on the cluster. If you need to transfer data to Regal scratch, you can use an SFTP or SCP client to connect to the cluster and access /n/regal.
- Connect to the VPN if on wireless, or if on wired or wireless connections off Harvard campus
If using wireless connections, Odyssey storage must be routed through a VPN connection. If on wired connections inside Harvard, the VPN client is not required. If you don't already have one setup, follow the Odyssey VPN setup instructions.
NOTE: If you have previously manually changed your computer's DNS settings to use outside DNS such as Google or OpenDNS, this will cause issues connecting to share.
- Find out the name of the filesystem you want to mount(If you already know the path, skip to the next step.)
If you have cluster access, you can mount your home directory as a drive. You can figure out the path to your home directory by using
sshto login to Odyssey. Use
cdto go to the directory you wish to mount on your machine and type
df -h .(note the "." character at the end of the command). If it's your home directory,
cd ~will work.[dsulivan@rclogin05 ~]$ cd ~
[dsulivan@rclogin05 ~]$ df -h .
Filesystem Size Used Avail Use% Mounted on
4.0T 8.5G 4.0T 1% /n/home08/
The server name is the word before “:”, in the case above,
rcstore. The share name is the name after
/ifs/rc_homes. In the case above it is
The path that will be need for connecting is the combination of the servername, the word
homes, the share name, and your username. For the example, this will be:
All the instructions below use these values in the examples. You will need to substitute
home08with the values applicable to you.
Lab file shares are more simple. If you don't already know the path, ask a lab-mate, or froma login node:[dsulivan@rclogin05 ~]$ cd /n/newtonfs1
[dsulivan@rclogin05 newtonfs1]$ df -h .
Filesystem Size Used Avail Use% Mounted on
19T 17T 2.1T 89% /net/newtonfs1/newtonfs1
, as you use only the servername and sharename to form the URL
- Macs use Connect to Server
If you're using a Mac, go to a Finder window (or click on the desktop) and choose Go > Connect to Server from the menu.
In the server address box, enter the server and path combination as described above prepended with the
smb://protocol specifier (please note that Macs use "/" where Windows uses of "\"). Using the example information above, the value would be
smb://rcstore.rc.fas.harvard.edu/homes/home08/dsulivanto mount the home directory of the
dsulivanuser. If you are mounting a lab share path, enter that instead (example:
If you've selected the proper volume, you should get a login prompt. Use your Odyssey credentials here. Note that you must include the
rc\domain specifier at the beginning of your user name.
- PCs use Map Network Drive
You can connect to shared storage on a PC by using the Map Network Drive control panel application. This should be available from a Windows Explorer window.In the Map Network Drive utility, select a drive letter, then enter the combination of share and path. For the example described above, the correct entry would be
\\\\rcstore.rc.fas.harvard.edu\\homes\\home08\\dsulivan. If you are mounting a lab share path, enter that instead (example:
It is important to select the Connect using different credentials box. Usually, PC logins are not the same as Odyssey usernames and passwords. If you don't select this checkbox, it will attempt to login with your PC information and may result in a lockout. Also, make sure you are connected through the VPN if on wireless or off-campus -- this connection cannot be made outside of the VPN with these connection types/locations.
When you are prompted for a login, make sure and prepend the
rc\domain to your username.
- Linux using a terminal window
You can mount storage on a Linux system by using the desktop GUI or from the command line. Run
idcommand on your Linux machine to determine your uid and gid, then enter the following commands (set username to your RC username and set uid and gid to your local account values):mkdir /mnt/odyssey
mount -t cifs -o workgroup=rc,username=dsulivan,uid=1000,gid=1000
This will prompt you for your password. If instead you get an error message about a read-only filesystem, it could be because the
mount.cifscommand is not installed on your system. Using this method, you will need to reissue the command every time you boot your computer.
Last updated: September 26, 2017 at 11:14 am
This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License. Permissions beyond the scope of this license may be available at Attribution.