Upgrading VMware Tanzu SQL with MySQL for VMs

You can upgrade the VMware Tanzu SQL with MySQL for VMs service and existing service instances. You can also learn about service interruptions that can result from service changes and upgrades and from failures at the process, VM, and IaaS level.

For product versions and upgrade paths, see Upgrade Planner.

Upgrading Tanzu SQL for VMs

To upgrade the Tanzu SQL for VMs service, follow the Tanzu Operations Manager process that you use to install the service for the first time. Your configuration settings migrate to the new version automatically.

To upgrade Tanzu SQL for VMs:

Review the Release Notes for the version you are upgrading to.
Download the Ubuntu Jammy stemcell from Broadcom Support, and import it into the Tanzu Operations Manager Stemcell Library. For instructions, see Verify stemcell version and apply all changes.
Download the desired version of the product from Broadcom Support.
Go to the Tanzu Operations Manager Installation Dashboard and click Import a Product to upload the product file.
Under the Import a Product button, click + next to Tanzu SQL for VMs. This adds the tile to your staging area.
Click the newly-added Tanzu SQL for VMs tile to review its configuration panes. Click Save on any panes where you make changes.

To decrease the runtime for service instance upgrades, configure the upgrade-all-service-instances errand in the tile. For instructions about configuring this errand, see Configure service instance upgrades.
(Optional) If you want developers to individually upgrade service instances, go to to the Errands pane and select Off for Upgrade all On-demand MySQL Service Instances.

By default, the upgrade-all-service-instances errand runs after each upgrade. For more information, see About individual service instance upgrades.
Go to Tanzu Operations Manager Dashboard > Review Pending Changes. For more information about this Tanzu Operations Manager page, see Reviewing pending product changes.
For the Tanzu SQL for VMs tile, enable the Registering on-demand MySQL broker errand if the errand is not already enabled.
Click Apply Changes.

Upgrading the Tanzu SQL for VMs service and service instances can temporarily interrupt the service. For more information, see Service interruptions.

About individual service instance upgrades

Important To allow developers to upgrade individual service instances, you must use VMware Tanzu Application Service for VMs v2.7 or later.

After you upgrade the Tanzu SQL for VMs tile, existing service instances must be upgraded to use the latest version of the tile. Developers cannot create new bindings to service instances that have not been upgraded.

To decrease runtime for service instance upgrades, developers can individually upgrade on-demand service instances using the Cloud Foundry Command Line Interface (cf CLI). Developers can upgrade individual service instances by following the procedure in Upgrade an Individual Service Instance.

Developers can only upgrade individual service instances if you deactivate the upgrade-all-service-instances errand when upgrading the tile. By default, Tanzu SQL for VMs runs this errand when you upgrade the tile. However, this operation can take a long time. You must also ensure that the register-broker errand is run during upgrades. For more information about the register broker errand, see register-broker.

Important
When upgrading a highly available (HA) cluster from MySQL 5.7 to MySQL 8.0, VMware recommends that you first validate the HA cluster’s health by running the mysql-diag tool. To run mysql-diag, see Running mysql-diag. (A “highly available (HA) cluster” refers to any service instance created from a tile plan configured with the “HA cluster” topology.) If mysql-diag reports HA cluster is unhealthy, follow mysql-diag’s recommendations to bring the cluster to a healthy state before upgrading the cluster to MySQL 8.0.

Service interruptions

Service changes, upgrades, and failures at the process, VM, and IaaS level can cause outages in the Tanzu SQL for VMs service.

Read this section if:

You are planning an upgrade.
You are experiencing a service interruption and are wondering why.
You are planning to update or change a service instance and want to know if it might cause a service interruption.

Stemcell or service update

An operator updates a stemcell version or their version of Tanzu SQL for VMs.

Impact: Apps lose access to the MySQL service while Tanzu Operations Manager updates the service instance they are bound to. The service resumes within 10–15 minutes.
Required Actions: None. If the update deploys successfully, apps reconnect automatically.

Plan change

A developer changes their service instance to provide a different service plan, using cf update-service or Apps Manager. This process is used to update Service Instances from Percona 5.7 to Percona 8.0. For example:

cf update-service SERVICE-INSTANCE -p PLAN-WITH-8.0

Impact: Apps lose access to the MySQL service while Tanzu Operations Manager updates the service instance they are bound to. The service resumes within 10–15 minutes.
Required Actions: None. If the plan change deploys successfully, the apps reconnect automatically.

Service broker deployments

Automated backups are not taken during service broker deployments.

When the service broker is unavailable, such as during upgrades and re-deployments, automated backups fail. Automated backups resume according to schedule when the service broker is online again.

For general information about backups, see Backing up and restoring VMware Tanzu SQL with MySQL for VMs and Configuring automated backups.