Update Chef 360 Platform in an air-gapped environment

To update Chef 360 Platform in an air-gapped environment, upload a new bundle to the Admin Console. You can do this through the web interface or using the command line.

Choose one of these update methods:

Admin Console web interface
Command line

Update Chef 360 Platform from the Admin Console

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

On a computer with internet access, download the air gap bundle:

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

Extract the installer:
```
tar -xvzf chef-360.tgz
```
Ensure that the chef-360.airgap bundle is present after extraction.
Log in to the Admin Console.
On the Version history page, select Upload new version, and then select the chef-360.airgap bundle that you downloaded.
Once the air gap bundle is uploaded, select Deploy next to the new version.
The Admin Console opens a configuration update wizard.
In the update wizard Config pane, review and update the application configuration as needed. After reviewing the configuration, select Next.
On the Preflight pane, review the results of the preflight checks. If all checks pass, select Next: Confirm and Deploy to proceed.
On the Confirm pane, select Deploy to initiate the update process.

Update Chef 360 Platform from the command line

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

SSH onto a controller node in the cluster and download the new Chef 360 Platform air gap bundle:

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

Extract the installer:
```
tar -xvzf chef-360.tgz
```
Ensure that the chef-360.airgap bundle is present after extraction.
Upload the air gap bundle and make this new version available in the Admin Console using the update command:
```
sudo ./chef-360 update --airgap-bundle chef-360.airgap
```
After uploading the air gap bundle, open a browser on the same computer and navigate to the Admin Console.
On the Version history page, select Deploy next to the new version.
The Admin Console opens a configuration update wizard.
In the update wizard Config pane, review and update the application configuration as needed. After reviewing the configuration, select Next.
On the Preflight pane, review the results of the preflight checks. If all checks pass, select Next: Confirm and Deploy to proceed.
On the Confirm pane, select Deploy to initiate the update process.

Update skills

After you update Chef 360 Platform, update your skill assembly so you’re running the latest skills on your nodes. You can update your skills using either the Chef 360 Platform web UI or the node-management-cli tool.

Update Habitat packages on on-prem Builder

To update your skills, first update the skill packages on your on-prem Chef Habitat Builder deployment. For more information, see the Update packages on Habitat Builder documentation.

Update skill assembly

You can use the Chef 360 Platform web UI or the or the node-management-cli tool to update a skill assembly.

To up a skill assembly, you must use a profile that has the node-manager role.

Update skills with CLI
Update skills with web UI

To update your skill assembly with new skill versions, follow these steps:

Get the latest supported skill versions from the release notes.
Create a JSON file that defines the skills you want to add and remove from your skill assembly. You can define all the skill versions that you want to add and remove from a skill assembly in the same JSON file.
Use the add and remove actions to add and remove skills. For example:
```
{
  "name": "<SKILL_ASSEMBLY_NAME>",
  "skills": [
    {
      "action": "add",
      "skill": {
        "channel": "stable",
        "name": "<SKILL_NAME>",
        "value": ["<ADD_VERSION>"]
      }
    },
    {
      "action": "remove",
      "skill": {
        "channel": "stable",
        "name": "<SKILL_NAME>",
        "value": ["<OPERATOR> <REMOVE_VERSION>"]
      }
    }
  ]
}
```
Replace:
- <SKILL_ASSEMBLY_NAME> with the skill assembly name
- <SKILL_NAME> with the name of the skill, for example shell-interpreter
- <ADD_VERSION> with the skill version you want to add
- <REMOVE_VERSION> with the skill version you want to remove
- <OPERATOR> with a logical operator, for example <, >, or =
Use the assembly update-assembly subcommand to update the skill assembly:
```
chef-node-management-cli management assembly update-assembly \
  --skillAssemblyId <SKILL_ASSEMBLY_ID> \
  --body-file <PATH_TO_JSON_FILE> \
  --profile <NODE_MANAGER_PROFILE_NAME>
```
Replace:
- <SKILL_ASSEMBLY_ID> with the skill assembly ID
- <PATH_TO_JSON_FILE> with the path to skill assembly JSON file
- <NODE_MANAGER_PROFILE_NAME> with the name of a profile that has the node-manager role

For more information, see the skill assembly documentation.

To update a skill assembly in the Chef 360 Platform web UI, follow these steps:

Get the latest supported skill versions from the release notes.
Navigate to the Skill Assembly page in the Chef 360 Platform UI.
Next to the name of the skill assembly that you want to update, select the assembly’s submenu and then Update.
In the Create Skill Assembly page, enter the skills and skill versions that you want to add or remove from the skill assembly.
Select Update to save your changes to the skill assembly.

Chef 360 Platform will add and remove skills that are assigned that skill assembly.