Docs

Setting up your JASMIN account for access to MASS

 

Share via

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.

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.

Follow us

Social media & development