All Products
Search
Document Center

OpenSearch:Manage online configurations

Last Updated:Apr 01, 2026

Online configurations control cluster runtime behavior. Each set of configuration parameters is saved as a versioned snapshot — an online configuration version — so you can track changes and apply a specific version to your cluster.

Version states

Each online configuration version is in one of two states:

StateMeaningAvailable actions
In UseThe version is currently applied to the clusterView, modify (generates a new version)
UnusedThe version exists but is not applied to the clusterView, modify, delete

Modify an online configuration version

Modifying a published version always creates a new version — the original is not changed. Only the latest draft is saved during editing.

  1. On the instance details page, choose Configuration Management > Cluster Configuration in the left-side pane, then click the Online Configurations tab.

  2. Find the version to view or modify and click View or Modify in the Actions column. Then find the configuration file to view or update and click View or Modify in the Actions column.

  3. Find the parameter to change and click Modify in the Actions column to view or modify it.

  4. After making your changes, click Publish New Version. This saves the changes as a new, immutable online configuration version.

    After a version is published, its content cannot be changed. To update a published version, repeat this workflow — a new version is generated each time.
  5. Go to the Cluster Management page. In the Configuration Information section, click Update. In the Update Cluster Configuration panel, select the new version and apply it.

  6. Track the update progress on the Change History page in the Extended Features module.

Delete an online configuration version

Only versions in the Unused state can be deleted. Versions in the In Use state cannot be deleted.

  1. On the Cluster Configuration page, click the Online Configurations tab.

  2. Find the version in the Unused state and click Delete in the Actions column.

Usage notes

  • After an online configuration version is published, you can no longer change the configuration content.

  • You can modify a published online configuration version to generate a new online configuration version.

  • When you modify a published online configuration version, the system saves only the latest draft version.

  • You can delete only online configuration versions that are in the Unused state. You cannot delete online configuration versions that are in the In Use state.