Upgrade Chef Infra Client to version 19 RC3 using the migration tool in an online environment

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

Supported platforms

Chef Infra Client is supported on:

Linux x86-64
Windows x86-64

Prerequisites

a valid Chef License key

Upgrade Chef Infra Client on Linux

To upgrade Chef Infra Client, follow these steps:

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 migration tool using curl or Wget.
- Download migration tool with curl
  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
  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.
Upgrade Chef Infra Client using migrate-ice apply.
You can upgrade Chef Infra Client by specifying a download URL or a version number.
- Specify download URL
```
sudo migrate-ice apply online --download-url "<CHEF_TAR_DOWNLOAD_URL>"
```
  Replace <CHEF_TAR_DOWNLOAD_URL> with the Chef Infra Client package download URL.
- Specify version number
```
sudo migrate-ice apply online --chef-version <VERSION> --license-key "<LICENSE_KEY>"
```
  Replace:
  - <VERSION> with the Chef Infra Client version number (for example, 19.1.150)
  - <LICENSE_KEY> with your Progress Chef License key.
Verify that Chef Infra Client is installed.
```
chef-client --version
```

Upgrade Chef Infra Client on Windows

To upgrade Chef Infra Client, follow these steps:

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 migration tool.
- 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\"
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 using migrate-ice apply.
You can upgrade Chef Infra Client by specifying the download URL or a version number.
- Specify download URL
```
.\migrate-ice apply online --download-url "<CHEF_TAR_DOWNLOAD_URL>"
```
  Replace <CHEF_TAR_DOWNLOAD_URL> with the Chef Infra Client package download URL.
- Specify version number
```
.\migrate-ice apply online --chef-version <VERSION> --license-key "<LICENSE_KEY>"
```
  Replace:
  - <VERSION> with the Chef Infra Client version number (for example, 19.1.150)
  - <LICENSE_KEY> with your Progress Chef License key
Verify the Chef Infra Client upgrade.
```
chef-client --version
```

Next step

Add a Chef license

More information

Chef Download API documentation