Service Instance Upgrades

Service Instance Upgrade Steps

After an upgrade of the Spring Cloud Services product, follow the below steps to upgrade an individual service instance.

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.3.x, you must update your client applications to use the current version of the Spring Cloud Services client dependencies. See Client Application Changes in 1.1.0 below.

Important: After upgrading a Circuit Breaker Dashboard service instance from 1.0.x to 1.3.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.

Run cf update-service -c '{"upgrade":true}' SERVICE_NAME, where SERVICE_NAME is the name of a service instance:

$ cf update-service -c '{"upgrade": true}' config-server
Updating service instance config-server as admin...
OK

Update in progress. Use 'cf services' or 'cf service config-server' to check operation status.

If the service instance is already at the latest available version, you can force an upgrade by adding the force parameter with a value of true:

$ cf update-service -c '{"upgrade": true, "force": true}' config-server
Updating service instance config-server as admin...
OK

Update in progress. Use 'cf services' or 'cf service config-server' to check operation status.

As the output from the command suggests, you can use the cf services or cf service commands to check the status of the upgrade.

$ cf service config-server

Service instance: config-server
Service: p-config-server
Bound apps: cook
Tags:
Plan: standard
Description: Config Server for Spring Cloud Applications
Documentation url: http://docs.pivotal.io/spring-cloud-services/
Dashboard: https://spring-cloud-broker.apps.wise.com/dashboard/p-config-server/690f426b-9563-4d98-aa74-05ef3dea32c1

Last Operation
Status: update in progress
Message:
Started: 2016-06-22T16:13:27Z
Updated: 2016-06-22T16:13:27Z

When the upgrade is complete, cf service SERVICE_NAME will report a Status of update succeeded:

$ cf service config-server

Service instance: config-server
Service: p-config-server
Bound apps: cook
Tags:
Plan: standard
Description: Config Server for Spring Cloud Applications
Documentation url: http://docs.pivotal.io/spring-cloud-services/
Dashboard: https://spring-cloud-broker.apps.wise.com/dashboard/p-config-server/690f426b-9563-4d98-aa74-05ef3dea32c1

Last Operation
Status: update succeeded
Message:
Started: 2016-06-22T16:13:27Z
Updated: 2016-06-22T16:15:28Z

Client Application Changes in 1.1.0

The client dependencies for Spring Cloud Services were restructured in Spring Cloud Services version 1.1.0. In particular, the spring-cloud-services-starter-parent was replaced with a spring-cloud-services-dependencies Maven BOM (Bill of Materials), which does not include the Spring Cloud or Spring Boot dependency BOMs.

If your client applications are using dependencies corresponding to a 1.0.x version of Spring Cloud Services, you must update them to use the 1.3.x BOM and include the other requisite dependencies. See the Client Dependencies topic for details on the current client dependencies.

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