Setting up your JASMIN account for access to MASS

The following notes are written assuming you are using a Linux machine in your home institution, that you have applied for a new MASS account, and that you have received an email from the Met Office Storage Team with your new MASS credentials file attached.

Load your SSH key  

Start an ssh-agent on your home institution machine, load your private key, and enter your passphrase when requested.

eval $(ssh-agent -s)
ssh-add ~/.ssh/id_ecdsa_jasmin
Enter passphrase for ~/.ssh/id_ecdsa_jasmin:

Note: it’s a good idea to keep your private keys for different systems separated, so you may want to keep your private key for JASMIN in a separate file, just move the one created during the process described above to a new sensible location such as ~/.ssh/jasmin_id_rsa.

Test login to the JASMIN login node  

Note: that the -A in the first ssh command is mandatory to enable access to the client VM, the -X enables X11 forwarding and is optional.

ssh -A -X <userid>@login-01.jasmin.ac.uk

3. Test login to the MASS client host  

From the login machine, you can then login to the MASS client host.

Note: If it does not let you log in even when you have agent forwarding correctly set up and can log into the “sci” nodes, then you have either not requested additional access to the dedicated client machine, or access hasn’t been approved yet, email the Met Office Service Manager monsoon@metoffice.gov.uk, to verify that approval has been granted. Allow a couple of days for this process to happen after submitting your request for access to the VM.

ssh -X <userid>@mass-cli.jasmin.ac.uk

echo "Hello World"
Hello World
exit

exit

# back on your local machine

Install your MOOSE credentials file  

You can scp the file via a JASMIN transfer server, make sure the credentials file is called moose, and you must run the moo install command on mass- cli.jasmin.ac.uk to set it up for you.

scp moose <userid>@xfer-vm-01.jasmin.ac.uk:~/moose
ssh -A -X <userid>@login-01.jasmin.ac.uk

ssh -X <userid>@mass-cli.jasmin.ac.uk

ls -l ~/moose
-rwx------ 1 <userid> users 511 Jul  3 13:45 /home/users/<userid>/moose
moo install
### passwd, command-id=148593088
Your password is due to expire in -1 day(s).
A new password can be generated using 'moo passwd -r'.
ls -l ~/.moosedir/moose
-rw------- 1 <userid> users 511 Jul  3 13:45 /home/users/<userid>/.moosedir/moose

Having run these commands on the client machine, the moose file will have disappeared from your home directory, but a .moosedir directory will have been created, this will contain a new moose file, an install.log file, and once you start making MOOSE queries, a moose-external-client.log will be created.

Test use of the locally installed MOOSE client  

which moo
/opt/moose/external-client-version-wrapper/bin/moo
moo si
<system information appears here>
moo help
<help details appear here>
moo projlist
<list of projects appears here>

You have now successfully accessed MASS from JASMIN!

If you are new to MOOSE, you might like to read the User Guide next.