Run Page
Learning Outcomes
- How to access the run page for a project
- Understanding the key components in the run page header
- Recognizing run status messages and their meanings
Basics
Accessing the run page
To access the run page either:
-
Navigate to your project and choose a run from the "Runs" tab
-
On the Activity page, click a recent run.
Navigating Run page
The header of the run page displays four tabs:
- Run Settings Configure the environment, inputs, and parameters for your pipeline run.
- Advanced Customize resource allocation and executor settings for processes within the run.
- Logs Monitor real-time status, progress, and troubleshooting logs during the run.
- Reports Access detailed outputs, metrics, and visualizations generated by the run.
The icons for Save Run, Run Status and Run options are conveniently located next to the information displayed in the header.
Run Status
The status of your current run is shown on the far right of the run page header. Initially, you will see an orange Waiting button. To initiate a run, ensure that you have entered the following data:
- Run Environment: Select the environment where you would like to conduct your run.
- Work Directory: Provide the full path to the execution directory.
- Inputs: Specify the various values and files that define the data to be processed and how it will be processed (e.g., single-end vs. paired-end data). For additional details, see the section on Datasets.
Below is a table outlining the possible status messages you may encounter:
| Status | Meaning |
|---|---|
| Waiting | Waiting for inputs, output directory, and selection of the active run environment |
| Ready | Ready to initiate the run |
| Connecting | Sending SSH queries to the selected host system |
| Initializing | Job is submitted and waiting for execution |
| Running | Nextflow is executing the jobs |
| Completed | The job has been completed |
| Run Error | An error occurred before submission or during execution of the jobs |
| Terminated | The user terminated the run using the Terminate Run button |
Run Settings
The Run Settings section on the Run Page in Via Foundry 2.0 enables users to customize their runs configuration. This section covers the following functionalities:
- Run Description: Provide a descriptive summary of your run. This helps maintain clarity and context for later reference.
- Run Environment Selection: Choose the desired Run Environment where the process will execute.
Run Environments
Usually, your run environment is already established. If not, refer to Environments Settings for next steps.
Run Inputs
The Inputs section of the Run Page in enables users to configure essential data and parameters for executing a pipeline. Customize this section for the desired analysis or task.