PAS for Windows v2.6 Release Notes

This topic contains release notes for Pivotal Application Service (PAS) for Windows.

How to Upgrade

The PAS for Windows v2.6 tile is available with the release of Pivotal Cloud Foundry (PCF) version v2.6. To use the PAS for Windows v2.6 tile, you must install Ops Manager v2.6 or later and PAS v2.6 or later.

If you are running PAS for Windows v2.4.4 or later on PCF v2.5 and want to upgrade to PCF v2.6, you must upgrade to PAS for Windows v2.5 before upgrading to PCF v2.6.

Releases

2.6.1

  • [Feature Improvement] Apps get 10 seconds of graceful shutdown time in PASW
  • Bump windows2019 stemcell to version 2019.7
  • Bump diego to version 2.30.1
  • Bump hwc-offline-buildpack to version 3.1.9
  • Bump loggregator-agent to version 3.14
  • Bump loggregator to version 105.5
  • Bump winc to version 1.14.0
  • Bump windowsfs-release to version 1.6.0
Component Version
windows2019 stemcell2019.7
cf-windows-smoke-tests40.0.51
diego2.30.1
event-log0.8.0
garden-runc1.19.1
hwc-offline-buildpack3.1.9
loggregator-agent3.14
loggregator105.5
winc1.14.0
windows-utilities0.11.0
windowsfs-release1.6.0

2.6.0

Breaking Change: The Use “cf” as deployment name in emitted metrics instead of unique name option is removed.

  • [Feature] App developers can gracefully shutdown their .NET applications in PASW
  • [Feature] Add optional System Metric Agent to allow monitoring a more complete set of metrics for all VMs in the deployment
  • [Feature] Operators can provide trusted certificates in Ops Manager for .NET apps to use automatically
  • [Feature Improvement] Allow vcap WriteKey access to ODBC registry entry
  • [Feature Improvement] Improve scalability of application syslog drain system with new syslog agent architecture
  • [Security Fix] Introduce and trust new Diego “root CA” in advance of existing CA expiration
  • Bump windows2019 stemcell to version 2019.5
  • Bump hwc-offline-buildpack to version 3.1.9
  • Bump loggregator-agent to version 3.14
  • Bump loggregator to version 105.5
  • Bump winc to version 1.13.0
  • Bump windowsfs-release to version 1.5.0
Component Version
windows2019 stemcell2019.5
cf-windows-smoke-tests40.0.51
diego2.30.0
event-log0.8.0
garden-runc1.19.1
hwc-offline-buildpack3.1.9
loggregator-agent3.14
loggregator105.5
winc1.13.0
windows-utilities0.11.0
windowsfs-release1.5.0

New Features in PAS for Windows v2.6

PAS for Windows v2.6.0 includes the following major features:

App Developers Can Gracefully Shut Down .NET Apps

PAS for Windows v2.6 allows ten seconds for a .NET app to shut down gracefully after the app is stopped using cf stop. Graceful shutdown is supported on deployments using Windows Server 2019 or later for apps that provide a control handler for the CTRL_SHUTDOWN_EVENT event.

For more information, see Graceful Shutdown in the .NET on Pivotal Cloud Foundry Cookbook.

Introduction of System Metrics Agent

PAS for Windows v2.6 includes the introduction of the System Metrics Agent. When the System Metrics Agent is enabled, Windows cells emit system-level metrics about each VM in your deployment.

You can enable this feature in the PAS for Windows v2.6 tile by selecting Enable System Metrics within the System Logging pane.

For a list of the VM metrics that the System Metric Agent emits for Windows VMs, see VM Metrics in GitHub.

For additional information about system-level metrics in PCF, see BOSH VM and PCF Component Health Metrics and Key Performance Indicators.

Deprecation of the windows2016 Stack

You should 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.

ODBC Driver Installation Support in Windows Containers

PAS for Windows v2.6 supports ODBC driver installation by giving developers the ability to add ODBC driver entries to the Windows Registry. Previously, ODBC drivers were installed to Windows cells using BOSH add-ons. Installing ODBC drivers by using BOSH add-ons is no longer possible in true Windows containerized runtimes.

BOSH SSH Enabled by Default

In PAS for Windows v2.6, use of the bosh ssh command is enabled by default for deployed VMs. Developers can use the bosh ssh command to troubleshoot Windows-based Diego cells.

Deploy Windows Stemcells on BOSH Director with GCS

PAS for Windows v2.6 supports deploying Windows stemcells with a BOSH Director that uses GCS as the BOSH blobstore.

For more information on configuring a GCS blobstore, see Director Config Page in Configuring BOSH Director on GCP Manually or Director Config Page in Configuring BOSH Director on GCP Using Terraform.

Improved Application Syslog Drain Scalability

PAS for Windows v2.6 has improved application syslog drain scalability and incorporates a new syslog agent architecture.

Known Issues

This section includes known issues with PAS for Windows v2.6.

App Syslog Drains Fail After Enabling Agent-Based Syslog

If you select Enable agent-based syslog egress for app logs in the System Logging pane of the PAS tile, external syslog drains that are bound to Windows Apps cannot collect logs. For more information, see “Enable agent-based syslog egress for app logs” interrupts external log collection for PAS Windows apps in the Pivotal Knowledge Base.

Graceful Shutdown Is Not Supported on Deployments with One Windows Cell

Graceful shutdown is supported only on Windows Server 2019 deployments with two or more Windows cells. For more information, see Graceful shutdown works only for CF deployments with multiple Windows 2019 cells in the Pivotal Knowledge Base.

Create a pull request or raise an issue on the source for this page in GitHub