Skip to main content
You might need to restart your Maia runner from time to time for any of the following reasons:
  • Maia runners can sometimes crash or become unstable.
  • You changed the Maia runner‘s configuration.
  • You added a new certificate to be used for setting up a proxy server.
  • You added new Python libraries.
  • You added new third-party drivers.
  • To receive Maia runner updates.
This is only available for Hybrid Maia runners.

​
Prerequisites

To restart a Maia runner from the Runners list in Maia, you must have the Manage runners service enabled for your user account.
There is no granular “restart Maia runner only” permission. Users who need to restart Maia runners must have full Manage runners access. Alternatively, users with appropriate permissions in your Maia runner provider (AWS, Azure, Google Cloud, or Snowflake) can restart Maia runners directly from the Maia runner provider console without requiring Manage runners access in Maia.

​
How to restart your Maia runner

You can restart your Maia runner in one of two ways:
  • From the Maia runners screen in Maia.
  • From the cloud provider’s control panel:
    A changed Maia runner deployment configuration may require a restart of the cloud provider service to take effect.
Read Pause a Maia runner for an alternative way of managing Maia runners that need restarting.

​
Restart from the Maia runner screen

  1. In the left navigation, click . Then, select Runners from the menu.
  2. Locate the Maia runner you want to restart and click the three dots ….
  3. Click Restart runner.
  4. Click Yes restart to confirm.
This feature takes advantage of how a cloud provider will manage an installed Maia runner service by ensuring that the required amount of Maia runner instances (tasks/pods, depending on your deployment) are always started if any drop. The Restart runner option sends a graceful shutdown request to all the instances (tasks/pods) contained within the Maia runner service on the cloud provider. Each instance will complete any pipeline tasks currently in progress, or wait for any open transactions to complete, and then shut itself down. The Maia runner service will then start up new, replacement instances. Running pipelines will continue as normal. Any pipeline tasks that are sent to a Maia runner that’s currently restarting will be queued until the new service is back up and running. Your pipelines will be unaffected, though they may take a few minutes longer than normally expected for execution to complete. Assuming that there are no running tasks, it usually takes a few minutes for a Maia runner instance to shut down and a new instance to start back up. If you have multiple instances and one is working on a longer pipeline task or currently has an open transaction, then the other restarted Maia runner instances will take on any new pipeline tasks.

​
Restart an AWS ECS Fargate Maia runner

You will need access to your AWS account with the appropriate permissions. To restart your AWS Maia runner, follow these steps:
  1. Log in to the AWS console.
  2. In the AWS console, type Elastic Container Service in the search bar, and select that service.
  3. Locate the ECS service running your Maia runner, and click Update service.
  4. Select the latest task definition and click Update.

​
Restart an Azure Maia runner

You will need access to your Azure account with the appropriate permissions. There are two ways you can restart an Azure Maia runner:
  • The Azure Portal
  • The Azure CLI

​
Using the Azure Portal

To restart your Maia runner using the Azure Portal, follow these steps:
  1. Log in to the Azure Portal.
  2. In the search bar at the top of the Azure Portal, enter “Container apps”, and click the Container Apps link in the results menu.
  3. Click your chosen container app from the list.
  4. Click Application to display a context menu.
  5. Click Revisions and replicas.
  6. Click on the name of the intended Active Revision.
  7. A panel to the right will appear. At the top of Revision details, click Restart.

​
Using the Azure CLI

To restart your Maia runner, you can open the Azure CLI either locally on your machine, or through the Azure portal. Use the following command:
For example, if you have a Maia runner called cloud-runner-dev in a resource group called cloud-runner-dev, and your Azure subscription is called Matillion Dev, you are required to use the following command:

​
Restart a GKE Maia runner

You will need access to your Google Cloud account with the appropriate permissions, and kubectl configured for your GKE cluster. To restart your GKE Maia runner, run the following command, replacing RELEASE_NAME and NAMESPACE with the Helm release name and Kubernetes namespace used during deployment (both default to matillion-agent):
Kubernetes will perform a rolling restart, bringing up new pods before terminating the old ones. Running pipelines will continue as normal — any tasks sent to the Maia runner during the rollout will be queued until the new pods are ready.

​
Restart a Snowflake Maia runner

You can restart the Maia runner by suspending and resuming the compute pool from within Snowflake. Suspending the compute pool will prevent the Maia runner from being used by Maia, and will stop all running tasks. Resuming the compute pool will make the Maia runner available for use again.
  1. From your Snowflake Home screen, click Data Products → Apps. You must be using the role that originally installed the application.
  2. Locate Matillion Data Productivity Cloud in the list of apps, and click to select it. If you have multiple installs of the Native App, select the one you wish to restart.
  3. Click the Control Panel tab.
  4. Click Suspend Compute Pool, then click Suspend to confirm. This will put the pool into a Stopping state and change the Maia runner status to Suspending.
    This will suspend the compute pool and all Maia runner instances that it supports. This will stay suspended until you actively click Resume Compute Pool.
  5. Wait for the Maia runner to stop. This may take a few minutes.
  6. When the Maia runner is in a Suspended state, click Resume Compute Pool. This will put the pool into a Starting state and change the Maia runner status to Pending.
  7. Wait for the Maia runner to start. This may take a few minutes.
    After the compute pool changes to an Active state, the Maia runner status may remain as Pending for a few minutes before changing to Running.