Pivotal Platform v2.7 Breaking Changes

Page last updated:

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

Pivotal Platform

See the following Pivotal Platform breaking changes:

Pivotal Spring Cloud Services v2.0.x Not Compatible with Pivotal Platform v2.7

Pivotal Spring Cloud Services (SCS) v2.0.x is not compatible with Pivotal Platform v2.7. You cannot upgrade to Ops Manager v2.7 or PAS v2.7 without either removing SCS v2.0.x or upgrading from SCS v2.0.x to SCS v2.1.x first.

If you need to use the p-circuit-breaker-dashboard service in SCS v2.0.x, you must upgrade SCS v2.0.x to SCS v2.1.x before you upgrade to Pivotal Platform v2.7.

If you are running SCS v3.0.x or SCS v3.1.x alongside SCS v2.0.x and do not require p-circuit-breaker-dashboard functionality, you can remove SCS v2.0.x entirely after migrating completely to SCS v3.1.x. Follow the procedure in How to Upgrade to SCS v3.1.

After you successfully remove SCS v2.0.x or upgrade to SCS v2.1.x, you can proceed with the Pivotal Platform v2.7 upgrade procedure. For more information, see Upgrading Pivotal Platform.

Pivotal Operations Manager

See the following Ops Manager breaking changes:

Stemcell Assignments Endpoint Removed

The stemcells_assignments endpoint in the Ops Manager API has been removed.

Instead, operators must 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.

BOSH CLI v1 Not Supported

Ops Manager v2.7 does not support v1 of the BOSH CLI.

If you use BOSH CLI v1 commands manually from your workstation or in automation scripts, you need to update your usage to BOSH CLI v2.

Pivotal Application Service

See the following PAS breaking changes:

You Cannot Install PAS v2.7.0 or PAS v2.7.1 with External Blobstores

You cannot install or deploy PAS v2.7.0 or v2.7.1 with external blobstores. For more information, see You Cannot Install PAS v2.7.0 or v2.7.1 with External Blobstores in Pivotal Application Service v2.7 Release Notes.

Consul Clients Not Supported in PAS

The Consul server instance is removed from PAS. Tiledev authors must remove any Consul clients from their products to avoid failed deployments.

To remove Consul clients from your products, make the following changes to any job_type that is colocated with consul_agent:

- name: consul_agent
    release: consul
    ...
    manifest: |
      ...
      consul:
        client:
          enabled: "(( $ops_manager.dns_enabled ? false : true ))"

For more information about removing Consul clients from your products, see Tile Authors Must Remove consul_agent in the Pivotal Platform v2.4 Partner Release Notes.

Changed Properties and Jobs

The following PAS tile properties and PAS jobs have changed in PAS v2.7.

Before upgrading to v2.7, you must update any automation scripts to remove or change references to these properties and jobs.

  • UAA properties uaadb.tls_enabled and uaadb.skip_ssl_validation

  • Syslog jobs syslog_adapter and syslog_scheduler, and property syslog_metrics_to_syslog_enabled

    • The job instance groups syslog_adapter and syslog_scheduler, and the property syslog_metrics_to_syslog_enabled are removed.
    • Agent-based syslog egress renders these items unnecessary. For more information, see Agent-Based Syslog Egress Is Enabled by Default in the PAS v2.7 release notes.
  • Container networking property cf_networking_internal_domains

    • The cf_networking_internal_domains is now an array.
  • Runtime CredHub property credhub_key_encryption_passwords

    • The credhub_key_encryption_passwords property is replaced by credhub_hsm_provider_encryption_keys for HSM-resident CredHub and credhub_internal_provider_keys for internal CredHub.

Pivotal Isolation Segment

Changed Syslog Properties and Jobs

The following Pivotal Isolation Segment tile properties and jobs have been removed in Application Service for Windows v2.7:

  • Syslog job syslog_adapter
  • Syslog job syslog_scheduler
  • Syslog property syslog_metrics_to_syslog_enabled

Before upgrading to v2.7, you must update any automation scripts to remove or change references to these properties and jobs.

These changes mirror PAS tile changes described in the Changed Properties and Jobs section above.

For more information, see Agent-Based Syslog Egress Is Enabled by Default in the Pivotal Isolation Segment v2.7 release notes.

Isolation Segment Cells Update Diego Securely Over Port 8447

Diego cells deployed by the Isolation Segment tile (IST) communicate with the Diego file server with HTTPS over port 8447. Previously, IST cells communicated with HTTP over port 8080 like cells deployed by the PAS tile itself.

If you use isolation segments, you must ensure that port 8447 is open on the Diego Brain file server VM, which is deployed by the PAS tile.

Pivotal Application Service for Windows

See the following Pivotal Application Service for Windows (Application Service for Windows) breaking changes:

Windows2016 Stack is Deprecated

In Pivotal Application Service for Windows v2.7, the windows2016 stack is deprecated. Before you upgrade to Pivotal Application Service for Windows v2.7, you can migrate any apps that run on the windows2016 stack to the windows stack.

You can migrate your apps from windows2016 to windows using Stack Auditor, a Cloud Foundry CLI plugin. For more information, see Using the Stack Auditor Plugin.

RDP is Not Supported

The Enable Remote Desktop Protocol field is removed from the Application Service for Windows tile. Application Service for Windows VMs do not support connection through RDP.

Remove references to .properties.rdp_enabled in any automated scripts to avoid errors during upgrade.

To access Windows VMs, use bosh ssh. To enable bosh ssh for Windows VM, select Enable BOSH-native SSH support on all VMs in the Application Service for Windows tile.

For more information, see the Configure VMs section in Installing and Configuring Application Service for Windows.

Changed Syslog Properties and Jobs

The following Application Service for Windows tile properties and jobs have been removed in Application Service for Windows v2.7:

  • Syslog job syslog_adapter
  • Syslog job syslog_scheduler
  • Syslog property syslog_metrics_to_syslog_enabled

Before upgrading to v2.7, you must update any automation scripts to remove or change references to these properties and jobs.

These changes mirror PAS tile changes described in the Changed Properties and Jobs section above.

For more information, see Agent-Based Syslog Egress Is Enabled by Default in the Pivotal Application Service for Windows v2.7 release notes.

Enterprise PKS

For breaking changes in Enterprise PKS v1.5, see See Breaking Changes in the Enterprise PKS Release Notes.