os-conf version conflict when attempting to deploy Metrics.

Products

• Operations Manager

Issue/Introduction

When attempting to install or upgrade Metrics, it fails to deploy with the following error:
 

Error: Runtime manifest specifies release 'os-conf' with version as '20.0.0'. This conflicts with version '21.0.0' specified in the deployment manifest. 

This caused by a mismatch between the os-conf version currently in the bosh runtime (20.0.0), and the version that Metrics expects (21.0.0).

Resolution

This can be resolved by updating the bosh runtime-config to match the version expected by Metrics. To do so:

1. Retrieve the current runtime config with bosh runtime-config > runtime.yml
2. Open runtime.yml, and under the releases section, look for os-conf. 

   releases:
   
   - name: os-conf
   
   version: 20.0.0
   

3. Update the version to match what is expected by Metrics. In our example, as seen in the error message, it is expecting 21.0.0 

   releases:
   
   - name: os-conf
   
   version: 21.0.0

4. Finally, update the bosh runtime config: 

   bosh update-runtime-config runtime.yml
   

You should now be able to successfully apply changes on Metrics.