PCF v2.6 Breaking Changes

This topic describes the breaking changes you need to be aware of when upgrading to Pivotal Cloud Foundry (PCF) v2.6. For more information about important preparation steps you must follow before beginning an upgrade, see Upgrading Pivotal Cloud Foundry.

PCF Ops Manager

See the following PCF Ops Manager breaking changes:

Passwords Not Supported for Ops Manager VM on vSphere

You can only SSH onto the Ops Manager VM in a vSphere deployment with a private SSH key. You cannot SSH onto the Ops Manager VM with a password.

To avoid upgrade failure and errors when authenticating, add a public key to the OVF template for the Ops Manager VM. Then, use the private key to SSH onto the Ops Manager VM.

For more information about adding a public key to the OVF template, see Deploy Ops Manager in Deploying Ops Manager on vSphere.

Warning: You cannot upgrade successfully without adding a public key. If you do not add a key, Ops Manager shuts down automatically because it cannot find a key and may enter a reboot loop.

Stemcell Property for Diagnostic Report API Endpoint is Removed

The stemcell property for the /api/v0/diagnostic_report endpoint is removed. Update any automation that uses the stemcell information in the /api/v0/diagnostic_report endpoint to avoid errors.

Information about all stemcells for both staged and deployed products is listed under a new added_products property for the /api/v0/diagnostic_report endpoint. Stemcell information under the added_products property includes the stemcell filename, OS, and version.

For more information about the /api/v0/diagnostic_report endpoint, see Diagnostic Report in the Ops Manager API documentation.

Stemcell Version Key for Pending Changes is Moved and Renamed

For the /api/v0/staged/pending_changes endpoint, the stemcell_version key from previous versions of the Ops Manager API is now the version sub-key under the stemcells key.

Update any automation that uses the stemcell information in the /api/v0/pending_changes endpoint to avoid errors.

For more information about the /api/v0/staged/pending_changes endpoint, see View a list of pending changes in the Ops Manager API documentation.

AWS Deployments Use 5th Generation Instances

Ops Manager v2.6 uses the latest generation of instances for AWS deployments. When you upgrade to Ops Manager v2.6, your VM types convert to the corresponding 5th generation instance types, such as t2 to t3 and c4 to c5.

If you are using a custom instance type catalog, your VM types that are used and available do not change.

These instance types are supported by Xenial stemcells and Trusty stemcell 3586 and later. Stemcells earlier than Trusty stemcell 3586 fail to boot Ops Manager. To avoid this, ensure that you are using Trusty stemcell 3586 or later.

For more information about AWS instance types, see Amazon EC2 Instance Types in the AWS documentation.

Stemcell Assignments Endpoint Deprecated

The stemcells_assignments endpoint in the Ops Manager API has been deprecated. The deprecated endpoint only returns a single stemcell for a product.

Instead, operators should use the stemcell_associations endpoint, which returns information about all stemcells associated with a product.

For more information, see Stemcell Associations for Products in the Ops Manager API documentation.

Pivotal Application Service (PAS)

See the following PAS breaking changes:

HTTP Healthcheck Server Disabled for SSH Proxy

If your SSH load balancer is configured with an HTTP healthcheck, remove the healthcheck before upgrading. This is the load balancer specified in the Diego Brain row of the Resource Config pane.

Note: Neither the Terraform templates for installing PAS nor the PAS installation instructions specify a HTTP healthcheck for the SSH Load balancer.

The ssh_proxy job running on the Diego Brain VM no longer starts a HTTP healthcheck server. This feature was previously added to allow GCP load balancers to healthcheck the service. However, GCP load balancers no longer require an HTTP endpoint for healthchecks.

Additionally, making this healthcheck server inaccessible improves the security of the platform.

Default VM Type Change for Router VMs

PAS v2.6 increases the default and minimum CPU core count from one to two for Router VMs.

Verify that you have sufficient infrastructure resources allocated to the deployment before upgrading to PAS v2.6.

PAS for Windows

See the following PAS for Windows breaking changes:

  • The Use “cf” as deployment name in emitted metrics instead of unique name option is removed from the Adavanced Features pane of the PASW tile.
  • Windows stemcell v2019.2 is not compatible with Ops Manager v2.6. Before upgrading to Ops Manager v2.6, upgrade your Windows stemcell to v2019.3 or later.
Create a pull request or raise an issue on the source for this page in GitHub