Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/dictionaries/words
Original file line number Diff line number Diff line change
Expand Up @@ -148,9 +148,9 @@ reconfiguring
refactor
regex
reimplement
reimplements
reimplementation
reimplemented
reimplements
reinstallation
reinstalls
replier
Expand Down
3 changes: 2 additions & 1 deletion src/glossary.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1030,7 +1030,8 @@ Glossary
the :term:`initial cycle point`.

To satisfy unbounded :term:`intercycle dependence` in the graph, tasks
prior to the start cycle point are treated as if they have succeeded.
prior to the start cycle point are treated as if they have succeeded
(in :term:`flow` 1).

.. seealso::

Expand Down
39 changes: 39 additions & 0 deletions src/user-guide/interventions/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,13 @@ Re-Run Multiple Tasks
> //<cycle-2>/<task-2> \
> ...

.. admonition:: Workflow design tip
:class: tip

If there is a group of tasks that might often need to be re-run together,
consider grouping them into a :term:`family` so that you can easily trigger them
all at once using the family name.


.. _interventions.reflow:

Expand Down Expand Up @@ -615,3 +622,35 @@ Remove Tasks
.. code-block:: console

cylc remove <workflow>//<cycle>/<id>


Run tasks at the initial cycle point after a warm start
-------------------------------------------------------

.. versionchanged:: 8.6.2

This did not work properly in prior versions of Cylc 8.

:Example:
I started the workflow using a :term:`start cycle point` greater than
the :term:`initial cycle point` (a.k.a. a :term:`warm start`).
Now I want to run some tasks at a cycle before the start cycle point.
e.g. a family of setup tasks that only exist at the initial cycle point.

:Solution:
Trigger the desired tasks at the earlier cycle point.
See :ref:`interventions.re-run-multiple-tasks`.
All other tasks at cycles before the start cycle point are treated as already complete
(in :term:`flow` 1), so only the triggered tasks will run.

.. tip::

The ``^`` character can be used as a shorthand for the initial cycle point
in the GUI and CLI.

.. warning::

If the workflow shuts down while the group of tasks that you triggered
is still in progress, then on restart, Cylc will not remember what tasks
were still left to run in that group. You will need to trigger the remaining
tasks again.
Loading