PAS for Windows v2.6 Release Notes

Page last updated:

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

Release Date: 10/31/2019

  • [Security Fix] Upgrade Go, runc and containerd to latest to include security fixes
  • [Security Fix] CVE-2019-17596 bump Go
  • Bump windows2019 stemcell to version 2019.12
  • Bump garden-runc to version 1.19.8
  • Bump loggregator-agent to version 3.16.2
  • Bump loggregator to version 105.5.2
Component Version
windows2019 stemcell2019.12
cf-windows-smoke-tests40.0.119
diego2.30.5
event-log0.8.0
garden-runc1.19.8
hwc-offline-buildpack3.1.10
loggregator-agent3.16.2
loggregator105.5.2
winc2.0.0
windows-utilities0.11.0
windowsfs-release2.1.0

2.6.6

Release Date: 10/16/2019

  • [Security Fix] Bump Go to address CVE-2019-16276
  • Bump windowsfs-release to version 2.1.0
Component Version
windows2019 stemcell2019.11
cf-windows-smoke-tests40.0.119
diego2.30.5
event-log0.8.0
garden-runc1.19.7
hwc-offline-buildpack3.1.10
loggregator-agent3.14.3
loggregator105.5.1
winc2.0.0
windows-utilities0.11.0
windowsfs-release2.1.0

2.6.5

Release Date: 10/08/2019

  • [Security Fix] Upgrade Diego Components to Use grpc v1.23.0 and Go 1.12.9 to Fix HTTP2 CVEs
  • [Security Fix] Bump garden-runc release to take Go HTTP/2 and containerd gRPC fixes
  • [Bug Fix] Fix issue where some metrics were incorrectly aggregated
  • Bump windows2019 stemcell to version 2019.11
  • Bump cf-windows-smoke-tests to version 40.0.119
  • Bump diego to version 2.30.5
  • Bump garden-runc to version 1.19.7
  • Bump loggregator-agent to version 3.16
  • Bump loggregator to version 105.6
  • Bump winc to version 2.0.0
  • Bump windowsfs-release to version 2.0.0
Component Version
windows2019 stemcell2019.11
cf-windows-smoke-tests40.0.119
diego2.30.5
event-log0.8.0
garden-runc1.19.7
hwc-offline-buildpack3.1.10
loggregator-agent3.16
loggregator105.6
winc2.0.0
windows-utilities0.11.0
windowsfs-release2.0.0

2.6.4

Release Date: 09/17/2019

  • [Bug Fix] Keep resending route unregistration message to prevent application misrouting in case of NATS routing tier instability
  • Bump windows2019 stemcell to version 2019.9
  • Bump cf-windows-smoke-tests to version 40.0.118
  • Bump diego to version 2.30.4
Component Version
windows2019 stemcell2019.9
cf-windows-smoke-tests40.0.118
diego2.30.4
event-log0.8.0
garden-runc1.19.5
hwc-offline-buildpack3.1.10
loggregator-agent3.14
loggregator105.5
winc1.14.0
windows-utilities0.11.0
windowsfs-release1.8.0

2.6.3

Release Date: 08/15/2019

  • [Feature Improvement] Windows Smoke Tests Errand uses windows stack instead of windows2016.
  • Bump cf-windows-smoke-tests to version 40.0.116
  • Bump garden-runc to version 1.19.5
  • Bump windowsfs-release to version 1.8.0
Component Version
windows2019 stemcell2019.8
cf-windows-smoke-tests40.0.116
diego2.30.1
event-log0.8.0
garden-runc1.19.5
hwc-offline-buildpack3.1.10
loggregator-agent3.14
loggregator105.5
winc1.14.0
windows-utilities0.11.0
windowsfs-release1.8.0

2.6.2

Release Date: 08/01/2019

  • Bump windows2019 stemcell to version 2019.8
  • Bump hwc-offline-buildpack to version 3.1.10
  • Bump windowsfs-release to version 1.7.0
Component Version
windows2019 stemcell2019.8
cf-windows-smoke-tests40.0.51
diego2.30.1
event-log0.8.0
garden-runc1.19.1
hwc-offline-buildpack3.1.10
loggregator-agent3.14
loggregator105.5
winc1.14.0
windows-utilities0.11.0
windowsfs-release1.7.0

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.

Pre-Installed Visual C++ Redistributables

PAS for Windows v2.6.2 and later includes Microsoft Visual C++ Redistributables for Visual Studio 2010, 2015, 2017 and 2019. This change is backported to PAS for Windows v2.2 and later.

This update improves the developer experience by making Visual C++ Redistributables readily available for .NET apps. Developers no longer have to manually bin deploy to reference C++ or C++ based libraries.

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.

PAS for Windows v2.6 does not support TLS from GoRouter to an app container

PAS for Windows v2.6 does not currently support TLS encryption between GoRouter and an app container.

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.