Upgrading Cloud Service Broker for GCP

Would you like to upgrade Tanzu Cloud Service Broker for GCP? This topic tells you about the upgrade procedure, upgrading service instances, and specific details about upgrading to v1.3.

Pre-Upgrade procedure

Important Before upgrading, it is crucial to perform the checks suggested in this section. Not doing so could cause the upgrade process to fail and leave the broker unable to manage your instances.

Check if services are up-to-date Execute the command:
```
cf upgrade-all-services BROKER-NAME -check-up-to-date
```
This command checks whether all services provided by the specified broker are up-to-date. An instance is considered not up-to-date if it is pending upgrade, or if it is an orphaned service instance.
Check for orphaned service instances For greater granularity, you can specifically check only orphan service instances by running this command:
```
cf upgrade-all-services BROKER-NAME -check-deactivated-plans
```
This checks for any service instances still using plans that have been deactivated. More details can be found in the Managing orphaned service instances documentation.

Upgrade procedure

To upgrade Cloud Service Broker for GCP:

Before you stage the new tile version, ensure that all service instances are up to date. Installation stops if there are any outdated instances, and you cannot use Tanzu Operations Manager to add or edit any plans. If your installation stops, manually upgrade any outdated instances before trying to install the software again.
Download the new version of Cloud Service Broker for GCP from VMware Tanzu Network.
Stage and configure the tile by following the instructions in Installing with GCP.
Make all the changes described in Upgrade to v1.3.
Verify that your configuration complies with the important notes about upgrading service instances, especially regarding upgrading all instances, plans, and beta offerings.
Go to the Tanzu Operations Manager Installation Dashboard.
Click Review Pending Changes and then click Apply Changes.
Review the deploy-all errand logs for any errors created because of the upgrade instances task.

Verify that service instances are up to date before upgrading the tile

You might be unable to upgrade service instances that you did not upgrade with an earlier version of the tile. A step in the installation phase stops the process if there are any outdated instances.

For these reasons, verify that there are no service instances pending upgrade before staging the new version of the tile.

You can see whether there are instances with a pending upgrade by using the CLI plug-in. For more information, see ensuring all instances are up to date with the CLI plug-in.

Important notes about upgrading service instances

Before you start upgrading service instances, see the following notes:

Select the Upgrade all services check box:

If the Upgrade all services check box is not selected, service instances are not upgraded during installation. These instances become unmanageable by the broker. Any operations on that instance, such as update, bind, unbind, or delete, are blocked until you run the upgrade task. You can run the upgrade task at any time before upgrading the product to a later version. For information about how to configure this task, see Upgrade All Service Instances configuration. Alternatively, run the upgrade at a later stage using the CLI plug-in.
Select the Enable Beta offerings check box:

If the Enable Beta offerings check box is not selected when applying changes, instances from those service offerings are not upgraded. These instances become unmanageable by the broker. Verify that the Enable Beta offerings check box is selected if you have instances from those offerings that you intend to keep updated.
Deleting custom plans:

If you delete custom plans before upgrading all instances, instances from these plans are not upgraded. These instances become unmanageable by the broker. Delete plans after upgrading all instances, or see Release Notes for Cloud Service Broker for GCP and Upgrading to v1.3 to prevent conflicting upgrades.
Only upgrade the tile after all service instances are up to date:

You can run the upgrade all instances task as many times as needed. If you prefer, run the upgrade all instances task by using the cf CLI instead of, or in addition to, running it through the tile. Failure to upgrade one or more instances does not cause the tile installation to fail. Review the deploy all errand logs to verify that all instances have upgraded.

Verify that all instances are up to date with the CLI plug-in

To verify that no instances are pending upgrade:

Install the cf CLI UpgradeAllServices plugin on Cloud Foundry.
Follow the instructions in the Usage section of the README in the upgrade-all-services-cli-plugin GitHub repository to perform a check-up-to-date command.

check-up-to-date example:
```
cf upgrade-all-services BROKER-NAME -check-up-to-date
```
These command provide a list, from enabled plans, of instances that are pending upgrades and a list of orphaned service instances that belong to deactivated plans. Manage all the instances listed before attempting a tile upgrade.

Upgrade instances through the CLI plug-in

To use the cf CLI plug-in to upgrade instances:

Install the cf CLI UpgradeAllServices plugin on Cloud Foundry.
Run the upgrade by following the instructions in the Usage section of the README in the upgrade-all-services-cli-plugin GitHub repository.

For example:
```
cf upgrade-all-services BROKER-NAME
```

Upgrade to v1.3

There are currently no notes for upgrading to v1.3.