Overriding manifest properties in Advanced Mode

This topic describes how you can use Advanced Mode to override some manifest properties that you cannot change through the VMware Tanzu Operations Manager UI or API.

Tanzu Operations Manager is an interface to the BOSH Director manifest and the runtime configs that underlie VMware Tanzu. Tanzu Operations Manager does not allow you to edit the manifest and configs directly.

When you configure Tanzu Operations Manager through the UI or API, you set many of the properties contained in the manifest and configs. Tanzu Operations Manager sets some other properties for you, and other properties use the default values provided by VMware Tanzu or BOSH.

Use the manifest property override feature described in this topic to modify properties that cannot be modified in other ways.

Procedure

To override manifest properties:

1. If the property that you want to change can be modified through the Tanzu Operations Manager UI or the Tanzu Operations Manager API, use the UI or API to change the property.

2. If the property cannot be modified through the Tanzu Operations Manager UI or the Tanzu Operations Manager API:

   1. Verify if the property is overridden. See Overridable properties.
   2. If the property is in the BOSH Director Manifest, see Override BOSH Director manifest properties.
   3. If the property is in one of the runtime configs, see Override Runtime Config properties.

You can also use the Tanzu Operations Manager API to view the BOSH Director manifest, view the list of overrides for the BOSH Director and runtime configs, and delete the overrides.

Overridable properties

You can edit properties in the BOSH Director manifest, another tile manifest, or two of the runtime configs.

BOSH Director manifest

In the BOSH Director manifest, you can override properties in the following sections:

• network
• instance_group jobs

You cannot:

• Edit properties in other sections of the BOSH Director manifest
• Add or delete a network
• Add or delete an instance group

For an example, see Change the Network type to dynamic.

Tile manifest

In the tile manifest, you can override properties in the following sections:

• features
• update

For example, see Change number of Canary instances or Enable returning DNS addresses in links.

Runtime configs

You can edit properties in two add-ons in each of two of the runtime configs files. The table below lists these properties:

Runtime Config	Add-on
ops_manager_dns_runtime	bosh_dns bosh_dns_windows
ops_manager_system_metrics_runtime	system_metrics_agent system_metrics_agent_windows

Override BOSH Director manifest properties

To override properties in the BOSH Director manifest:

1. Set Tanzu Operations Manager to Advanced Mode.

   VMware recommends that only skilled operators use Advanced Mode in Tanzu Operations Manager. If you use Advanced Mode incorrectly, you can deactivate or destroy your deployment. Tanzu Operations Manager does not validate the properties that you change using Advanced Mode. For example, if you enter a string where an integer is required, you do not receive an error.

2. Use the /api/v0/staged/director/overrides endpoint.

3. After you complete your changes, deactivate Advanced Mode by following the procedure in VMware Tanzu Support documentation.

Override tile manifest properties

To override properties in the tile manifest:

1. Set to Advanced Mode by following the procedure in VMware Tanzu Support documentation. For more information about Advanced Mode, see Advanced Mode in the Tanzu Operations Manager API documentation.

   VMware recommends that only skilled operators use Advanced Mode in . If you use Advanced Mode incorrectly, you can deactivate or destroy your deployment. and it does not validate the properties that you change using Advanced Mode. For example, if you enter a string where an integer is required, you do not receive an error.

2. Use the /api/v0/staged/products endpoint to get and record the product GUID from the output of the command. For more information, see All staged products in the Tanzu Operations Manager API documentation.

3. Use the /api/v0/staged/products/PRODUCT-GUID/overrides endpoint. Where PRODUCT-GUID is the GUID you recorded earlier in this procedure.

4. After you complete your changes, deactivate Advanced Mode by following the procedure in Custom VM Extensions.

Override runtime config properties

To override properties in the runtime configs:

1. Set to Advanced Mode by following the procedure in How to Enable Advanced Mode in Tanzu Operations Manager.

   VMware recommends that only skilled operators use Advanced Mode in . If you use Advanced Mode incorrectly, you can deactivate or destroy your deployment. It does not validate the properties that you change using Advanced Mode. For example, if you enter a string where an integer is required, you do not receive an error.

2. Use the /api/v0/staged/director/runtime_configs/overrides endpoint. For more information, see:

   • BOSH DNS job spec in GitHub. This file shows the properties and defaults for the bosh_dns add-on in the ops_manager_dns_runtime.
   • Provide a new list of runtime config overrides for the BOSH Director.

3. After you complete your changes, deactivate Advanced Mode.

Examples of overridable properties

This section contains examples of properties that customers have asked to override.

BOSH Director manifest example: change the network type to Dynamic

By default, the network type is set to manual. You cannot change this property through the UI or API.

You can override this default by changing the value of the type property in the networks section of the BOSH Director manifest.

Tile manifest example: change number of canary instances

By default, the number of canary instances is set to 1. You cannot change this property through the UI or API.

You can override this default by changing the number of canary instances in the update section of the tile manifest.

For a list of all the properties you can change in the update section, see Update Block in the BOSH documentation.

Tile manifest example: enable returning DNS addresses in links

By default, use_dns_addresses is set to false. You cannot change this property through the UI or API.

You can override this default by changing the value to true in the features section of the tile manifest.

For a list of all the properties you can change in the features section, see Features block in the BOSH documentation.

Runtime config example: change the timeout for the BOSH DNS network health check

By default, the network timeout for synchronous health checks is 1 second. You cannot change this property through the UI or API.

You can override this default by changing the value of the health.health.synchronous_check_timeout property in the bosh-dns add-on of the ops_mananger_dns_runtime runtime config.