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 is supported on:

Linux x86-64
Windows x86-64

Prerequisites

a valid Chef License key

Upgrade to Chef Infra Client on Linux

To upgrade Chef Infra Client, follow these steps:

On an internet-connected machine, get the download URL for the Chef Infra Client tar package:
```
curl "https://chefdownload-commercial.chef.io/stable/chef-ice/packages?v=<VERSION>&license_id=<LICENSE_ID>"
```
Replace <VERSION> with the Chef Infra Client version number (for example, 19.1.152) and <LICENSE_ID> with your Progress Chef License ID.
The response returns download URLs for different platforms and package types. Use the URL from the linux.<ARCHITECTURE>.tar.url field in the JSON response (for example, linux.x86_64.tar.url if the architecture is x86_64).
Download the Chef Infra Client tar file.
- Download using curl
  Download the tar file using curl:
```
curl -o chef-ice-<VERSION>-linux.tar.gz "<CHEF_TAR_URL>"
```
  Replace:
  - <CHEF_TAR_URL> with the URL from the linux.<ARCHITECTURE>.tar.url field
  - <VERSION> with the Chef Infra Client version number
- Download using Wget
  Download using Wget:
```
wget -O "chef-ice-<VERSION>-linux.tar.gz" "<CHEF_TAR_URL>"
```
  Replace:
  - <CHEF_TAR_URL> with the URL from the linux.<ARCHITECTURE>.tar.url field
  - <VERSION> with the Chef Infra Client version number
On an internet-connected machine, get the latest version of the Chef Infra Client migration tool (migrate-ice).
```
curl "https://chefdownload-commercial.chef.io/stable/migrate-ice/versions/latest?license_id=<LICENSE_ID>"
```
Replace <LICENSE_ID> with your Progress Chef License ID.
The response returns the latest version number.
Download the Chef Infra Client migration tool package.
- Download migration tool with curl
  Download migration tool using curl:
```
curl -o migration-tools-<VERSION>-linux.tar.gz "https://chefdownload-commercial.chef.io/stable/migrate-ice/packages?v=<VERSION>&license_id=<LICENSE_ID>"
```
  Replace:
  - <VERSION> with the version number from the previous step
  - <LICENSE_ID> with your Progress Chef License ID
- Download migration tool with Wget
  Download migration tool using Wget:
```
wget -O "migration-tools-<VERSION>-linux.tar.gz" "https://chefdownload-commercial.chef.io/stable/migrate-ice/packages?v=<VERSION>&license_id=<LICENSE_ID>"
```
  Replace:
  - <VERSION> with the version number from the previous step
  - <LICENSE_ID> with your Progress Chef License ID

Extract the migration tool and make it executable.

tar -xvf migration-tools-<VERSION>-linux.tar.gz -C /path/to/temp/folder
cd /path/to/temp/folder
chmod +x migrate-ice
mv migrate-ice /usr/local/bin/

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

Upgrade to Chef Infra Client on Windows

To upgrade Chef Infra Client, follow these steps:

On an internet-connected machine, get the download URL for the Chef Infra Client tar package:
```
curl "https://chefdownload-commercial.chef.io/stable/chef-ice/packages?v=<VERSION>&license_id=<LICENSE_ID>"
```
Replace <VERSION> with the Chef Infra Client version number (for example, 19.1.152) and <LICENSE_ID> with your Progress Chef License ID.
The response returns download URLs for different platforms and package types. Use the URL from the windows.<ARCHITECTURE>.tar.url field in the JSON response (for example, windows.x86_64.tar.url if the architecture is x86_64).
Download the Chef Infra Client tar file.
- Download Chef Infra Client with curl
  Download the tar file using curl:
```
curl -o chef-ice-<VERSION>-windows.tar.gz "<CHEF_TAR_URL>"
```
- Download Chef Infra Client with PowerShell
  Download using PowerShell:
```
Invoke-WebRequest -Uri "<CHEF_TAR_URL>" -OutFile "chef-ice-<VERSION>-windows.tar.gz"
```
  Replace:
  - <CHEF_TAR_URL> with the URL from the windows.<ARCHITECTURE>.tar.url field
  - <VERSION> with the Chef Infra Client version number
On an internet-connected machine, get the latest version of the Chef Infra Client migration tool (migrate-ice).
```
curl "https://chefdownload-commercial.chef.io/stable/migrate-ice/versions/latest?license_id=<LICENSE_ID>"
```
Replace <LICENSE_ID> with your Progress Chef License ID.
The response returns the latest version number. Use this version to download the migration tool package.
Download the Chef Infra Client migration tool package.
- Download migration tool with curl
  Using curl:
```
curl -o migration-tools-<VERSION>-windows.zip "https://chefdownload-commercial.chef.io/stable/migrate-ice/packages?v=<VERSION>&license_id=<LICENSE_ID>"
```
  Replace:
  - <VERSION> with the version number from the previous step
  - <LICENSE_ID> with your Progress Chef License ID
- Download migration tool with PowerShell
  Using PowerShell:
```
Invoke-WebRequest -Uri "https://chefdownload-commercial.chef.io/stable/migrate-ice/packages?v=<VERSION>&license_id=<LICENSE_ID>" -OutFile "migration-tools-<VERSION>-windows.zip"
```
  Replace:
  - <VERSION> with the version number from the previous step
  - <LICENSE_ID> with your Progress Chef License ID

Extract the migration tool.

mkdir C:\migrate-tool
move "migration-tools-<VERSION>-windows.zip" "C:\migrate-tool\"
move "chef-ice-<CHEF_VERSION>-windows.tar.gz" "C:\migrate-tool\"
cd C:\migrate-tool
Expand-Archive -Path "migration-tools-<VERSION>-windows.zip" -DestinationPath "."

Optional: Verify that the migration tool works.
```
.\migrate-ice --help
```
The migration tool returns available commands and usage guidelines.
Upgrade Chef Infra Client by specifying the path to the tar file using migrate-ice apply.
```
.\migrate-ice apply airgap "C:\migrate-tool\chef-ice-<CHEF_VERSION>-windows.tar.gz"
```
Replace <CHEF_VERSION> with the Chef Infra Client version.
Verify the Chef Infra Client upgrade.
```
chef-client --version
```

Next step

Add a Chef license

More information

Chef Download API documentation