Update Chef 360 Platform in an airgapped environment

To update Chef 360 Platform in an airgapped environment, you can upload a new bundle to the Admin Console using a browser or by using the Chef 360 Platform embedded cluster binary.

Update using the Admin Console

To upload a new version of Chef 360 Platform in an airgapped environment, follow these steps:

1. On a computer with internet access, download the airgapped bundle:

   curl \
      https://<DOWNLOAD_DOMAIN>/embedded/chef-360/<RELEASE_CHANNEL>/<RELEASE_VERSION>?airgap=true \
      -H "Authorization: <AUTHORIZATION_CODE>" \
      -o chef-360.tgz
   

2. Extract the installer.

   tar -xvzf chef-360.tgz
   

   Make sure that the chef-360.airgap bundle is present after extraction.

3. Log into the Admin Console.

4. On the Version history page, select Upload new version and then select the chef-360.airgap bundle that you downloaded.

5. Once the airgapped bundle is uploaded, select Deploy next to the new version.

   The Admin Console opens a configuration update wizard.

6. In the update wizard Config pane, review and update the application configuration as needed. After you’ve reviewed the configuration, select Next.

7. On the Preflight pane, review the results of the preflight checks. If all checks pass, select Next: Confirm and Deploy to proceed.

8. On the Confirm pane, select Deploy to initiate the update process.

Update using the command line

To update Chef 360 Platform using the command line, follow these instructions:

1. SSH onto a controller node in the cluster and download the new Chef 360 Platform airgapped bundle:

   curl \
      https://<DOWNLOAD_DOMAIN>/embedded/chef-360/<RELEASE_CHANNEL>/<RELEASE_VERSION>?airgap=true \
      -H "Authorization: <AUTHORIZATION_CODE>" \
      -o chef-360.tgz
   

2. Extract the installer:

   tar -xvzf chef-360.tgz
   

   Make sure that the chef-360.airgap bundle is present after extraction.

3. Upload the airgapped bundle and make this new version available in the Admin Console using the update command:

   sudo ./chef-360 update --airgap-bundle chef-360.airgap
   

4. After you’ve uploaded the airgapped bundle, open a browser on the same computer and navigate to the Admin Console.

5. On the Version history page, select Deploy next to the new version.

6. Once the airgapped bundle is uploaded, select Deploy next to the new version.

   The Admin Console opens a configuration update wizard.

7. In the update wizard Config pane, review and update the application configuration as needed. After you’ve reviewed the configuration, select Next.

8. On the Preflight pane, review the results of the preflight checks. If all checks pass, select Next: Confirm and Deploy to proceed.

9. On the Confirm pane, select Deploy to initiate the update process.