Skip to main content

Upgrade Chef Infra Client to version 19 RC3 using the migration tool in an air-gapped environment

This page documents how to upgrade Chef Infra Client to version 19 RC3 in an air-gapped environment.

Supported platforms

Chef Infra Client 19 RC3 is supported on:

  • Linux x86-64
  • Windows x86-64

Prerequisites

  • a valid Chef License key

Upgrade to Chef Infra Client 19 RC3 on Linux

To upgrade Chef Infra Client, follow these steps:

  1. On an internet-connected machine, download the Chef Infra Client 19 RC3 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"

  2. 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"

  3. 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
mv chef-migrate /usr/local/bin/

  4. Optional: Verify that the migration tool is installed.

    chef-migrate --help

    The migration tool returns available commands and usage guidelines.

  5. Install Chef Infra Client by specifying the path to the tar file using chef-migrate apply.

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

  6. Verify that Chef Infra Client is installed.

    chef-client --version

Upgrade to Chef Infra Client 19 RC3 on Windows

To upgrade Chef Infra Client, follow these steps:

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

    Chef Infra Client is available in a tar file using a pre-signed address 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/Windows/chef-chef-infra-client-19.1.rc2.windows.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=VCLjoJMbgSC%2Fkos4P%2BR2Ikm0Jww%3D&Expires=1767840014"

    Download using PowerShell:

    Invoke-WebRequest -Uri "https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_tar_folder/Windows/chef-chef-infra-client-19.1.rc2.windows.tar.gz?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=VCLjoJMbgSC%2Fkos4P%2BR2Ikm0Jww%3D&Expires=1767840014" -OutFile "chef-chef-infra-client-19.1.rc2.tar.gz"

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

    The migration tool is available for download as a ZIP file using a pre-signed address from an S3 bucket until January 21, 2026.

    Using curl:

    curl -o chef-migration-tool.v1.zip "https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_migration_tool/Windows/migration-tools_Windows_x86_64.zip?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=i5K3bQIqD35chzrTtS2uerU7ZDE%3D&Expires=1768953772"

    Using PowerShell:

    Invoke-WebRequest -Uri "https://chef-hab-migration-tool-bucket.s3.amazonaws.com/rc2_hab_pkg_chef_client/rc2_migration_tool/Windows/migration-tools_Windows_x86_64.zip?AWSAccessKeyId=AKIAW4FPVFT6BIP2EQW7&Signature=i5K3bQIqD35chzrTtS2uerU7ZDE%3D&Expires=1768953772" -OutFile "chef-migration-tool.v1.zip"

  3. Extract the migration tool.

    mkdir C:\migrate-tool
move "chef-migration-tool.v1.zip" "C:\migrate-tool\"
move "chef-chef-infra-client-19.1.rc2.tar.gz" "C:\migrate-tool\"
cd C:\migrate-tool
Expand-Archive -Path "chef-migration-tool.v1.zip" -DestinationPath "."

  4. Optional: Verify that the migration tool works.

    .\chef-migrate --help

    The migration tool returns available commands and usage guidelines.

  5. Upgrade Chef Infra Client by specifying the path to the tar file using chef-migrate apply.

    .\chef-migrate apply airgap "C:\migrate-tool\chef-chef-infra-client-19.1.rc2.tar.gz" --license-key "<LICENSE_KEY>"

    Replace <LICENSE_KEY> with your Progress Chef License key.

  6. Verify the Chef Infra Client upgrade.

    chef-client --version

Next step

Thank you for your feedback!

×