Version 42 (modified by ros, 17 months ago) (diff)


To view suites on puma:
For suite output:

For some useful tips: RoseCylc/Hints

UM Rose tutorial

The Met Office tutorial is available on the Met Office Science Repository Service:

There is also an alternative user guide which some might find useful:

Most of this will work with any UM suite, but for a simple test use:

  • Archer: u-aa774
  • MONSooN: u-aa345

Note that these suites will be kept up to date with the latest UM version (currently 10.3).

If you have not done so already, you will need to follow the set up instructions below.

Set up

MOSRS account and caching

To run UM10.x (and to use the roses-u repository) you will first need an account on the Met Office shared repository service (MOSRS). Please contact cms-support AT to arrange this.

Some setup is then required to access the remote repository on puma (for submission to Archer) or MONSooN. This is detailed here:. (Note you need to log in with your MOSRS account to see this)

Then follow the link on "how to cache your password":

This is a little complicated so be sure to follow the instructions carefully.

If you are running on MONSooN

Rose suites on MONSooN are submitted from a Rose virtual machine (not puma).

Follow these instructions:

You may also need to follow these additional steps if you find you get an error submitting your first Rose job: RoseCylc/Hints#Unabletosubmitjobs

Note: there is currently an issue with Rose bush and it does not work.

If you are running on Archer

On Archer, rose suites are submitted from puma as with UMUI jobs.

Puma set up

The correct paths on puma are now set up by default, so you no longer need to have anything in your .profile to load Rose, Cylc or FCM. If you have anything from previously this should be removed.

For UM jobs the variable $UMDIR needs to be set but it doesn't matter what to! Add the following to your .profile:

export UMDIR=/home/um

For Rose to work properly, the ssh-agent needs to be running on puma and not forwarded from elsewhere. Otherwise when logging out of puma, the agent will not persist and polling between puma and archer will not work. To set up ssh-keys from puma to Archer see:

Archer set up

First ensure that UMDIR and DATADIR are defined in your environment (try echo $UMDIR; echo $DATADIR).

  • Non-UM users should add:
    export UMDIR=/work/y07/y07/umshared
    export DATADIR=/work/n01/n01/<add-username>   # Set to your work space

All users need the following lines:

module use $UMDIR/modules
module load cylc 
module load fcm
module load rose

Syntax highlighting

This is really useful if you are going to edit the Rose and cylc configuration files directly (i.e. not through the GUI). For instructions see:


Cylc user guide (including example suites):

Rose user guide (including tutorial exercises):