The IBM Cloud Manager with OpenStack 4.2.0.1 cmwo 4.2 fix pack 1 Readme

• Update cookbook versions (4.2.0.1)
• Update the deployed topology

IBM Cloud Manager with OpenStack includes a tool that can be used to automatically perform certain environment updates:

• Update cookbook version constraints
• Move attributes - notably options in attributes like misc_nova - when a cookbook change requires different override attributes in the chef environment.

To update an environment named 'my-environment' stored in the chef server use this command:
  knife os manage update environment my-environment

To update a JSON environment file named 'my-environment.json' use this command:
  knife os manage update environment my-environment.json

The file name must end with the '.json' extension. If the file refers to an existing chef environment, the file will also be uploaded to the chef server.

If the fix pack requires other environment changes, you can edit the environment(s) used for your topologies using the following procedure.

Installing the fix pack updates the example environments:
  example-ibm-os-allinone
  example-ibm-os-single-controller-n-compute
  example-ibm-sce

If you have created an environment for your topology, or have created an environment file, these must be updated manually. If you do not do this, future deploys or updates will continue to use the original cookbook.

1. Change to the directory where you have created your topology files.

2. If you do not have your environment file, you can download the current environment from the chef server:
  # knife environment list
  _default
  example-ibm-os-allinone
  example-ibm-os-single-controller-n-compute
  example-ibm-sce
  test-environment

Identify the environment to change, e.g. test-environment and download it:
  # knife environment show test-environment -d -F json > test-environment.json

3. Edit the environment file and modify it as required.

4. Save the file.

5. Upload the modified environment to the chef server:
  # knife environment from file test-environment.json
  Updated Environment test-environment

This fix pack contains cookbook updates which require updates to the chef environment(s) for your topologies.

If any of the following conditions are true, no action is required to update cookbook versions, and you should continue with the next section of this README file.

• You have not created an environment
• You created your environment after installing fix pack 4.2.0.1 or later.
• You updated the cookbook versions for your environment after installing fix pack 4.2.0.1 or later.

Use the 'knife os manage update environment' command as described in 'Automated environment updates' to update your environment or environment file.

This table lists the updated cookbook versions and the fix pack that includes them.

After making the changes described above, update your deployed topology to apply the fixes contained in this fix pack.

If you did not deploy a topology prior to installing this fix pack, no further action is required.

The IBM Cloud Manager with OpenStack Knowledge Center has more information on updating a deployed topology.