Install Chef Infra Client using the migration tool in an online environment

This page documents how to install Chef Infra Client 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

Install Chef Infra Client on Linux

To install Chef Infra Client on Linux, follow these steps:

Optional: Verify that Chef Infra Client isn’t already installed on your system:
```
chef-client --version
```
Get the latest version number of the 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.
Download the Chef Infra Client migration tool using curl or Wget.
- Download migration tool with curl
  Download the 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 the 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 using migrate-ice apply:
You can install Chef Infra Client using specifying a download URL or an Infra Client version number.
- Specify download URL
```
sudo migrate-ice apply online --fresh-install --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 --fresh-install --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 installation.
```
chef-client --version
```

Install Chef Infra Client on Windows

To install Chef Infra Client on Windows, follow these steps:

Optional: Verify that Chef Infra Client isn’t already installed on your system:
```
chef-client --version
```
Get the latest version number of the 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.
Download the migration tool using curl or PowerShell:
- Download migration tool with curl
  Download the migration tool 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
  Download the migration tool 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.
Install Chef Infra Client using migrate-ice apply:
You can install Chef Infra Client using specifying a download URL or an Infra Client version number.
- Specify download URL
```
.\migrate-ice apply online --fresh-install --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 --fresh-install --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 installation.
```
chef-client --version
```

Next step

Add a Chef license

More information

Chef Download API documentation