Useful information for running with Rose

Switching versions of Rose and/or cylc

• On puma and MONSooN export the variables: CYLC_VERSION=x.y.z and ROSE_VERSION=YYYY.MM.DD
• On Archer use module switch command. It is advisable to use the same versions of Rose and Cylc on puma and Archer.

Viewing the suite run graph without running

When developing suites, it can be useful to check what the run graph looks like after jinja evaluation etc. To do this without running the suite:

rose suite-run -i --name=puma-aa045  # install suite in cylc db only
cylc graph puma-aa045                # view graph in browser       

To just view the dependencies on the command line:

cylc ls -t puma-aa045

Setting the default size of the rose edit window

Setting the default size of the rose edit window and the width of the rose edit left hand menu pane can be very helpful.

Edit ~/.metomi/rose.conf

Adding the following information to the file sets the default size and width of the rose config-edit (rose edit) window:

[rose-config-edit]
SIZE_WINDOW = (1100, 650)
WIDTH_TREE_PANEL = 400

For details of further customisations that can be made to the rose edit window see: ​http://metomi.github.io/rose/doc/rose-rug-config-edit.html#customisation

Launching Rose commands

It is possible to launch many of the Rose tools from the various GUIs. For example you can run or edit suites from rosie go, run suites from rose edit, and view log files from rose suite-gcontrol whilst the suite is running.

When running rose from the command line make sure to run from the appropriate roses/ directory or append the suite name using --name=puma-aa045, e.g.

rose suite-shutdown --name puma-aa015

Stop archiving of log files

By default, when a suite is run, the log files from the previous run will be tarred up. To avoid this run rose suite-run with the flag --no-log-archive.

Diff'ing suites

There is no formal mechanism for this as yet. But there is a tool rose config-dump which sort all of the app files in the suite into a common format, which then allows for diff to be run on the command-line between suite files. For more info see: ​http://metomi.github.io/rose/doc/rose-command.html#rose-config-dump

Adding UM user diagnostics

This works in a different way to the old UMUI and no longer uses user-STASHmaster files.

Instead the STASHmaster file is held in the UM trunk. To make changes, place your modified version in the file/ subdirectory of the app, e.g:

~roses/puma-aa045/app/um/file/STASHmaster

Passing arguments to fcm_make

Rose deals with fcm_make as a special app, see: ​http://metomi.github.io/rose/doc/rose-rug-task-run.html#rose-task-run.built-in-app.fcm_make

To pass arguments, such as -vvv for full verbose output:

• Set the environment variable ROSE_TASK_OPTIONS=-vvv
• Or add args=-vvv at the top of the fcm_make rose-app.conf file.