From 9ea73e30ccfe9447331d07c1e135e1c32c25f588 Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 24 Jun 2026 03:10:22 +0000 Subject: [PATCH 1/8] docs(upgrade): add Prerequisites with plugin dependencies and Important Notes The operator-level Upgrade page went straight into the MySQL-PXC migration checklist without stating the foundational plugin dependencies, unlike the Kafka upgrade doc. Add a Prerequisites section with a Plugin Dependencies table and Important Notes: - Data Services Essentials (Application Services Core) v4.4.0+ - Data Services RDS Framework v4.3.x - upgrade order: base plugins before the operator - PXC-removal irreversibility and operator no-rollback callouts Point readers to the OperatorHub Upgrade prompt for plugin version deltas (the Release Notes carry no compatibility matrix). Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/en/upgrade.mdx | 35 +++++++++++++++++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/docs/en/upgrade.mdx b/docs/en/upgrade.mdx index 541a22c..c70fe1c 100644 --- a/docs/en/upgrade.mdx +++ b/docs/en/upgrade.mdx @@ -20,7 +20,38 @@ Alauda Database Service for MySQL-MGR will execute upgrades based on the configu - **Automatic** : Auto-upgrades are triggered immediately upon detecting new component versions. - **Manual** : Requires manual approval before initiating the upgrade process. -## MySQL-PXC Pre-Upgrade Checklist +## Prerequisites + +Before initiating an upgrade, ensure the following: + +1. **Plugin dependencies are upgraded first**: Alauda Database Service for MySQL builds on foundational Alauda platform and Data Services plugins. Upgrade them to a compatible version **before** upgrading the MySQL operator or rolling instances. +2. **Version compatibility**: Your current version falls within a supported upgrade path. Review the [Release Notes](./release_notes) for the target version's new features and known issues, and the OperatorHub **Upgrade** prompt for the component and plugin version changes that the upgrade applies. +3. **Component health**: All MySQL-MGR instances are in a `Running` (Ready) state before starting the upgrade. +4. **Resource availability**: The cluster has sufficient CPU, memory, and storage headroom to perform the rolling upgrade. +5. **PXC migration (if applicable)**: If the platform has any MySQL-PXC instances, complete the [MySQL-PXC Pre-Upgrade Checklist](#mysql-pxc-pre-upgrade-checklist) before upgrading to MySQL Operator v4.3.0 or later. + +### Plugin Dependencies \{#plugin-dependencies} + +Like other Alauda Container Platform Data Services plugins, MySQL-MGR depends on the shared Data Services base plugins. Upgrade them in the following order: + +| Order | Plugin | Role | Minimum Version | +|-------|--------|------|-----------------| +| 1 | **Alauda Container Platform Data Services Essentials** (also referred to as Application Services Core) | Foundational platform component that the Data Services plugins and operators build on. | **v4.4.0 or higher** | +| 2 | **Alauda Container Platform Data Services RDS Framework** | Base operator framework that the MySQL operator extends. | **v4.3.x** | +| 3 | **Alauda Database Service for MySQL** | The MySQL-MGR operator and its instances. | Target upgrade version | + +:::warning Upgrade the base plugins first +Always upgrade the **Data Services RDS Framework** to **v4.3.x** **before** upgrading the MySQL operator or rolling instances. Upgrading the MySQL operator against an older RDS Framework can leave instances in an inconsistent or unmanaged state. The OperatorHub **Upgrade** prompt lists the component and plugin version changes for the target release; see the [Install guide](./installation) for the plugin installation steps. +::: + +### Important Notes + +- **Data Services Essentials version**: Upgrading the MySQL operator requires **Alauda Container Platform Data Services Essentials (Application Services Core) v4.4.0 or higher**. Upgrade this foundational platform component to a compatible version **before** upgrading the operator. +- **Upgrade the base plugins first**: The MySQL operator depends on the Alauda Container Platform Data Services RDS Framework. Upgrade the RDS Framework to **v4.3.x** **before** upgrading the operator. See [Plugin Dependencies](#plugin-dependencies). +- **MySQL-PXC removal is irreversible**: Starting from MySQL Operator v4.3.0, MySQL-PXC is removed. PXC instances become **unmanaged** immediately after the operator upgrade and cannot be re-managed. Migrate any PXC instances to MySQL-MGR **before** upgrading to v4.3.0 or later — see the [MySQL-PXC Pre-Upgrade Checklist](#mysql-pxc-pre-upgrade-checklist). +- **Operator rollback is not supported**: Once upgraded, the MySQL operator **cannot be rolled back** to a previous version. Take a verified full backup of every instance before starting the upgrade. See [Rollback considerations](#rollback-considerations). + +## MySQL-PXC Pre-Upgrade Checklist \{#mysql-pxc-pre-upgrade-checklist} If your platform has **MySQL-PXC** instances, complete the following **before upgrading to MySQL Operator v4.3.0 or later**: @@ -175,7 +206,7 @@ If migration cannot be completed within the maintenance window: Deleting a PXC custom resource will delete all associated pods and data. Always verify data integrity on the target MGR instance before decommissioning the source PXC instance. ::: -### Rollback considerations +### Rollback considerations \{#rollback-considerations} The MySQL operator **cannot be rolled back** to a previous version after upgrade. If a critical issue occurs: From effd9b8dae02d767dd7e3cbea1a760ea1bcbd2f3 Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 24 Jun 2026 03:15:40 +0000 Subject: [PATCH 2/8] docs(upgrade): add Query Analytics operator (v4.4.0+) to plugin dependencies The query-analytics-operator (slow query logging / query analysis, optional companion to MySQL-MGR) must be upgraded to v4.4.0+ when in use. Add it to the Plugin Dependencies table and Important Notes. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/en/upgrade.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/en/upgrade.mdx b/docs/en/upgrade.mdx index c70fe1c..1f38b91 100644 --- a/docs/en/upgrade.mdx +++ b/docs/en/upgrade.mdx @@ -39,6 +39,7 @@ Like other Alauda Container Platform Data Services plugins, MySQL-MGR depends on | 1 | **Alauda Container Platform Data Services Essentials** (also referred to as Application Services Core) | Foundational platform component that the Data Services plugins and operators build on. | **v4.4.0 or higher** | | 2 | **Alauda Container Platform Data Services RDS Framework** | Base operator framework that the MySQL operator extends. | **v4.3.x** | | 3 | **Alauda Database Service for MySQL** | The MySQL-MGR operator and its instances. | Target upgrade version | +| 4 | **Query Analytics Operator** (`query-analytics-operator`) | Optional companion operator that powers slow query logging and query analysis. Only required if query analytics features are used. | **v4.4.0 or higher** | :::warning Upgrade the base plugins first Always upgrade the **Data Services RDS Framework** to **v4.3.x** **before** upgrading the MySQL operator or rolling instances. Upgrading the MySQL operator against an older RDS Framework can leave instances in an inconsistent or unmanaged state. The OperatorHub **Upgrade** prompt lists the component and plugin version changes for the target release; see the [Install guide](./installation) for the plugin installation steps. @@ -48,6 +49,7 @@ Always upgrade the **Data Services RDS Framework** to **v4.3.x** **before** upgr - **Data Services Essentials version**: Upgrading the MySQL operator requires **Alauda Container Platform Data Services Essentials (Application Services Core) v4.4.0 or higher**. Upgrade this foundational platform component to a compatible version **before** upgrading the operator. - **Upgrade the base plugins first**: The MySQL operator depends on the Alauda Container Platform Data Services RDS Framework. Upgrade the RDS Framework to **v4.3.x** **before** upgrading the operator. See [Plugin Dependencies](#plugin-dependencies). +- **Query Analytics operator version**: If you use query analytics features (slow query logging and query analysis), upgrade the **Query Analytics Operator (`query-analytics-operator`) to v4.4.0 or higher**. This operator is optional — MySQL-MGR instances function normally without it. - **MySQL-PXC removal is irreversible**: Starting from MySQL Operator v4.3.0, MySQL-PXC is removed. PXC instances become **unmanaged** immediately after the operator upgrade and cannot be re-managed. Migrate any PXC instances to MySQL-MGR **before** upgrading to v4.3.0 or later — see the [MySQL-PXC Pre-Upgrade Checklist](#mysql-pxc-pre-upgrade-checklist). - **Operator rollback is not supported**: Once upgraded, the MySQL operator **cannot be rolled back** to a previous version. Take a verified full backup of every instance before starting the upgrade. See [Rollback considerations](#rollback-considerations). From ed35b63b3f7a41ed9be579e555270930777a7f08 Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 24 Jun 2026 03:18:33 +0000 Subject: [PATCH 3/8] docs(upgrade): set MySQL operator minimum version to v4.4.0+ Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/en/upgrade.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/upgrade.mdx b/docs/en/upgrade.mdx index 1f38b91..3dbfc58 100644 --- a/docs/en/upgrade.mdx +++ b/docs/en/upgrade.mdx @@ -38,7 +38,7 @@ Like other Alauda Container Platform Data Services plugins, MySQL-MGR depends on |-------|--------|------|-----------------| | 1 | **Alauda Container Platform Data Services Essentials** (also referred to as Application Services Core) | Foundational platform component that the Data Services plugins and operators build on. | **v4.4.0 or higher** | | 2 | **Alauda Container Platform Data Services RDS Framework** | Base operator framework that the MySQL operator extends. | **v4.3.x** | -| 3 | **Alauda Database Service for MySQL** | The MySQL-MGR operator and its instances. | Target upgrade version | +| 3 | **Alauda Database Service for MySQL** | The MySQL-MGR operator and its instances. | **v4.4.0 or higher** | | 4 | **Query Analytics Operator** (`query-analytics-operator`) | Optional companion operator that powers slow query logging and query analysis. Only required if query analytics features are used. | **v4.4.0 or higher** | :::warning Upgrade the base plugins first From be2a4253e583545bfa4572d10547ddfcb6d44ae9 Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 24 Jun 2026 03:22:15 +0000 Subject: [PATCH 4/8] docs(upgrade): scope the page explicitly to the v4.4.0 upgrade Retitle to "Upgrade to v4.4.0", add a scoping intro that links to the patch-version upgrade guide, and make the Prerequisites and Plugin Dependencies wording v4.4.0-specific. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/en/upgrade.mdx | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/en/upgrade.mdx b/docs/en/upgrade.mdx index 3dbfc58..5e4446b 100644 --- a/docs/en/upgrade.mdx +++ b/docs/en/upgrade.mdx @@ -7,7 +7,9 @@ sourceSHA: bad20dc1bccc211b5099b8eae64137f02edafcac310c7a753780773b0f75da9a title: Upgrade --- -# Upgrade +# Upgrade to v4.4.0 + +This page describes how to upgrade Alauda Database Service for MySQL (MySQL-MGR) to **v4.4.0**, including the plugin dependencies and prerequisites specific to this release. For patch-version (z-stream) upgrades within a minor version, see [Patch Version Upgrade](./how_to/30-upgrade). :::warning PXC Removal in Alauda Database Service for MySQL v4.3.0 @@ -22,17 +24,17 @@ Alauda Database Service for MySQL-MGR will execute upgrades based on the configu ## Prerequisites -Before initiating an upgrade, ensure the following: +Before initiating the upgrade to v4.4.0, ensure the following: -1. **Plugin dependencies are upgraded first**: Alauda Database Service for MySQL builds on foundational Alauda platform and Data Services plugins. Upgrade them to a compatible version **before** upgrading the MySQL operator or rolling instances. -2. **Version compatibility**: Your current version falls within a supported upgrade path. Review the [Release Notes](./release_notes) for the target version's new features and known issues, and the OperatorHub **Upgrade** prompt for the component and plugin version changes that the upgrade applies. +1. **Plugin dependencies are upgraded first**: Alauda Database Service for MySQL builds on foundational Alauda platform and Data Services plugins. Upgrade them to a v4.4.0-compatible version **before** upgrading the MySQL operator or rolling instances. +2. **Version compatibility**: Your current version falls within a supported upgrade path to v4.4.0. Review the [Release Notes](./release_notes) for v4.4.0's new features and known issues, and the OperatorHub **Upgrade** prompt for the component and plugin version changes that the upgrade applies. 3. **Component health**: All MySQL-MGR instances are in a `Running` (Ready) state before starting the upgrade. 4. **Resource availability**: The cluster has sufficient CPU, memory, and storage headroom to perform the rolling upgrade. 5. **PXC migration (if applicable)**: If the platform has any MySQL-PXC instances, complete the [MySQL-PXC Pre-Upgrade Checklist](#mysql-pxc-pre-upgrade-checklist) before upgrading to MySQL Operator v4.3.0 or later. ### Plugin Dependencies \{#plugin-dependencies} -Like other Alauda Container Platform Data Services plugins, MySQL-MGR depends on the shared Data Services base plugins. Upgrade them in the following order: +Like other Alauda Container Platform Data Services plugins, MySQL-MGR depends on the shared Data Services base plugins. For the v4.4.0 upgrade, upgrade them to the following minimum versions, in order: | Order | Plugin | Role | Minimum Version | |-------|--------|------|-----------------| From e9dc2dcbf15099e09f679fe69e080b78f25e88c6 Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 24 Jun 2026 06:28:33 +0000 Subject: [PATCH 5/8] docs(install): Data Services Essentials is required at v4.4.0+, not optional Reconcile the Essentials install note with the v4.4.0 plugin dependency: it is a required foundational platform component (also called Application Services Core), v4.4.0+, not an optional web-console-only plugin. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/en/installation.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/en/installation.mdx b/docs/en/installation.mdx index db12d8d..0ff0f37 100644 --- a/docs/en/installation.mdx +++ b/docs/en/installation.mdx @@ -9,8 +9,8 @@ title: Install ## Installing Alauda Container Platform Data Services Essentials -::: tip Optional Installation -The plugin serves as a foundational component for Alauda Data Services web console. It is not necessary to install it if the **web console** is not required. +::: tip Required for v4.4.0 +Alauda Container Platform Data Services Essentials (also referred to as **Application Services Core**) is a foundational platform component required by Alauda Database Service for MySQL. For the v4.4.0 release, install or upgrade it to **v4.4.0 or higher** before installing the MySQL operator. It also provides the Alauda Data Services web console. See [Upgrade to v4.4.0](./upgrade) for the full plugin dependency list. ::: ### Prerequisites From d25072e9a2cdd272aa3a51f094411513b960828a Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 24 Jun 2026 06:40:46 +0000 Subject: [PATCH 6/8] docs(install): Data Services RDS Framework is required at v4.3.x, not optional The RDS Framework is the base operator framework the MySQL operator extends; it is required (v4.3.x), not an optional web-console-only plugin. Mirror the Essentials fix. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/en/installation.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/en/installation.mdx b/docs/en/installation.mdx index 0ff0f37..85e257f 100644 --- a/docs/en/installation.mdx +++ b/docs/en/installation.mdx @@ -30,8 +30,8 @@ Alauda Container Platform Data Services Essentials (also referred to as **Applic ## Installing Alauda Container Platform Data Services RDS Framework -::: tip Optional Installation -The plugin serves as a foundational component for Alauda Data Services web console. It is not necessary to install it if the web console is not required. +::: tip Required for v4.4.0 +Alauda Container Platform Data Services RDS Framework is the base operator framework that Alauda Database Service for MySQL extends, and is required. For the v4.4.0 release, install or upgrade it to **v4.3.x** before installing the MySQL operator. See [Upgrade to v4.4.0](./upgrade) for the full plugin dependency list. ::: ### Prerequisites From f1b3f4ca9e50d534f3552fb557dc76f0e0ad5098 Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 24 Jun 2026 09:07:29 +0000 Subject: [PATCH 7/8] docs(upgrade): base operator dependency is rds-operator v4.3.0+, not RDS Framework v4.3.x Correct the row-2 base dependency: the MySQL operator extends the rds-operator multi-database base operator, which must be v4.3.0 or higher (was mislabeled as RDS Framework v4.3.x). Update the dependency table, warning, Important Notes, and the installation tip accordingly. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/en/installation.mdx | 2 +- docs/en/upgrade.mdx | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/en/installation.mdx b/docs/en/installation.mdx index 85e257f..4604903 100644 --- a/docs/en/installation.mdx +++ b/docs/en/installation.mdx @@ -31,7 +31,7 @@ Alauda Container Platform Data Services Essentials (also referred to as **Applic ## Installing Alauda Container Platform Data Services RDS Framework ::: tip Required for v4.4.0 -Alauda Container Platform Data Services RDS Framework is the base operator framework that Alauda Database Service for MySQL extends, and is required. For the v4.4.0 release, install or upgrade it to **v4.3.x** before installing the MySQL operator. See [Upgrade to v4.4.0](./upgrade) for the full plugin dependency list. +Alauda Container Platform Data Services RDS Framework (the `rds-operator` multi-database base operator) is the base operator framework that Alauda Database Service for MySQL extends, and is required. For the v4.4.0 release, install or upgrade it to **v4.3.0 or higher** before installing the MySQL operator. See [Upgrade to v4.4.0](./upgrade) for the full plugin dependency list. ::: ### Prerequisites diff --git a/docs/en/upgrade.mdx b/docs/en/upgrade.mdx index 5e4446b..1bfb006 100644 --- a/docs/en/upgrade.mdx +++ b/docs/en/upgrade.mdx @@ -39,18 +39,18 @@ Like other Alauda Container Platform Data Services plugins, MySQL-MGR depends on | Order | Plugin | Role | Minimum Version | |-------|--------|------|-----------------| | 1 | **Alauda Container Platform Data Services Essentials** (also referred to as Application Services Core) | Foundational platform component that the Data Services plugins and operators build on. | **v4.4.0 or higher** | -| 2 | **Alauda Container Platform Data Services RDS Framework** | Base operator framework that the MySQL operator extends. | **v4.3.x** | +| 2 | **Alauda Container Platform Data Services RDS Framework** (`rds-operator`) | The rds-operator multi-database base operator that the MySQL operator extends. | **v4.3.0 or higher** | | 3 | **Alauda Database Service for MySQL** | The MySQL-MGR operator and its instances. | **v4.4.0 or higher** | | 4 | **Query Analytics Operator** (`query-analytics-operator`) | Optional companion operator that powers slow query logging and query analysis. Only required if query analytics features are used. | **v4.4.0 or higher** | :::warning Upgrade the base plugins first -Always upgrade the **Data Services RDS Framework** to **v4.3.x** **before** upgrading the MySQL operator or rolling instances. Upgrading the MySQL operator against an older RDS Framework can leave instances in an inconsistent or unmanaged state. The OperatorHub **Upgrade** prompt lists the component and plugin version changes for the target release; see the [Install guide](./installation) for the plugin installation steps. +Always upgrade the **Data Services RDS Framework** (`rds-operator`) to **v4.3.0 or higher** **before** upgrading the MySQL operator or rolling instances. Upgrading the MySQL operator against an older rds-operator can leave instances in an inconsistent or unmanaged state. The OperatorHub **Upgrade** prompt lists the component and plugin version changes for the target release; see the [Install guide](./installation) for the plugin installation steps. ::: ### Important Notes - **Data Services Essentials version**: Upgrading the MySQL operator requires **Alauda Container Platform Data Services Essentials (Application Services Core) v4.4.0 or higher**. Upgrade this foundational platform component to a compatible version **before** upgrading the operator. -- **Upgrade the base plugins first**: The MySQL operator depends on the Alauda Container Platform Data Services RDS Framework. Upgrade the RDS Framework to **v4.3.x** **before** upgrading the operator. See [Plugin Dependencies](#plugin-dependencies). +- **Upgrade the base plugins first**: The MySQL operator depends on the Alauda Container Platform Data Services RDS Framework (`rds-operator`). Upgrade the rds-operator to **v4.3.0 or higher** **before** upgrading the operator. See [Plugin Dependencies](#plugin-dependencies). - **Query Analytics operator version**: If you use query analytics features (slow query logging and query analysis), upgrade the **Query Analytics Operator (`query-analytics-operator`) to v4.4.0 or higher**. This operator is optional — MySQL-MGR instances function normally without it. - **MySQL-PXC removal is irreversible**: Starting from MySQL Operator v4.3.0, MySQL-PXC is removed. PXC instances become **unmanaged** immediately after the operator upgrade and cannot be re-managed. Migrate any PXC instances to MySQL-MGR **before** upgrading to v4.3.0 or later — see the [MySQL-PXC Pre-Upgrade Checklist](#mysql-pxc-pre-upgrade-checklist). - **Operator rollback is not supported**: Once upgraded, the MySQL operator **cannot be rolled back** to a previous version. Take a verified full backup of every instance before starting the upgrade. See [Rollback considerations](#rollback-considerations). From dd54864f1b8bbaafe851ad481e48155874499b9a Mon Sep 17 00:00:00 2001 From: Jinpei Su Date: Wed, 24 Jun 2026 09:14:25 +0000 Subject: [PATCH 8/8] docs(upgrade): Minimum Version column shows a single version, not a range The column header already means "or higher", so the cells now list the bare minimum version (v4.4.0, v4.3.0) instead of "vX or higher". Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/en/upgrade.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/en/upgrade.mdx b/docs/en/upgrade.mdx index 1bfb006..ea35acc 100644 --- a/docs/en/upgrade.mdx +++ b/docs/en/upgrade.mdx @@ -38,10 +38,10 @@ Like other Alauda Container Platform Data Services plugins, MySQL-MGR depends on | Order | Plugin | Role | Minimum Version | |-------|--------|------|-----------------| -| 1 | **Alauda Container Platform Data Services Essentials** (also referred to as Application Services Core) | Foundational platform component that the Data Services plugins and operators build on. | **v4.4.0 or higher** | -| 2 | **Alauda Container Platform Data Services RDS Framework** (`rds-operator`) | The rds-operator multi-database base operator that the MySQL operator extends. | **v4.3.0 or higher** | -| 3 | **Alauda Database Service for MySQL** | The MySQL-MGR operator and its instances. | **v4.4.0 or higher** | -| 4 | **Query Analytics Operator** (`query-analytics-operator`) | Optional companion operator that powers slow query logging and query analysis. Only required if query analytics features are used. | **v4.4.0 or higher** | +| 1 | **Alauda Container Platform Data Services Essentials** (also referred to as Application Services Core) | Foundational platform component that the Data Services plugins and operators build on. | **v4.4.0** | +| 2 | **Alauda Container Platform Data Services RDS Framework** (`rds-operator`) | The rds-operator multi-database base operator that the MySQL operator extends. | **v4.3.0** | +| 3 | **Alauda Database Service for MySQL** | The MySQL-MGR operator and its instances. | **v4.4.0** | +| 4 | **Query Analytics Operator** (`query-analytics-operator`) | Optional companion operator that powers slow query logging and query analysis. Only required if query analytics features are used. | **v4.4.0** | :::warning Upgrade the base plugins first Always upgrade the **Data Services RDS Framework** (`rds-operator`) to **v4.3.0 or higher** **before** upgrading the MySQL operator or rolling instances. Upgrading the MySQL operator against an older rds-operator can leave instances in an inconsistent or unmanaged state. The OperatorHub **Upgrade** prompt lists the component and plugin version changes for the target release; see the [Install guide](./installation) for the plugin installation steps.