CHEF - UPGRADE

Upgrade to 3.X in Chef Automate

As we have mentioned, chef automate will automatically upgrade to a minor version, but you need to do it yourself to upgrade to a major version. To upgrade to 3.0.X, you need to first upgrade to version 20220329091442; follow the instructions below:

First, check the current version of your chef automates by:

sudo chef-automate version

If the current version is less than 20220329091442, then you can proceed to upgrade.

Normal Upgrade to 20220329091442 

• Run command in CLI

sudo chef-automate upgrade run

 

• Check services status

sudo chef-automate status

Airgapped Upgrade to 20220329091442 

Internet-connected machine

•  Download Chef Automate CLI:

curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate

 

• Create bundle version 20220329091442

./chef-automate airgap bundle create --version 20220329091442

 

• Move the latest automate-20220329091442.aib file and CLI chef-automate to the airgapped machine running Chef Automate.

 

Now on airgapped machine running Chef Automate

sudo ./chef-automate upgrade run --airgap-bundle automate-20220329091442.aib

 

• Check services status by:

sudo chef-automate status

Path Upgrade from Version 20220329091442 to 3.0.x

There will be four possible ways by which you can upgrade.

1. With Embedded PostgreSQL
    

• First, start a major upgrade

sudo chef-automate upgrade run --major

 

• Check upgrade Status

sudo chef-automate upgrade status

 

• Migrate data from PostgreSQL 9.6 to 13

sudo chef-automate post-major-upgrade migrate --data=PG

 

• Check services status

sudo chef-automate status

 

• Verify data in chef automate

sudo chef-automate post-major-upgrade clear-data --data=PG

 

2. With External PostgreSQL
 

• To manually update your PostgreSQL version check out external PostgreSQL upgrade official documentation available by Chef Automate.
  
   
• start major upgrade

sudo chef-automate upgrade run --major

 

• Check services status

sudo chef-automate status

There are two more ways to upgrade our path; You can check out the official documentation link for the other two methods. 

1. Air-Gapped Environment With Embedded PostgreSQL
    
2. Air-Gapped Environment With External PostgreSQL

Upgrade Chef Automate to 4.0.x

Before upgrading the path check out the current version if it is less than 3.0.49 then first upgrade it to 3.0.X. check out the steps given above.

Check version

sudo chef-automate version

If the current version is  3.0.X then you can upgrade with:

chef-automate upgrade run --major

Upgrade Path from 3.0.49 to 4.0.x

Upgrade With Embedded Elasticsearch

• First, start a major upgrade

sudo chef-automate upgrade run --major

 

• Check upgrade Status

sudo chef-automate upgrade status

 

• Switch off maintenance

sudo chef-automate maintenance off

 

• Copy the relevant configuration fields of elasticsearch into opensearch configuration.

To apply this use config patch command

 

• Move data from elasticsearch to opensearch 

sudo chef-automate post-major-upgrade migrate --data=es

 

• Check services status

sudo chef-automate status

 

• Delete old elasticsearch data

sudo chef-automate post-major-upgrade clear-data --data=es

 

 Upgrade with External Elasticsearch

• First, start a major upgrade

sudo chef-automate upgrade run --major

 

• Check upgrade Status

sudo chef-automate upgrade status

 

• You have to upgrade your external elasticsearch to opensearch manually.
   
• Copy the relevant configuration fields of elasticsearch into opensearch configuration.
   
• Switch off maintenance

sudo chef-automate maintenance off

 

There are two more ways to upgrade our path; You can check out the official documentation link for the other two methods. 

Air-Gapped Environment With Embedded ElasticSearch
 

Air-Gapped Environment With External ElasticSearch

Frequently Asked Question

Is the 3.0.x version higher than 20220329091442?

Yes, the version before 20220329091442 is a lower version of chef automates than 3.0.X.

Can we disable the automatic upgrade in chef automate?

Just make upgrade_stratergy = "none "in confid,toml file in chef automate.

What precautions should we take before upgrading?

Just back up your data before upgrading to a higher version.

How to handle downtime?

Just enter sudo chef-automate maintenance to turn on maintenance, and the environment will handle the downtime.

How do you verify whether the service is working or not?

sudo chef-automate status

Conclusion

We learned how we could upgrade to different versions of chef automate in various possible ways. And we have also known other useful commands that we can use in chef automate CLI, like how to check the current version and how we can disable automatic upgrades.

To learn more about the chef, you can check out the following articles:

CHEF - HIGH AVAILABILITY

CHEF - SETTINGS

CHEF - DEPLOYMENT

Chef-shell (executable) - DEBUGGING TOOL

To learn more about DSA, competitive coding, and many more knowledgeable topics, please look into the guided paths on Coding Ninjas Studio. Also, you can enroll in our courses and check out the mock test and problems available to you. Please check out our interview experiences and interview bundle for placement preparations.