JULES MONSooN setup

General Advice

What is MONSooN?

The MONSooN shared supercomputing service is a collaboration between the Met Office and the Natural Environment Research Council (NERC) to provide a shared supercomputing resource to enable collaborative research. Further details, including how to apply to use the system, can be found here and here.

Please ensure that you login to exvmsrose - please do not try from other systems since they do not have the required setup.

MONSooN collaboration Intro Pack page

External Access

Advice on getting started on MONSooN on a computer anywhere:

The commands to enter and the onscreen instructions returned by lander MONSooN are interleaved with advice and help.

Please be read and follow the instructions carefully, after the first time you access MONSooN it is much easier.

First time you access MONSooN
In a terminal:

#ssh to the lander MONSooN, use your username.
$ ssh <MONSooNUSERNAME>@lander.monsoon-metoffice.co.uk
The authenticity of host 'lander.monsoon-metoffice.co.uk (212.219.243.19)' can't be established.
RSA key fingerprint is ################################################.

#Type "yes" and press the enter key after the next onscreen instruction.

Are you sure you want to continue connecting (yes/no)? yes

Warning: Permanently added 'lander.monsoon-metoffice.co.uk,###.###.###.##' (RSA) to the list of known hosts.
WARNING:
This computer is provided for the processing of official information.
Unauthorised access described in Met Office SyOps may constitute a criminal offence.
All activity on the system is liable to monitoring.

#This is the 6 digit number on the RSA keyfob and sometimes call the "tokencode".
#This number changes every ~minute with a countdown on the right hand side displayed by the horizonal lines which decrease from 6 to 0, at 0 it changes to a new number.

Enter PASSCODE:######

#Type "y" and press the enter key after the next instruction

To continue you must enter a new PIN. Are you ready to enter a new PIN? (y/n) [n]: y

#Think of a memorable PIN which is 4-8 digits.
#Enter it after the next instruction followed by the enter key.
#Then confirm it by entering it again when requested followed by the enter key and then press the enter key again to continue.

Enter new PIN between 4-8 digits:####(####)
Re-enter new PIN to confirm:####(####)
New PIN accepted, press enter to continue.

#Now enter your PIN followed by the PASSCODE and press the enter key after the following request.

Enter PASSCODE:####(####)######
Wait for the tokencode to change, then enter the new tokencode :######

==============================================================================
Latest news and information regarding MONSooN can always be found at
http://collab.metoffice.gov.uk/twiki/bin/view/Support/LatestNews
                                     AJ Watling, MONSooN Tech Lead  7/10/2015
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
*** REMINDER - MONSooN Cutover *TODAY* 14th March                         ****
Please do not use Monsoon until notified via Newsgroups/Yammer/TWiki.
http://collab.metoffice.gov.uk/twiki/bin/view/Support/Monsoon2Migration
Many thanks - AJ Watling
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Add the following to the top of your .bash_profile file if missing:

# Provide access to FCM, Rose and Cylc
PATH=$PATH:~fcm/bin

# Ensure .bashrc is sourced in login shells
# (only add this if it is not already done in your .bash_profile)
[[ -f ~/.bashrc ]] && . ~/.bashrc

Connect to the cylc server.

#ssh to the cylc server

[<MONSooNUSERNAME>@exvmslander:~]$ssh -Y exvmsrose
WARNING:
This computer is provided for the processing of official information.
Unauthorised access described in Met Office SyOps may constitute a criminal offence.
All activity on the system is liable to monitoring.
Last login: Fri Mar 31 07:12:22 2017 from ##.###.##.##

#Enter your MOSRS password at the prompt and press enter.
#If you miss type your MOSRS password use "mosrs-cache-password" to try again.
#You will be asked for your MOSRS password everytime you log in.
#If not then your setup is incorrect and this must be corrected, see further instructions below.

Met Office Science Repository Service password:MOSRSPASSWORD
Subversion password cached
https://code.metoffice.gov.uk/rosie/u/hello: Hello <MOSRSNUSERNAME>
Rosie password cached

Add the following to the top of your .bash_profile file if missing:

# Provide access to FCM, Rose and Cylc
PATH=$PATH:~fcm/bin

# Ensure .bashrc is sourced in login shells
# (only add this if it is not already done in your .bash_profile)
[[ -f ~/.bashrc ]] && . ~/.bashrc

Add the following to the end of your .bashrc file if missing:

[[ $- != *i* ]] && return # Stop here if not running interactively
[[ $HOSTNAME = "exvmsrose.monsoon-metoffice.co.uk" ]] && . mosrs-setup-gpg-agent
# Enable bash completion for Rose commands
[[ -f ~fcm/rose/etc/rose-bash-completion ]] && . ~fcm/rose/etc/rose-bash-completion

Exit MONSooN:

