How to retrieve the Bosh director manifest

Products

• Operations Manager

Issue/Introduction

The Bosh director manifest and state file can be found on the Ops Manager VM in the directory /var/tempest/workspaces/default/deployments among other deployment files, where the Bosh director manifest is called bosh.yml and state file is called bosh-state.json . However, the Bosh director manifest is automatically deleted after the Apply Changes so it is not always possible to retrieve it from that directory.

In some scenarios, like for example overriding manifest properties in Advanced Mode of Ops Manager, it is a good practice to take a back up of the Bosh director manifest. This article covers multiple ways to retrieve the manifest.

Environment

Product Version: 2.10

Resolution

The following are the multiple options to retrieve the Bosh director manifest:

Option 1
Since the manifest at /var/tempest/workspaces/default/deployments/bosh.yml is automatically deleted after the Apply Changes is completed, you can copy it at the time when the Apply Changes is in progress.

Open a terminal, SSH into the Ops Manager VM, navigate to the correct directory and run the cp command once you see the following line being generated in the Apply Changes log:

===== 2022-04-12 12:51:35 UTC Running "/usr/local/bin/bosh --no-color --non-interactive --tty create-env --skip-drain /var/tempest/workspaces/default/deployments/bosh.yml"
Deployment manifest: '/var/tempest/workspaces/default/deployments/bosh.yml'

 

Option 2
The Support Bundle from Ops Manager contains logs, diagnostics, manifests and configs, including most recent and last successful Bosh director manifests. Follow below steps to download the Support Bundle from Ops Manager:

1. Navigate to Ops Manager UI main page.
2. On the bottom right, click on the “Support” link.
3. On the prompt which opens, click “Download”.

The manifests can be found inside the folder support_bundle_XXX/deployed_manifest_and_configs/p-bosh-XXX 

Option 3
The manifest can be retrieved using Ops Man API . First, you will need to access the Ops Manager API by following the procedure described in the documentation and retrieve an authorization token with the uaac contexts command. With the retrieved UAA access token, it is possible to perform Ops Manager API calls. Use the following command to retrieve the Bosh director manifest:

curl "https://<OPSMAN-FQDN>/api/v0/deployed/director/manifest" \
    -X GET \
    -H "Authorization: Bearer <UAA-ACCESS-TOKEN>"