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 bash

Replace <LICENSE_ID> with your license ID.

On Windows hosts:

. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id=<LICENSE_ID> } | iex; install

Replace <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 -v option 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.26
```
Replace <LICENSE_ID> with your license ID.

Use the -version option 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.26

Replace <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.