Pivotal Engineering Journal

Technical articles from Pivotal engineers.

Ensure Windows apps are using the `windows` stack

Pivotal Application Service for Windows introduced the -s windows stack name in PASW 2.4, reducing the operator and developer need to concern themselves with specific Windows Server versions. From PASW 2.4 onwards, both the windows2016 and windows stack names worked - giving sufficient time to migrate apps over to the new stack name.

Posted on by
Categories:   PASW    .NET    Windows    stack    cf   
Edit this post on GitHub.

Pivotal Application Service for Windows introduced the -s windows stack name in PASW 2.4, reducing the operator and developer need to concern themselves with specific Windows Server versions. From PASW 2.4 onwards, both the windows2016 and windows stack names worked - giving sufficient time to migrate apps over to the new stack name.

Pivotal Application Service for Windows 2.8 will have -s windows2016 as a deprecated stack name, requiring developers and operators to use the -s windows stack name. **PASW 2.8 onwards, you should update any apps using the windows2016 stack, to use the windows stack. **

Operators can use the Stack Auditor CF CLI plugin to get an inventory of all apps and their current stack, in a given foundation. They can also use the plugin to update an app stack to windows without needing access to the app’s source or automation pipeline. Be aware, changing the stack of an app WILL cause the app to restart which may lead to temporary downtime.

The plugin is available for download in the Buildpack Extensions area of PivNet. Watch a video of running stack audit as well as upgrading apps, below.

Migrating your apps to the windows stack

  • Find out which apps on your foundation are using the -s windows2016 stack name, by using Stack Auditor cf audit-stack command
  • Use the Stack Auditor cf change-stack command to update all apps to use the windows stack
  • Update all app manifests and pipeline to specify the windows stack


video of running stack audit as well as upgrading apps