Version 35 (modified by annette, 4 years ago) (diff)


To view suites on puma:
For suite output:

For some useful tips: RoseCylc/Hints

Troubleshooting of common errors: RoseCylc/Troubleshooting?


Cylc user guide (including example suites):

Rose user guide (including tutorial exercises):

Getting started

UM 10.x

To run UM10.x you will first need an account on the Met Office shared repository service (MOSRS). Please contact ncas-umsupport@… 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":


Note: The correct paths are now set up by default, so you no longer need to have anything in your .profile to load Rose, Cylc or FCM.

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


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/Troubleshooting#Unabletosubmitjobs?

Note: to view suite logs on exvmsrose run:

firefox http://localhost:8080


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

For Rose on archer 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:

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:

UM Rose tutorial

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

Most of this will work with any UM suite, try for example puma-aa125.