Installing Spring Cloud Services for VMware Tanzu
Page last updated:
Ensure that you have or have completed all items listed in Requirements. Then follow the below steps to install Spring Cloud Services.
WARNING: Spring Cloud Services (SCS) v2.x and v3.1 use the p-spring-cloud-services
org to deploy service instance backing apps. Deleting v2.1.2 or earlier will delete this org, even if SCS v3.1 is installed. If you have installed SCS v3.1 alongside v2.x, do not delete SCS v2.x until upgrading it to v2.1.3 or later. See Upgrading to SCS v3.1 and Removing SCS v2.x.
Installation Steps
Download Spring Cloud Services from VMware Tanzu Network.
In the Installation Dashboard of Ops Manager, click Import a Product on the left sidebar to upload the Spring Cloud Services file.
In the left sidebar, under Spring Cloud Services, click the + button next to the version number.
When the Spring Cloud Services tile appears in the Installation Dashboard, click it. In the Settings tab, click Assign AZs and Networks.
Select the availability zones for the tile to use. In the Network section, select the network used by VMware Tanzu Application Service for VMs (TAS). When finished, click Save.
Return to the Installation Dashboard.
Click Review Pending Changes. For more information about this Ops Manager page, see Reviewing Pending Product Changes.
Click Apply Changes to install the tile.
Running Alongside Previous Versions
Spring Cloud Services (SCS) v3.0–v3.1 can be installed alongside earlier versions of Spring Cloud Services, including v2.0 and v2.1. SCS v3.1 includes a new Config Server service, which is named p.config-server
instead of p-config-server
as in v2.1 and earlier versions, and a new Service Registry service, which is named p.service-registry
instead of p-service-registry
as in v2.1 and earlier versions.
WARNING: If you have installed Spring Cloud Services (SCS) v3.1 alongside SCS v2.x, do not delete SCS v2.x until you have updated it to v2.1.3 or later. For more information, see Upgrading Spring Cloud Services for VMware Tanzu.
Even though you can run different SCS versions in parallel, VMware recommends that you migrate all your service instances to Spring Cloud Services v3.1 to complete the upgrade. For more information, see Upgrading Spring Cloud Services for VMware Tanzu.
Differences Between v3.0–v3.1 Config Server and Earlier Config Server
The p.config-server
service includes new features (including the CredHub backend) and can run alongside the services included in 2.1 and earlier versions. You may wish to disable the older p-config-server
service and allow only the new p.config-server
Config Server service to be created.
Older Config Server service instances cannot be upgraded to the new p.config-server
service. Instead, you must recreate p-config-server
service instances. Most parameters used to create a p-config-server
service instance with the Cloud Foundry Command Line Interface (cf CLI), using the cf create-service
command with the -c
flag, can also be used to create a p.config-server
service instance. The following parameters are exceptions which can be used with the p-config-server
service but cannot be used with the p.config-server
service:
git.repos
composite.git
(see Composite Backends for information about how to configure the composite backend in the SCS v3.0–v3.1 Config Server)composite.vault
(see Composite Backends for information about how to configure the composite backend in the SCS v3.0–v3.1 Config Server)
SCS v3.1 service instances are backwards-compatible with version 2.0.1.RELEASE of the SCS client dependencies.
Upgrading to SCS v3.1 and Removing SCS v2.x
Note: SCS v3.1 and later do not include p-circuit-breaker-dashboard
. To retain this functionality, you must keep SCS v2.x installed.
If you are running SCS v3.0 or v3.1 alongside v2.x, you can complete the upgrade to v3.1 using the following procedure:
- Upgrade SCS v2.x to >= 2.0.11 or >= v2.1.3.
- Upgrade SCS v3.x to the latest version.
- Migrate all apps to bind to
p.config-server
service instances instead ofp-config-server
. For instructions, see Migrating Spring Cloud Services v2.x or 1.5 Service Instances in the Config Server documentation. - Migrate all apps to bind to
p.service-registry
service instances instead ofp-service-registry
. For more information, see Migrating Spring Cloud Services v2.x or v1.5 Service Instances in the Service Registry documentation. - Restage all migrated apps.
- Verify that all apps are behaving as expected before moving on to the next step.
- Delete the SCS v2.x tile.