This topic describes how to upgrade Tanzu Cloud Service Broker for Azure.

Upgrading to v1.4

Upgrading to Azure Cache for Redis v6

New Redis v6 is now available through Cloud Service Broker for Azure.

Note: All brokerpak-provided plans set the Redis version to v4 to maintain compatibility with the instances already created. These plans are deprecated and will be removed from the brokerpak in future releases in favor of custom-defined plans in the tile. VMware recommends that you update all instances to use custom-defined plans instead.

To update to Redis v6:

  1. Before updating the Redis version, make sure you read the Microsoft Azure upgrade recommendations and understand any possible consequences to the service.

  2. Identify the instance that you want to update to use Redis v6.

  3. Identify the plan used to create the instance by running:

    cf service INSTANCE-NAME
    

    Where INSTANCE-NAME is the name of the service to be updated.

  4. Find the plan definition of the plan you identified. If it is a custom plan, you can find its definition in the tile configuration. If is is a brokerpak-provided plan, you can find the corresponding properties in the brokerpak definition.

  5. If the plan is a custom plan, you can update the instance to use Redis v6 by running:

    cf update-service INSTANCE-NAME -c '{"redis_version": "6"}'
    

    Where INSTANCE-NAME is the name of the service to be updated.

  6. If the plan is a brokerpak-provided one, you can either define a plan with or without a specified Redis version. Choose one of the following options:

    • Option 1: Define the custom-created plan with a specified Redis version.

      1. Define a custom plan that specifies the Redis version. For example:

        {
          "name": "custom-plan-v6",
          "id": "ba3d28f0-6b17-11ed-91ca-1f5af50ef86f",
          "description": "Custom plan",
          "sku_name": "Basic",
          "family": "C",
          "capacity": 1,
          "tls_min_version": "1.2",
          "firewall_rules": [],
          "redis_version": "6"
        }
        

        Important: All other service properties must match the plan the instance is already on. If you set the redis_version property in the plan, users cannot change that property during create or update instance operations.

      2. Update the instance to the new plan by running:

        cf update-service INSTANCE-NAME -p NEW-PLAN-NAME
        

        Where NEW-PLAN-NAME is the name of the plan created in previous step.

    • Option 2: Define a custom-created plan without a specified Redis version.

      1. Define a custom plan that does not specify the Redis version. For example:

        {
           "name": "custom-plan-v6",
           "id": "ba3d28f0-6b17-11ed-91ca-1f5af50ef86f",
           "description": "Custom plan",
           "sku_name": "Basic",
           "family": "C",
           "capacity": 1,
           "tls_min_version": "1.2",
           "firewall_rules": []
        }
        

        Important: All service properties, other than name, id and description must match the plan the instance is already on.

      2. Update the instance to the new plan by running:

        cf update-service INSTANCE-NAME -p NEW-PLAN-NAME -c '{"redis_version": "6"}'
        

        Where NEW-PLAN-NAME is the name of the plan created in previous step.

Upgrade procedure

To upgrade the Cloud Service Broker for Azure to a later version:

  1. Download the new version of Cloud Service Broker for Azure from VMware Tanzu Network.
  2. Follow the procedure in Installing with Azure to configure the tile.
  3. If you are upgrading to a version later than v1.0, service instances might need to be upgraded. Before installing the new version, see Upgrade All Service Instances Config.
check-circle-line exclamation-circle-line close-line
Scroll to top icon