Rose is a framework for managing and running control suites (in our case, specifically JULES control suites / cylc workflows).
For general information on Rose and Cylc as used in the UK's UM/Momentum system, see here. Official Rose tutorials are at Rose tutorials
rose --version
If Rose has already been installed on your system, this will give you a version number (a date); otherwise it'll say "command not found".
Install using these commands from a bash terminal:
cd ~/.local
git clone https://github.com/metomi/rose.git
cd rose
git tag -l
#Install the latest version available on that list that has a valid date as its version name, e.g.:
git checkout tags/2019.01.8
cd ~
You need to configure Rose before you can use it, which involves generating files at ~/.metomi/rose.conf (in your profile) and at ~/.local/rose/etc/rose.conf (in the Rose installation):
mkdir ~/.metomi
Next, create a textfile ~/.metomi/rose.conf containing this text (but substituting your username instead of tobymarthews and whatever your SITE is instead of jasmin (if you will be engaging in Rose stem testing **)):
[rosie-id]
prefix-default=u
prefix-location.u=https://code.metoffice.gov.uk/svn/roses-u
prefix-username.u=tobymarthews
prefix-ws.u=https://code.metoffice.gov.uk/rosie/u
[rose-stem]
automatic-options=SITE=jasmin
** Omit the [rose-stem] bit if you will not be using Rose stem testing (it is only necessary for code development). Just for information, the SITE setting can (currently) be one of meto, vm, cehwl1, jasmin, niwa or nci (i.e. a selection of UK Met Office internal and UM partners) and tells the system where essential KGO files are stored on those systems ('Known Good Output'), however if you are not engaging in Rose stem testing then you don't need those files and therefore don't need that rose-stem bit.
Now you need to append the Rose command set to your library. This must be done every time you log on, so best to add the following line to the end of your ~/.bashrc file to accomplish this:
export PATH=$HOME/.local/rose/bin:$PATH
chmod -R 755 ~/.local
Run your .bashrc file (or log off and log in again):
. ~/.bashrc
Check the Rose installation and server links. Putting in your MOSRS password should give you a hello back from the MetO server:
rosie hello
(if you get anything like "hello: {}" then check you've done step 2b correctly). For example, my hello back message is "https://code.metoffice.gov.uk/rosie/u/hello: Hello tobymarthews".
All done: Rose should be installed (typing ROSE_EXEC=$(which rose);echo $ROSE_EXEC will tell you where it is installed, if you are interested). By the way, don't use "rose check-software": it seems to check far too wide a set of components (e.g. for me on Jasmin it says "Result: FAIL" for several sections, while in reality all the essential components for JULES are indeed correctly installed).
If you have a PUMA account, you can add the following to .metomi/rose.conf as well (after prefix-username.u; substituting your PUMA username instead of tobymarthews):
prefix-username.puma=tobymarthews
and add the following to the file in step 2b:
prefix-location.puma=svn://puma.nerc.ac.uk/roses_puma_svn
prefix-web.puma=https://puma.nerc.ac.uk/trac/roses_puma/intertrac/source:
prefix-ws.puma=http://puma.nerc.ac.uk/rosie/puma
There are lots of other options you can insert into the Rose configuration, by the way (see here for examples): this is a minimal file to get it going. Specifically, however, please do NOT insert anything like “meta-path=...” into ~/.local/rose/etc/rose.conf because this only causes confusion (it's overridden by the meta data specification in your JULES namelists anyway so has no effect).