Skip to content

docs(solr): document configuration.modules for solr 9.9+#5563

Open
dephekt wants to merge 1 commit into
mainfrom
img-3773-solr-modules-config
Open

docs(solr): document configuration.modules for solr 9.9+#5563
dephekt wants to merge 1 commit into
mainfrom
img-3773-solr-modules-config

Conversation

@dephekt
Copy link
Copy Markdown
Member

@dephekt dephekt commented May 8, 2026

Solr 9.8 made directives in solrconfig.xml opt-in (need -Dsolr.config.lib.enabled=true), and 10.0 (SOLR-16781) removed the handling code entirely. The replacement on 9.8+ is the SOLR_MODULES environment variable (docs), which the Solr service agent now renders from a new customer-controlled configuration.modules field on the 9.9 and 10.0 manifests.

Document the new field on both the Platform.sh and Upsun Solr service pages so customers upgrading from 9.6 (most notably Drupal + search_api_solr users, who rely on bundled modules like extraction and analysis-extras) know exactly what to add to services.yaml. Pre-9.9 versions are unaffected and continue to load modules from directives, so customers staying on 9.6 do not need to change anything.

The new section sits between "Default configuration" and "Limitations" under "Solr 6 and later" rather than rewriting the existing "Available plugins" table, which describes the unconditional JTS and ICU4J classpath additions handled by the agent's post-install hook (a separate concern from the bundled-modules opt-in story).

Solr 9.8 made <lib> directives in solrconfig.xml opt-in (need
-Dsolr.config.lib.enabled=true), and 10.0 (SOLR-16781) removed the
handling code entirely. The replacement on 9.8+ is the SOLR_MODULES
environment variable, which the Solr service agent now renders from a
new customer-controlled configuration.modules field on the 9.9 and 10.0
manifests.

Document the new field on both the Platform.sh and Upsun Solr service
pages so customers upgrading from 9.6 (most notably Drupal +
search_api_solr users, who rely on bundled modules like extraction and
analysis-extras) know exactly what to add to services.yaml. Pre-9.9
versions are unaffected and continue to load modules from <lib>
directives, so customers staying on 9.6 do not need to change anything.

The new section sits between "Default configuration" and "Limitations"
under "Solr 6 and later" rather than rewriting the existing "Available
plugins" table, which describes the unconditional JTS and ICU4J
classpath additions handled by the agent's post-install hook (a
separate concern from the bundled-modules opt-in story).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 8, 2026

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants