Standard Suites#

UM Standard Suites#

For the UM the following Suites must be updated:

First get a copy of the UM meta trunk, fcm co fcm:um_meta.x_tr /path/to/meta/trunk. Similarly, get a copy of Jules at the most recent release. Then upgrade each suite by doing the following,

  • Checkout the suite. rosie checkout u-xxNNN will put a copy in ~/roses.

  • Check whether the access-list in the rose-suite.conf needs updating - if you are not on it, ask someone to add you now and update your copy once done.

  • Move into the suite and edit the rose-suite.conf file,

    • If it has a VN setting, update it to the new version.

    • If it has a prebuild path, update that now. If there are prebuilds, check the flow.cylc for any prebuild path overrides. These exist particularly on the EXs.

  • Validate the existing apps by running,

    rose macro --fix -C app/APP
    

    where APP should be replaced by each available app in turn. It should report that 0 changes were made.

  • Now upgrade the apps to the new version, using the metadata trunk checked out earlier. Again, replace APP with each app in turn. This will prompt you to confirm while running.

    rose app-upgrade -C app/APP -M /path/to/the/meta/trunk vnX.Y
    
  • Finally run the validator macros. If everything is fine the command will report nothing, however the SCM suite will raise some warnings about Openmp and “global rows” - these can be ignored.

    rose macro metomi.rose.macros.DefaultValidators -M /path/to/the/meta/trunk:/path/to/the/jules/hot/rose-meta
    
  • Check that the changes look sensible and then run the suite,

    fcm diff -g
    cylc vip
    
  • Once the suite has succeeded, commit the changes (fcm ci) with a suitable message and note the revision it was committed at. Then tag the suite and commit the tag,

    fcm pe fcm:revision .
    <add tag to resulting editor>
    fcm ci
    

LFRic Apps Standard Suites#

For LFRic Apps the following Suites must be updated:

For each suite, do the following:

  • Get a copy of each of these suites and move into the working copy.

    rosie co u-dn704
    cd ~/roses/u-dn704
    
  • In rose-suite.conf update the version number

  • Upgrade the metadata for the mesh and lfric_atm apps

    rose app-upgrade -a -y -C app/lfric_atm vnX.Y
    rose app-upgrade -a -y -C app/mesh vnX.Y
    
  • Check the modules loaded in the flow.cylc for any changes vs. the Apps trunk.

    • See rose-stem/site/meto/common/suite_config_PLATFORM.cylc

    • The lfric software stack moves more quickly than the UM, so it is more likely these have changed.

  • Test - cylc vip

  • Commit and Tag the suite once the test suite has succeeded.