Upgrading Spring Cloud® Services for Pivotal Cloud Foundry
Page last updated:
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.
Follow the below steps to upgrade the Spring Cloud Services product.
Download the latest version of Spring Cloud Services from Pivotal Network.
In the Installation Dashboard of Pivotal Cloud Foundry (PCF) Operations Manager, click Import a Product on the left sidebar to upload the
After uploading the file, click the + button beside the version number under Spring Cloud Services in the product list.
Click the Spring Cloud Services tile. In the Errands tab, ensure that all of the Spring Cloud Services errands are enabled.
Return to the Installation Dashboard and click Apply changes on the right sidebar.
The upgrade process may take 20 to 30 minutes.
When the upgrade process is complete, you will see the dialog shown below. Click Return to Installation Dashboard.
Congratulations! You have successfully upgraded Spring Cloud Services.
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.
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.
Wait while any backing applications belonging to the service instance or instances are upgraded. The dashboard will show the
UPDATINGstatus for an instance while it is being upgraded.
When the service instances have been upgraded, the dashboard will show the new versions.