[<MONSooNUSERNAME>@exvmsrose:~]$ exit
#logout
#Connection to exvmsrose closed.
[<MONSooNUSERNAME>@exvmslander:~]$ exit
#logout
#Connection to lander.monsoon-metoffice.co.uk closed.

Post First time access

$ ssh <MONSooNUSERNAME>@lander.monsoon-metoffice.co.uk
WARNING:
This computer is provided for the processing of official information.
Unauthorised access described in Met Office SyOps may constitute a criminal offence.
All activity on the system is liable to monitoring.

#Now enter your PIN followed by the PASSCODE and press the enter key after the following request.

Enter PASSCODE:####(####)######
Last login: Mon Apr  3 05:01:07 2017 from 79.74.134.108
==============================================================================
Latest news and information regarding MONSooN can always be found at
http://collab.metoffice.gov.uk/twiki/bin/view/Support/LatestNews
                                     AJ Watling, MONSooN Tech Lead  7/10/2015
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
*** REMINDER - MONSooN Cutover *TODAY* 14th March                         ****
Please do not use Monsoon until notified via Newsgroups/Yammer/TWiki.
http://collab.metoffice.gov.uk/twiki/bin/view/Support/Monsoon2Migration
Many thanks - AJ Watling
#++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

[<MONSooNUSERNAME>@exvmslander:~]$ ssh -Y exvmsrose
WARNING:
This computer is provided for the processing of official information.
Unauthorised access described in Met Office SyOps may constitute a criminal offence.
All activity on the system is liable to monitoring.
Last login: Mon Apr  3 05:01:44 2017 from 10.168.6.1

#Enter your MOSRS password at the prompt and press enter.

Met Office Science Repository Service password:MOSRSPASSWORD
Subversion password cached
https://code.metoffice.gov.uk/rosie/u/hello: Hello <MOSRSUSERNAME>
Rosie password cached
[<MONSooNUSERNAME>@exvmsrose:~]$

Internal HQ Desktop Access

Your .ssh/config file should have been setup by the MONSooN team. Please email JULES-Support are having issues.

ssh to MONSooN:
```
$ ssh -Y xcsc
```

Add the following to the top of your .bash_profile file if missing on your first ever access to MONSooN:

# Provide access to FCM, Rose and Cylc
PATH=$PATH:~fcm/bin

# Ensure .bashrc is sourced in login shells
# (only add this if it is not already done in your .bash_profile)
[[ -f ~/.bashrc ]] && . ~/.bashrc

Add the following to the end of your .bashrc file if missing on your first ever access to MONSooN:

[[ $- != *i* ]] && return # Stop here if not running interactively
[[ $HOSTNAME = "exvmsrose.monsoon-metoffice.co.uk" ]] && . mosrs-setup-gpg-agent
# Enable bash completion for Rose commands
[[ -f ~fcm/rose/etc/rose-bash-completion ]] && . ~fcm/rose/etc/rose-bash-completion

ssh to the cylc server:

$ ssh -Y exvmsrose
WARNING:
This computer is provided for the processing of official information.
Unauthorised access described in Met Office SyOps may constitute a criminal offence.
All activity on the system is liable to monitoring.
Last login: Tue Mar 28 07:31:38 2017 from ##.###.##.##
Met Office Science Repository Service password:
First time use: enter your password again
Authentication realm: <https://code.metoffice.gov.uk:443> Met Office Code
Password for '<MOSRSUSERNAME>': <MOSRSPASSWORD>

Subversion password cached
https://code.metoffice.gov.uk/rosie/u/hello: Hello <MOSRSUSERNAME>
Rosie password cached

General Access Setup

There are a few setup things that everyone needs to check and update as required.

The ~/.subversion/servers file on MONSooN must contain the following:

  
[groups]
metofficesharedrepos = code*.metoffice.gov.uk

[metofficesharedrepos]
# Specify your Science Repository Service user name here
username = <MOSRSUSERNAME>
store-plaintext-passwords = no

The command rose config should include the following line in the [rosie-id] section:

[rosie-id]
......
prefixes-ws-default=u

If not then please add it to your .metomi/rose.conf file.

Simple Access to MONSooN

IN PROGRESS - full guidance is in progress for the new MONSooN, MONSooN2. Go live was March 2017, please be patient while I am working with the MONSooN team to provide simple access instructions for running JULES on MONSooN.
UPDATE: there is a developers group for testing code changes, Douglas Clark is a PI. However, at present there is still no JULES suites group for running Science, but it is being investigated (July 2017).

MONSooN Mac Advice

For running JULES-Rose on MONSooN via Mac OS please make sure you have an X11 emulator installed on the Mac.
Download and install the following package: XQuartz
Restart your Mac.
Re-loggin into lander and exvmsrose using the -Y option, Rose and Cylc GUI's should now work.

MONSooN advice