Upgrading Spring Cloud Services for VMware Tanzu

Page last updated:

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

  • v2.1.x

However, VMware 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. VMware 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 Spring Cloud Services for VMware Tanzu.

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 Spring Cloud Services for VMware Tanzu.
  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.