Migrating to Tika 4.x
Guides and background for upgrading from Apache Tika 3.x.
Migration Guides
-
Migration Guide — start here: Java version, SPI signatures, JSON configuration, and the API changes every upgrader hits
-
Tika Server Migration — endpoint, wire-format, and configuration changes in tika-server 4.x
-
Metadata Changes — the full 3.x → 4.x key rename tables and the reserved-key write guard
Background Documentation
-
Design Notes — architectural decisions and their rationale
-
Serialization — how JSON configuration is designed and implemented
-
Chunk Strategies — emitting inference chunks to Elasticsearch/OpenSearch
-
Inference Handler Requirements — why inference filters want the MARKDOWN content handler
Not Yet in 4.x
tika-app cannot dump its configuration. These 3.x options are not wired up:
-
--dump-minimal-config- print minimal TikaConfig -
--dump-current-config- print current TikaConfig -
--dump-static-config- print static config -
--dump-static-full-config- print static explicit config
The underlying serialization infrastructure exists (see Serialization); only the CLI integration is missing.
Workaround: write the JSON config by hand, starting from the Tika Pipes config template.