Back to Conductor

OpenSearch Persistence - DEPRECATED

os-persistence/README.md

2019-04-12-13001.8 KB
Original Source

OpenSearch Persistence - DEPRECATED

⚠️ This module is deprecated and provides only a migration error message.

What Happened?

The generic conductor.indexing.type=opensearch configuration has been replaced with version-specific modules:

  • os-persistence-v2 - For OpenSearch 2.x
  • os-persistence-v3 - For OpenSearch 3.x

This change enables proper dependency isolation between OpenSearch 2.x and 3.x clients, which use incompatible package namespaces.

Migration

Change your configuration from:

properties
conductor.indexing.type=opensearch
conductor.opensearch.url=http://localhost:9200

To one of:

properties
# For OpenSearch 2.x
conductor.indexing.type=opensearch2
conductor.opensearch.url=http://localhost:9200
properties
# For OpenSearch 3.x
conductor.indexing.type=opensearch3
conductor.opensearch.url=http://localhost:9200

All other conductor.opensearch.* properties remain the same.

Why the Change?

  • OpenSearch 2.x and 3.x clients use identical package names (org.opensearch.client.*)
  • Having both on the classpath causes conflicts
  • Version-specific modules use shadow plugin to relocate packages and avoid conflicts
  • Follows the same pattern as es6-persistence and es7-persistence

Legacy Code Reference

If you need the original OpenSearch 1.x persistence module code for reference, it has been archived at:

https://github.com/conductor-oss/conductor-os-persistence-v1

Note: The archived module is no longer maintained and should not be used in production.

See Also