Pause a Maia Foundation runner

Agent Type:

Maia Hybrid

Agent Platform:

AWS ✅ Azure ✅ Snowflake ✅ Matillion ✅

There are times when you need to perform maintenance work on a Maia Foundation runner, such as upgrading the version or updating the configuration to add new drivers, but you have running pipelines that you can't allow to fail. In these cases, you can pause the Maia Foundation runner, which gracefully puts it into a safe state to be worked on.

Pausing a Maia Foundation runner will allow it to finish outstanding pipeline tasks before entering a Paused state. Any running or submitted pipelines destined for the Maia Foundation runner during this Paused state will still be shown as active, and any new tasks from those pipelines will be safely queued until the Maia Foundation runner is resumed after the Paused state.

While the Maia Foundation runner is paused, Maia users can continue to interact with the pipeline canvas in Designer.

---

Pausing a Maia Foundation runner

1. On the Agents page, locate the Maia Foundation runner you want to pause and click the three dots ....
2. Click Pause agent.
3. Type pause agent in the dialog, to confirm you understand the implications of the action, and then click Pause Agent again.

When paused, the Maia Foundation runner first enters a Pausing state, during which it will complete any pipeline tasks it's currently executing. Once those tasks are completed, it moves to a Paused state and any queued tasks will be held in the queue until the Maia Foundation runner is resumed.

If tasks are executing within a Transaction, the entire transaction will complete before the Maia Foundation runner enters a Paused state.

Note

To be clear: it is individual tasks in progess that are completed, not the entire running pipeline. The pipeline will not progress any further until the Maia Foundation runner resumes and its remaining queued tasks can be executed. The pipeline duration shown in the Pipeline run history will include any time that the pipeline spent waiting for a paused Maia Foundation runner to resume.

---

Restarting a paused Maia Foundation runner

When paused, the Maia Foundation runner can be safely restarted on the cloud provider, as described in Restart an AWS ECS Fargate Maia Foundation runner or Restart an Azure Maia Foundation runner.

Note

When a paused Maia Foundation runner is restarted on the cloud provider, the Maia Foundation runner status will remain Paused until the queue automatically resumes or you manually resume the Maia Foundation runner, as described below.

---

Resuming a paused Maia Foundation runner

1. On the Agents page, locate the Maia Foundation runner you want to resume and click the three dots ....
2. Click Resume agent.
3. Click Yes resume to confirm.

If a Maia Foundation runner is left in a Paused state for 12 hours, it will automatically resume.

A resumed Maia Foundation runner's status will be as follows:

• If the Maia Foundation runner is actively connected and available, the resumed Maia Foundation runner status will be Running and it will begin to execute queued tasks.
• If the Maia Foundation runner was stopped during the pause and was never restarted, the resumed Maia Foundation runner status will be Stopped.
• If the Maia Foundation runner was taken offline, not gracefully stopped during the pause, and never restarted, the resumed Maia Foundation runner status will be Unknown.

If a resumed Maia Foundation runner is not in a running state, then any pipelines that had tasks queued during the pause will timeout after 15 minutes of the Maia Foundation runner resuming, and the pipelines affected will be updated accordingly.