LATEST VERSION: 1.9 - CHANGELOG
Pivotal Cloud Foundry v1.9

Upgrading Windows Cells

This topic describes how to upgrade the Windows cells on a Pivotal Cloud Foundry (PCF) deployment. Operators may want to upgrade their Windows cells in response to the following events:

  • For deployments that run on Amazon Web Services (AWS), the release of a new Windows stemcell included in the BOSH Release for Windows on Pivotal Network
  • For deployments that run on vSphere, an update to the Windows Server 2012 operating system
  • A new release of Garden Windows

Update the Stemcell

Perform the following steps to update the stemcell for your Windows cells:

  1. Retrieve the new stemcell by performing the steps appropriate for your IaaS:

    • If your deployment runs on AWS, download the new stemcell from the latest BOSH Release for Windows on Pivotal Network.
    • If your deployment runs on vSphere, ensure that you have followed the procedures in the Building a Windows Stemcell topic to create a Concourse pipeline for building stemcells. Navigate to your Concourse pipeline in a browser and kick off a build by selecting create-stemcell and clicking the plus sign in the upper right. Concourse uses the newest version of the Windows Server 2012 operating system to build a new stemcell. After several hours, the stemcell appears in the bucket you created in your S3-compatible blobstore.
  2. Follow the steps in the Log into BOSH section of the Advanced Troubleshooting with the BOSH CLI topic to target and log in to your BOSH Director. The steps vary slightly depending on whether your PCF deployment uses internal authentication or an external user store.

  3. After you have successfully logged in to your BOSH Director, upload the new stemcell to BOSH:

    $ bosh upload stemcell YOUR-WINDOWS-STEMCELL.tgz
    
  4. If necessary, download the manifest of your garden-windows deployment:

    $ bosh download manifest garden-windows garden-windows.yml
    

  5. Set your deployment to garden-windows:

    $ bosh deployment garden-windows.yml
    

  6. Edit your manifest:

    $ bosh edit deployment
    

  7. Locate the top-level property stemcells and update the version number of your Windows stemcell to the new version:

    stemcells:
    - os: windows2012R2
      alias: windows
      version: 0.0.183
    
  8. Save and exit the manifest.

  9. Redeploy:

    $ bosh -d garden-windows.yml deploy
    

Update the Garden Windows Release

Perform the following steps to update the Garden Windows release:

  1. Download the new Garden Windows release tarball from the latest BOSH Release for Windows on Pivotal Network.

  2. Follow the steps in the Log into BOSH section of the Advanced Troubleshooting with the BOSH CLI topic to target and log in to your BOSH Director. The steps vary slightly depending on whether your PCF deployment uses internal authentication or an external user store.

  3. If necessary, download the manifest of your garden-windows deployment:

    $ bosh download manifest garden-windows garden-windows.yml
    

  4. Set your deployment to garden-windows:

    $ bosh deployment garden-windows.yml
    

  5. Upload the new Garden Windows release to BOSH:

    $ bosh upload release garden-windows-y-x.tgz 
    

  6. Edit your manifest:

    $ bosh edit deployment
    

  7. Locate the top-level property releases and update the version number of the Garden Windows release to the new version:

    releases:
    - name: garden-windows
      version: 0.0.6
    
    
  8. Save and exit the manifest.

  9. Redeploy:

    $ bosh -d garden-windows.yml deploy
    

Was this helpful?
What can we do to improve?
View the source for this page in GitHub