M3 User Guide

Attention

This documentation is under active development, meaning that it can change over time as we refine it. Please email help@massive.org.au if you require assistance.

Connecting to M3 via ssh

To connect to M3, you will be required to use ssh. If you’re already confident with the command line, you can simply ssh into M3 using your HPCID username and password.

ssh username@m3.massive.org.au

If you need further instructions, consult the relevant section below for your Operating System.

Linux and OS X Users

To connect to M3, Linux and OS X users need to start a terminal session. The process is very similar, however OS X users may need to take some additional steps.

Note

OS X Users: To start a terminal session, in Finder, navigate to Applications > Utilities and double click on Terminal.app

Once you have launched a terminal session, execute either one of the following commands:

ssh -l username m3.massive.org.au
ssh username@m3.massive.org.au

Enter your password at the prompt and you will be directed to the login node. If this is the first time that you have logged into M3, you will be asked if you wish to accept the host key of the node you are connecting to. This is just an identifier for the login node. Enter yes at the prompt and you will not be asked again; the login node’s credentials will be stored on your local system.

X11 port forwarding

To enable X11 port forwarding the -Y or -x flag is required when you use the ssh command, depending upon which version of ssh you have installed on your system.

ssh -l username m3.massive.org.au -Y

To test that the session supports port forwarding, use the xclock or xeyes command.

Note

OS X Users: To enable X11 port forwarding OS X users using OS X 10.4 and above need to install the XQuartz application as X11 is no longer shipped with OS X.

Windows Users

The recommended software is Putty which is available from: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

Note: if you are connected to the Monash network, you must download the zip file and not the exe file.