Skip to content

Commit

Permalink
update FAQ
Browse files Browse the repository at this point in the history
  • Loading branch information
mfvitale authored Oct 14, 2024
1 parent f4f5df2 commit fcd2087
Showing 1 changed file with 9 additions and 6 deletions.
15 changes: 9 additions & 6 deletions documentation/faq.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -388,13 +388,16 @@ link:/documentation/reference/stable/connectors/mongodb.html#mongodb-property-cu

== Debezium engine applications fails with "Unable to find minimal snapshot lock mode. Please check your configuration" error

Debezium uses the SPI via the ServiceLoader to load different implementations depending on the connector type or for custom implementations.
Debezium uses uses the SPI via the ServiceLoader to load the implementation.
The implementation can be based on the connector type, or it can be a custom implementation.

When an interface has multiple implementations — for instance, `io.debezium.snapshot.spi.SnapshotLock`, which has a default implementation in the core and specific ones for each connector — you must explicitly configure your build tools to merge the `META-INF/services files`.
If this step is missed, Debezium may fail to locate the required implementation.
Some interfaces have multiple implementations.
For example, `io.debezium.snapshot.spi.SnapshotLock` has a default implementation in the core, and specific implementations for each connector.
To ensure that Debezium can locate the required implementation, you must explicitly configure your build tools to merge the `META-INF/services files`.

To address this, instruct your build tools accordingly. For example, if you are using the https://maven.apache.org/plugins/maven-shade-plugin[Maven shade plugin],
you need to add the https://maven.apache.org/plugins/maven-shade-plugin/examples/resource-transformers.html#ServicesResourceTransformer[`ServicesResourceTransformer`] transformer:

For example, if you are using the https://maven.apache.org/plugins/maven-shade-plugin[Maven shade plugin],
add the https://maven.apache.org/plugins/maven-shade-plugin/examples/resource-transformers.html#ServicesResourceTransformer[`ServicesResourceTransformer`] transformer, as shown in the following example:

[source,xml]
----
Expand All @@ -409,4 +412,4 @@ you need to add the https://maven.apache.org/plugins/maven-shade-plugin/examples
</configuration>
----

Alternatively, if using the https://maven.apache.org/plugins/maven-assembly-plugin/index.html[Maven Assembly plug-in] you can utilize the https://maven.apache.org/plugins/maven-assembly-plugin/examples/single/using-container-descriptor-handlers.html[metaInf-services container descriptor handlers].
Alternatively, if you use the https://maven.apache.org/plugins/maven-assembly-plugin/index.html[Maven Assembly plug-in], you can use the https://maven.apache.org/plugins/maven-assembly-plugin/examples/single/using-container-descriptor-handlers.html[metaInf-services container descriptor handlers].

0 comments on commit fcd2087

Please sign in to comment.