Skip to main content

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:

  1. In the Admin Console, select the Version history tab.

  2. Select Check for update to manually check for new versions of the application.

    After the Admin Console downloads an update, a new upstream version displays in the list of available versions.

    Version history pane showing installed and deployed versions of Chef 360 Platform.

  3. Optional, if there are multiple versions of an application, 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.

  4. Select Configure to begin the configuration and deployment step for that version.

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.

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

  1. Get the latest supported skill versions from the release notes.

  2. 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 =
  3. 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:

  1. Get the latest supported skill versions from the release notes.

  2. Navigate to the Skill Assembly page in the Chef 360 Platform UI.

  3. Next to the name of the skill assembly that you want to update, select the assembly’s submenu and then Update.

  4. In the Create Skill Assembly page, enter the skills and skill versions that you want to add or remove from the skill assembly.

  5. Select Update to save your changes to the skill assembly.

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

Thank you for your feedback!

×