Docs
Setting up your JASMIN account for access to MASS
Steps to access MASS from JASMIN
The following notes are written assuming that you:
- are using the machine where your SSH key is stored (your laptop or desktop in your home institution)
- have applied for a new MASS account
- have received an email from the Met Office Storage Team with your new MASS credentials file attached.
Load your SSH key
Use one of the methods in Present SSH Key to make sure your key is available for use in your Terminal session.
It’s a good idea to use separate private keys for different systems (e.g. JASMIN, Met Office) so you may have multiple SSH private key files, named as per those systems.
If so, you can repeat the process of presenting your key for each private key file, so that you have all the keys that you need loaded within the same agent in your Terminal session.
Test login to the JASMIN login node
Note: You will need “agent forwarding” enabled for your initial connection: this is the -A
option for the initial connection to the login node. Graphical clients normally provide a tick-box option for this. Likewise, if you need graphics output you should also use -X
to enable X11 forwarding, but for any graphics-heavy applications you are recommended to make the initial connection using the
NX graphical linux desktop service instead and use a Terminal window within that environment.
In your terminal window:
ssh -A -X <userid>@login-01.jasmin.ac.uk
Test login to the MASS client host
From the login machine, you can now make the onward connection to the “MASS client” host.
ssh -X <userid>@mass-cli.jasmin.ac.uk
echo "Hello World"
Hello World
exit
exit
# back on your local machine
If the mass client host does not let you in, even when you have correctly set up agent
forwarding (test this by making an onward connection to a sci
server), then you have
either:
- not requested additional access to the dedicated client machine, or
- access hasn’t been approved yet, in which case email the Met Office Service Manager, 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.
Install your MOOSE credentials file
You should now copy your MOOSE credentials file from your local machine to your JASMIN home directory
using scp
via a JASMIN
transfer server. Make sure the credentials file is called moose
and in a directory with the correct permissions.
Start on your local machine, where you should have the credentials file:
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
Create a .moosedir
directory and set the correct permissions:
mkdir .moosedir/
chmod 700 .moosedir/
Move your moose credentials file into the directory and set permissions:
mv moose .moosedir/
chmod 600 .moosedir/moose
Run the following command:
moo si -l
You will be prompted to run moo passwd -r
next — please run this.
To confirm you have the ability to run moose commands, run:
moo si -l
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.