enable_human_readable_name for BOSH VM managed

Products

• Operations Manager

Issue/Introduction

With this feature enabled, when a new BOSH VM managed is created, it will be assigned to a name like instance-group-name_deployment-name_a81a26b3a9a8 instead of a name like vm-d6f0f537-18cd-4a1b-b0f5-ae03e8f590e8. BOSH documentation:
 

• https://bosh.io/docs/vsphere-human-readable-names/

Environment

Product Version: 2.10

Resolution

You can use the om cli tool (https://github.com/pivotal-cf/om) to make the Ops Manager API call:

$ om -e <ENV.yml> curl -p "https://<OPSMAN_URL>/api/v0/staged/director/iaas_configurations/<DIRECTOR_ID>" -x PUT -H "Content-Type: application/json" -d '{"iaas_configuration":{"additional_cloud_properties":{"enable_human_readable_name": true}}}'

ENV.yml file contains the credential. For example:

---
target: https://<OPSMAN_URL>
connect-timeout: 30
request-timeout: 1800
skip-ssl-validation: true
username: admin
password: <ADMIN_PASS>

Next, Apply Change and Ops Manager will recreate the BOSH director. The feature will be applied to any new BOSH VM managed. If you want to apply it to an existing deployment, you will need to recreate the VMs (Ops Manager -> Bosh director tile -> Director Config -> Recreate VMs deployed by the BOSH Director) or you can also retrieve the deployment manifest and use the --recreate flag with BOSH cli:

$ bosh -d pivotal-container-service-12345 manifest > pivotal-container-service-12345.yml

$ bosh -d pivotal-container-service-12345 deploy pivotal-container-service-12345.yml --recreate