Upgrade Chef Infra Client to version 19 RC2 using the migration tool in an airgapped environment

This page documents how to upgrade Chef Infra Client to version 19 RC2 in an airgapped environment.

Supported platforms

Chef Infra Client 19 RC2 is supported on Linux x86-64 systems.

Prerequisites

a valid Chef License key

Install Chef Infra Client

To install Chef Infra Client, follow these steps:

On an internet-connected machine, download the Chef Infra Client 19 RC2 tar file.

Chef Infra Client is available in a zipped tar file using a pre-signed URL from an S3 bucket until August 26, 2025.

Download using curl:

curl -o chef-chef-infra-client-19.1.rc2.tar.gz https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_tar_folder/chef-chef-infra-client-19.1.rc2.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=Q91HiSIzOxffl52La8EvqSXSqWk%3D&Expires=1756222682

Download using Wget:

wget -O "chef-chef-infra-client-19.1.rc2.tar.gz" https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_tar_folder/chef-chef-infra-client-19.1.rc2.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=Q91HiSIzOxffl52La8EvqSXSqWk%3D&Expires=1756222682

On an internet-connected machine, download the Chef Infra Client migration tool.

The migration tool is available for download as a zipped tar file using a pre-signed URL from an S3 bucket until August 26, 2025.

Using curl:

curl -o chef-migration-tool.v1.tar.gz https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_migration_tool/migration-tools_Linux_x86_64.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=hbgCCCl9r48WHDP%2FFQtNTN9pFJw%3D&Expires=1756222424

Using Wget:

wget -O "chef-migration-tool.v1.tar.gz" https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_migration_tool/migration-tools_Linux_x86_64.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=hbgCCCl9r48WHDP%2FFQtNTN9pFJw%3D&Expires=1756222424

Extract the migration tool and make it executable.

tar -xvf chef-migration-tool.v1.tar.gz -C /path/to/temp/folder
cd /path/to/temp/folder
chmod +x chef-migrate-cli
mv chef-migrate-cli /usr/local/bin/

Optional: Verify that the migration tool is installed.
```
chef-migrate --help
```
The migration tool returns available commands and usage guidelines.
Install Chef Infra Client by specifying the path to the tar file using chef-migrate apply.
```
chef-migrate apply airgap <PATH/TO/BUNDLE> --license-key "<LICENSE_KEY>"
```
Replace:
- <PATH/TO/BUNDLE> with the path to the Chef Infra Client tar file.
- <LICENSE_KEY> with your Progress Chef License key.
Verify that Chef Infra Client is installed.
```
chef-client --version
```

Next step

Add a Chef license