Maia Foundation runner updates🔗
From time to time, to provide access to new Maia features, Matillion will issue an updated version of Maia Foundation runner software. New versions may also include bug fixes and security hotfixes. The Matillion-hosted Full SaaS Maia Foundation runner will always use the latest available Maia Foundation runner version. If you deploy a Hybrid SaaS Maia Foundation runner in your own infrastructure, however, you have control over how and when you update the Maia Foundation runner.
Warning
Matillion will not be able to guarantee support for older Maia Foundation runner versions, therefore we recommend that you always run the most recent Maia Foundation runner version which has been released on your version track. Version tracks are discussed below. Read Software updates and patch management for details of our support policy.
Version tracks🔗
The Maia Foundation runner update cadence depends on whether you chose the Current or Stable version track when you created the Maia Foundation runner. Read Maia Foundation runner version tracks for a full discussion of version tracks.
If you have auto update enabled, your Maia Foundation runner will be automatically updated to the latest version on your chosen version track as soon as it's available. Without this option enabled, you will have to manually update to the new version.
Critical security patches are only applied to the supported Maia Foundation runner releases on both tracks.
Release cadence🔗
Maia Foundation runner releases are made on the following cadence:
- Current track: Usually twice a week, typically on a Tuesday and Thursday, though this may vary. These releases may include new features, bug fixes, and security patches.
- Stable track: Once per month, on the 1st of the month.
- The Maia Foundation runner for Snowflake is updated once per month on the second Tuesday of the month.
If you need to change the track that an existing Maia Foundation runner is on, you can use the Update a Maia Foundation runner public API endpoint. However, take note of the following:
- Changing the Maia Foundation runner's version track does not update the Maia Foundation runner itself. You must update the image URI for the Maia Foundation runner service in your cloud provider. If you don't, the Maia Foundation runner version may show as "Out of support".
- If you change the Maia Foundation runner state from Current to Stable and update the installed Maia Foundation runner service, pipelines created using a newer (Current) Maia Foundation runner version might not run as expected on an older (Stable) version.
Auto update🔗
By default, Maia Foundation runners are created to automatically update. However, you can opt out of this process.
Note
If you opt out of automatic updates, ensure you have a manual update procedure in place. Read our Maia Foundation runner support policy. If you are using the Current track and wish to opt out then it may be prudent to use the Stable track instead due to the faster update cadence of the Current track.
The standard Maia Foundation runner installation uses a tagged container image on the container respository. This tag is always kept on the most recent released image for a given version track. If the Maia Foundation runner installation in your cloud infrastructure is set to always pull the latest version, then whenever a Maia Foundation runner instance is started, it will always pull this latest version. This means that whenever you restart a Maia Foundation runner, it will be automatically updated to the latest release on its version track, regardless of whether auto update is enabled or not.
If your Maia Foundation runner has multiple instances, and one instance happens to be on a later version than another due to the timing of restarts, then the reported version of the Maia Foundation runner will always be the lowest version of any instance, and the availability of Maia features will be linked to that lowest version.
If a Maia Foundation runner has auto update enabled, then whenever a new version is released on its version track (Current or Stable), the Maia Foundation runner will be automatically updated to that version. You can change a Maia Foundation runner's auto update status at any time from the Maia Foundation runner details screen.
The auto update process will issue a graceful shutdown command to the Maia Foundation runner when a new version becomes available. This allows the Maia Foundation runner to finish the task it's working on before shutting itself down. The Maia Foundation runner will then restart, and as part of the restart process will automatically update to the latest available version of the Maia Foundation runner.
If auto update is not enabled, you will be notified when a new version is released, and must manually update the Maia Foundation runner.
If a Maia Foundation runner falls behind the latest release on the version track because you have disabled auto update, and you then enable auto update, it will not immediately update itself to the latest available version. The Maia Foundation runner update will only be triggered when the next version is released on its version track, or if the Maia Foundation runner is restarted for any reason, in which case it will always update to the latest available version.
Snowflake🔗
For update information about Hybrid SaaS Maia Foundation runners installed in Snowflake using the Native App, read Updating Maia Foundation runners section.
Manual update🔗
If you haven't enabled auto update, you will need to check whether a new Maia Foundation runner version is available on your version track. In the list of Maia Foundation runners, the text Update Available is displayed below the Maia Foundation runner version number if a new version is available. Additionally, the latest available version number, version release date, and an update notification will be shown on the Maia Foundation runner details screen.
To update the Maia Foundation runner manually, follow the process given in Restart a Maia Foundation runner. Restarting the Maia Foundation runner automatically updates it to the latest release on its version track, as long as the installed Maia Foundation runner is always pulling the latest image. If your Maia Foundation runner service isn't configured to pull a new image on restart, you should use the pause Maia Foundation runner command to put your Maia Foundation runner into a safe state where it can be restarted manually from your cloud provider.
You can also update the Maia Foundation runner from the agents API endpoint. The endpoint can also be used to determine whether a new Maia Foundation runner version is available. For further details on using the Maia API, read API overview.