This guide provides a high-level overview of upgrading a Concourse deployment using BOSH, including command requirements and common errors.
Notes about breaking changes and other information can be found in the release notes.
This guide instructs on how to upgrade from v6.3.x to v6.7.x - if you are using a previous release of Concourse for VMware Tanzu, consult previous upgrade guides to first migrate to v6.3.x before you continue.
Prerequisites This is a guide to upgrading Concourse through BOSH, using the BOSH CLI v2 command `bosh deploy`.
The BOSH CLI must be installed before following the rest of this guide. For steps to install the BOSH CLI, see the BOSH documentation.
Important information You must use Xenial stemcell that is available on Tanzu Network. There is compatibility issue between Concourse and Ubuntu Bionic.
Important information before you begin You must only backup or upgrade a working Concourse deployment. Before upgrading, fix any issues in your Concourse deployment. This is necessary to ensure your backup files are valid, and to prevent problems occurring during the upgrade procedure.
For more information, see Checking the health and status of your deployments.
VMware recommends these three steps for upgrading:
When you are ready to begin, follow the steps in Backup Concourse with BBR.
Using Helm instead of BOSH? Check out this upgrade guide instead: Upgrading a Helm-deployed Concourse