Upgrading Pivotal Spring Cloud Services

Page last updated:

You can install Spring Cloud Services (SCS) v3.1.x alongside the following earlier versions of SCS:

  • v2.0.x
  • v1.5.x

However, Pivotal recommends that you migrate all your service instances to Spring Cloud Services v3.1.x. After migration, you can remove any earlier versions of Spring Cloud Services.

Service Changes

Spring Cloud Services v3.1 includes a new Service Registry service, named p.service-registry instead of p-service-registry as in earlier versions. It also includes a new Config Server service, named p.config-server instead of p-config-server as in earlier versions.

The p.config-server service can be offered alongside, but does not replace, earlier versions of Config Server. Pivotal recommends disabling the older p-config-server service after installing Spring Cloud Services 3.1 (which includes the p.config-server service).

For more information about running Spring Cloud Services v3.1 alongside earlier versions, see the Running Alongside Previous Versions section of Installing Pivotal Spring Cloud Services.

How to Upgrade to SCS v3.1.x

Note: SCS v3.0.x and later do not include p-circuit-breaker-dashboard. To retain this functionality, you must keep SCS v2.0.x installed.

If you are running SCS v3.0.x or SCS v3.1.x alongside SCS v2.0.x, you can complete the upgrade to SCS v3.1.x with the following procedure:

  1. Upgrade SCS v2.0.x to v2.0.11 or later.
  2. If you are running SCS v3.0.x, download and install SCS v3.1.0 or later. For more information, see Installing Pivotal Spring Cloud Services.
  3. Migrate all apps to bind to p.config-server service instances instead of p-config-server. For instructions, see Migrating Spring Cloud Services 2.0.x or 1.5.x Service Instances.
  4. Migrate all apps to bind to p.service-registry service instances instead of p-service-registry. For more information, see Creating an Instance.
  5. Restage all migrated apps.
  6. Verify that all apps are behaving as expected before moving on to the next step.
  7. Delete the SCS v2.0.x and SCS v3.0.x tiles.