Standard Suites#

UM Standard Suites#

For the UM the following Suites must be updated:

UM Azspice - u-aa003
UM EX1A - u-ci752
SCM - u-aa741
CreateBC - u-aa258

Ensure you have a fork of both the um_meta and jules repositories, and that the stable branches in each are up to date with the upstream repository.

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 main 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/um_meta/clone 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/um_meta/clone/main: /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:

LFRic Apps Azspice - u-dn674
LFRic Apps EX1A - u-dn704

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 main.
- 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.