Running a Regional LFRic Workflow

Once your suite has been set up, you can run it using Cylc.

Navigate to your suite directory

Open a terminal and move to the suite directory:

Met Office

cd ~/roses/u-by395

Monsoon

See also

For help choosing the correct Monsoon3 service and finding the official setup guidance, see Using Monsoon3.

cd ~/roses/u-by395/u-by395_lfric_monsoon3

Run the workflow

Start the workflow using:

cylc vip

This command performs three actions:

• Verify: Checks the suite configuration for errors

• Install: Sets up the runtime environment

• Play: Starts executing the workflow

Monitor the workflow

Once the suite is running, you can monitor its progress using either of the following commands:

Running graphical applications over SSH

If you are connected to a remote system over SSH, graphical applications need X11 forwarding to display on your computer. Start an X server on your computer first (for example, XQuartz on macOS), then connect from a terminal using generic host details supplied by your service:

$ ssh -AY <remote-host>

Repeat the options for every additional SSH hop. The -Y option enables trusted X11 forwarding. The -A option forwards your SSH authentication agent and should only be used with systems you trust. A terminal integrated into an editor such as VS Code works in the same way as any other terminal.

On the system where you will start the graphical application, run echo "$DISPLAY". It should return a value. If it is blank, disconnect and reconnect with X11 forwarding enabled at every hop before continuing.

• Graphical interface:

  cylc gui
  

• Terminal-based interface:

  cylc tui
  

These tools allow you to view task status, progress, and any failures.

For more details on Cylc commands, see the section “Running a Rose workflow” under “Exercises in Global Configurations” in this tutorial.

After the workflow has completed successfully, navigate to the output directory and try plotting the data.