Manually update Chef 360 Platform in an online environment

You can manually update Chef 360 Platform in the Version history tab of the Admin Console.

Manually update Chef 360 Platform

To manually update Chef 360 Platform in an online environment, follow these steps:

In the Admin Console, select the Version history tab.
Select Check for update to manually check for new versions of Chef 360 Platform.
After the Admin Console downloads an update, a new upstream version displays in the list of available versions.
Optional, if there are multiple versions of Chef 360 Platform, you can compare the changes between them by selecting Diff versions in the top-right corner. You can review changes between any two arbitrary releases by selecting the icon in the header of the release column. Select the two versions to compare, and select Diff versions to show the relative changes between the two releases.
Select Deploy next the Chef 360 Platform version you’d like to deploy.
In the Config pane, review and update the Chef 360 Platform settings as needed. After reviewing the configuration, select Next.
In the Preflight pane, review the results of the preflight checks.
If the preflight checks pass, select Next: Confirm and Deploy to proceed.
If the preflight checks fail, choose one of the following options:
- Adjust your system settings:
  1. Select Back: Config.
  2. Update your configuration by increasing system resources to meet the requirements or by disabling strict mode.
  3. After updating configuration, select Next to navigate to the Preflight Checks page, then select Rerun to run the preflight checks again.
- Cancel the upgrade and restart with new settings:
  1. Select Cancel to exit the upgrade process.
  2. Increase system resources or review your strict mode settings.
  3. Restart the upgrade process when you’re ready.
In the Confirm pane, select Deploy to start 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.

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.