Skip to main content

Upgrade

[edit on GitHub]

Warning

Chef Automate 4.x will not be available for download before the end of September 2022. We are working on making the upgrade process a seamless experience. Until then, you can download Chef Automate 3.0.49. Please get in touch with support for more information.

Steps to upgrade the Chef Automate HA are as shown below:

  • Download the latest cli

     curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate | cp -f chef-automate /usr/bin/chef-automate
    
  • Download Airgapped Bundle, download latest Bundle with this:

    curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o latest.aib
    

    Download specific version bundle with this:

    curl https://packages.chef.io/airgap_bundle/current/automate/<version>.aib -o automate-<version>.aib
    

    Note

    Chef Automate bundles are available for 60 days from the release of a version. However, the milestone release bundles are available for download forever.
  • If we want to only upgrade FrontEnd Services i.e. Chef Automate and Chef Infra Server.

    chef-automate upgrade run --airgap-bundle latest.aib --upgrade-frontends
    
  • If we want to only upgrade BackEnd Services i.e. Postgresql and OpenSearch.

    chef-automate upgrade run --airgap-bundle latest.aib --upgrade-backends
    
  • To upgrade full Chef Automate HA System run this command from Bation Host:

    chef-automate upgrade run --airgap-bundle latest.aib
    

Note

  • BackEnd upgrades will restart the backend service, which take time for cluster to be in health state.
  • Upgrade command, currently only supports minor upgrade.
  • To skip user confirmation prompt in upgrade, you can pass a flag
      chef-automate upgrade run --airgap-bundle latest.aib --auto-approve
      OR 
      chef-automate upgrade run --airgap-bundle latest.aib --upgrade-backends --auto-approve
      OR
      chef-automate upgrade run --airgap-bundle latest.aib --upgrade-frontends --auto-approve
    

Upgrade will also check for new version of bastion workspace, if new version is available, it will promt for a confirmation for workspace upgrade before upgrading the Frontend or backend nodes,

In case of yes, it will do workspace upgrade and no will skip this. We can also pass a flag in upgade command to avoid prompt for workspace upgrade.

 chef-automate upgrade run --airgap-bundle latest.aib --auto-approve --workspace-upgrade yes
    OR  
 chef-automate upgrade run --airgap-bundle latest.aib --auto-approve --workspace-upgrade no

Was this page helpful?

×









Search Results