Skip to content

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

Draft
dephekt wants to merge 2 commits into
mainfrom
img-3773-solr-modules-config
Draft

docs(solr): document configuration.modules for solr 9.9+#5563
dephekt wants to merge 2 commits 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

Copy link
Copy Markdown
Collaborator

@catplat catplat left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@catplat catplat marked this pull request as draft May 14, 2026 23:10
@dephekt
Copy link
Copy Markdown
Member Author

dephekt commented May 21, 2026

Just following up if this is ready to be merged? Or if you need any info from me.

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.

3 participants