| 22 | |
| 23 | === Switching versions of Rose/cylc for a running suite === |
| 24 | |
| 25 | First you need to stop the suite via the GUI or with: `cylc stop --name=SUITE`, where `SUITE` is the suite name. If the cylc version in your enviornment is different to the one the suite is using you may need to set the cylc version prior to running the command `CYLC_VERSION=xx cylc stop SUITE`. |
| 26 | |
| 27 | Wait for the suite to complete cleanly: |
| 28 | * Look at the end of `~/cylc-run/SUITE/log/suite/log`, which should tell you the suite is shutting down with a reason. |
| 29 | * Look at the end of `~/cylc-run/SUITE/log/suite/out`, which should say `DONE`. |
| 30 | |
| 31 | Modify the `CYLC_VERSION` and `ROSE_VERSION` variables in `~/cylc-run/SUITE/log/rose-suite-run.conf`. |
| 32 | |
| 33 | Ensure the Cylc and Rose versions in your current environment match the version you are trying to use. Run `rose -V` and `cylc -v` (or `cylc -V` for newer versions). |
| 34 | |
| 35 | Then restart the suite with: `rose suite-restart --name=SUITE`. (Note you should not run `rose suite-run --restart`). |