Upgrade Chef Infra Client
The following sections describe the upgrade process for Chef Infra Client. If you are also upgrading the Chef Infra Server complete that process first and then upgrade the Chef Infra Client.
Prerequisites
Commercial users must have a license ID. You can get your license ID from the Chef Downloads portal.
For community users, see the Chef install script documentation.
Command line upgrades
Use the Chef install script to upgrade to the latest version of Chef Infra Client on a node from the command line.
On Linux, macOS, and Unix-based hosts:
curl -L https://chefdownload-commercial.chef.io/install.sh?license_id=<LICENSE_ID> | sudo bashReplace
<LICENSE_ID>with your license ID.On Windows hosts:
. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id=<LICENSE_ID> } | iex; installReplace
<LICENSE_ID>with your license ID.
Specify the install version
You can install a specific version of Chef Infra Client using the Chef install script.
Use the
-voption to install a specific version on Linux, macOS, and Unix-based hosts. For example:curl -L https://chefdownload-commercial.chef.io/install.sh?license_id=<LICENSE_ID> | sudo bash -s -- -v 17.9.26Replace
<LICENSE_ID>with your license ID.Use the
-versionoption to install a specific version on Windows hosts. For example:. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id=<LICENSE_ID> } | iex; install -version 17.9.26Replace
<LICENSE_ID>with your license ID.
Upgrade multiple hosts with knife
You can use the knife ssh command in Chef Workstation to execute the install script on multiple Linux, macOS, and Unix-based hosts at once.
knife ssh <SEARCH_QUERY> 'curl -L https://chefdownload-commercial.chef.io/install.sh?license_id=<LICENSE_ID> | sudo bash'
Replace:
<LICENSE_ID>with your license ID<SEARCH_QUERY>with a node search query
Cookbook-based upgrade
Use the chef_client_updater cookbook to install or upgrade Chef Infra Client on a node.