Updating advanced_configuration in a Service Instance

Products

• VMware Tanzu Gemfire

Issue/Introduction

When updating the advanced configuration for your service instance there is a disclaimer stated in the Advanced Service Instance Configuration document, under the Updating a Service Instance with Advanced Configuration section, that states:

This new configuration WILL OVERWRITE any previous advanced configuration that may have been set on the service instance. Any configuration option not set in the advanced_configuration update to the service instance will revert back to the default value.

However, documentation does not state how to find your current advanced_configuration to ensure current values are not overwritten back to default values when updating.

Environment

All Gemfire on Cloud Foundry versions

Resolution

In order to retrieve your current advanced_configuration settings and add or update additional settings perform the following steps:

Retrieve <deployment-name>:

cf service --guid <service-name>

With the above <deployment-name> run the following command to retrieve your manifest.yml with current advanced_configuration section included:

bosh -d service-instance_<deployment-name> manifest

In your manifest.yml file look for the following section:

advanced_configuration:
	server:
        gemfire_properties: {}
		jvm_options: []
		resource_manager:
		credentials: {}
	locator:
		gemfire_properties: {}
		jvm_options: []
		credentials: {}

If any settings are listed in the advanced_configuration section they will need to be included in the following command, along with any updates/additions, in order to ensure that they are not overwritten to default values:

cf update-service SERVICE-INSTANCE -c '{
	"advanced_configuration": {
		"server": {
			"gemfire_properties": {},
			"jvm_options": [],
			"resource_manager": {}
		},
		"locator": {
			gemfire_properties: {},
			jvm_options: [],
			credentials: {}
		}
	}
}’

Current and new settings should be included in the correct location and follow correct JSON syntax.

It is encouraged to backup your current manifest.yml and verify changes were made successfully.