LATEST VERSION: 1.3 - CHANGELOG
Spring Cloud Services v1.3

Upgrading Spring Cloud® Services for Pivotal Cloud Foundry

Page last updated:

Product Upgradeability

Please see the relevant section below for important information regarding upgrades of the Spring Cloud Services product on your version of Pivotal Cloud Foundry.

Upgrades on Pivotal Cloud Foundry 1.6

When upgrading to a patch version of the Spring Cloud Services (SCS) product on Pivotal Cloud Foundry 1.6, you must consecutively apply all patch versions between your currently-installed SCS version and the version to which you wish to upgrade, and you may not skip a patch version. For example, you may not upgrade SCS 1.0.6 directly to SCS 1.0.8; instead, to upgrade SCS 1.0.6 to SCS 1.0.8, you must upgrade SCS 1.0.6 to SCS 1.0.7, then upgrade SCS 1.0.7 to SCS 1.0.8.

Upgrades on Pivotal Cloud Foundry 1.7

On Pivotal Cloud Foundry 1.7, you may not upgrade any version of the Spring Cloud Services product between 1.0.0 and 1.0.8 to any version older than 1.0.9 (e.g., you may not upgrade SCS 1.0.1 to SCS 1.0.2); however, you may upgrade any of these versions directly to 1.0.9 or later. You may upgrade any patch version of SCS after 1.0.9 directly to any later patch version and need not apply any intervening patch versions.

Product Upgrade Steps

Follow the below steps to upgrade the Spring Cloud Services product.

  1. Download the latest version of Spring Cloud Services from Pivotal Network.

  2. In the Installation Dashboard of Pivotal Cloud Foundry (PCF) Operations Manager, click Import a Product on the left sidebar to upload the p-spring-cloud-services-<version>.pivotal file.

    Pre upload

  3. After uploading the file, click the + button beside the version number under Spring Cloud Services in the product list.

    Pre upgrade

  4. Click the Spring Cloud Services tile. In the Errands tab, ensure that all of the Spring Cloud Services errands are enabled.

    Errands

  5. Return to the Installation Dashboard and click Apply changes on the right sidebar.

    Post upgrade

  6. The upgrade process may take 20 to 30 minutes.

    Applying changes

  7. When the upgrade process is complete, you will see the dialog shown below. Click Return to Installation Dashboard.

    Changes applied

  8. Congratulations! You have successfully upgraded Spring Cloud Services.

    Installation dashboard

Service Instance Upgrade Steps

After upgrading the Spring Cloud Services product, you can follow the below steps to upgrade an individual service instance or to upgrade all service instances. You can also use the Cloud Foundry Command Line Interface tool (cf CLI) to upgrade an individual service instance; see the Service Instance Upgrades topic for more information.

Important: If you have client applications which work with Spring Cloud Services 1.0.x service instances and are upgrading these service instances to 1.1.x, you must update your client applications to use the current version of the Spring Cloud Services client dependencies. See the Client Application Changes in 1.1.0 section of the Service Instance Upgrades topic.

Important: After upgrading a Circuit Breaker Dashboard service instance from 1.0.x to 1.1.x, you must unbind, rebind, and restart any client applications which were bound to the instance. This is due to a change in how service instance credentials are managed.

  1. To see the current version of a service instance, visit the Service Instances dashboard. (See the Service Instances Dashboard section of the Operator Information topic.)

    Si dashboard pre upgrade

  2. Click Upgrade in the listing for the service instance. To upgrade all service instances which are not at the versions included in the currently-installed Spring Cloud Services product, you may also click Upgrade Service Instances.

    Si dashboard upgrade

    Si dashboard upgrade service instances

  3. Wait while any backing applications belonging to the service instance or instances are upgraded. The dashboard will show the UPDATING status for an instance while it is being upgraded.

    Si dashboard upgrading instances

  4. When the service instances have been upgraded, the dashboard will show the new versions.

    Si dashboard post upgrade

Create a pull request or raise an issue on the source for this page in GitHub