Skip to content

fix: point Windows users at the option fess.in.bat actually reads for the engine URL - #3475

Merged
marevol merged 2 commits into
mainfrom
fix/search-engine-url-windows-hint
Sep 23, 2026
Merged

marevol merged 2 commits into
mainfrom
fix/search-engine-url-windows-hint

Conversation

@marevol

@marevol marevol commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

Summary

When no search engine address is configured, SearchEngineClient.open() fails startup with a message telling Windows users to set SEARCH_ENGINE_HTTP_URL in bin\fess.in.bat. fess.in.bat never reads that variable. Only bin/fess.in.sh turns it into -Dfess.search_engine.http_address. On Windows the address comes from the -Dfess.search_engine.http_address line that fess.in.bat carries (commented out, under "External opensearch cluster"), or from search_engine.http.url in fess_config.properties (read through ResourceUtil.getFesenHttpUrl() when the system property is absent).

Changes

  • The message now names SEARCH_ENGINE_HTTP_URL for bin/fess.in.sh only and the -Dfess.search_engine.http_address option for bin\fess.in.bat. The fess_config.properties hint is unchanged.
  • The hint printed after fess-setup install opensearch (when bin/fess.in.sh will not find the installed OpenSearch) no longer tells Windows users to set both variables in bin\fess.in.bat. It names bin/fess.in.sh or the environment, and adds a Windows note: bin\fess.in.bat reads FESS_DICTIONARY_PATH but not SEARCH_ENGINE_HTTP_URL, so set the URL with the -Dfess.search_engine.http_address option or search_engine.http.url.

Testing

  • No test asserts this message. mvn test -Dtest=SearchEngineClientTest: 25 tests, 0 failures.
  • No test asserts the install opensearch hint. mvn test -Dtest='org.codelibs.fess.setup.*Test,SearchEngineClientTest': 227 tests, 0 failures.

… the engine URL

When no search engine address is configured, Fess fails at startup with
a message telling Windows users to set SEARCH_ENGINE_HTTP_URL in
bin\fess.in.bat. fess.in.bat never reads that variable: only
bin/fess.in.sh turns it into -Dfess.search_engine.http_address. On
Windows the address comes from the -Dfess.search_engine.http_address
line fess.in.bat carries (commented out), or from
search_engine.http.url in fess_config.properties.

The message now names SEARCH_ENGINE_HTTP_URL for bin/fess.in.sh only
and the -Dfess.search_engine.http_address option for bin\fess.in.bat.
@marevol marevol added this to the 15.9.0 milestone Sep 23, 2026
…ter install opensearch

After `fess-setup install opensearch`, when bin/fess.in.sh will not find
the installed OpenSearch on its own, the hint told users to set
SEARCH_ENGINE_HTTP_URL and FESS_DICTIONARY_PATH in bin/fess.in.sh
"(bin\fess.in.bat on Windows)". bin\fess.in.bat reads
FESS_DICTIONARY_PATH but never SEARCH_ENGINE_HTTP_URL.

The hint now names bin/fess.in.sh or the environment only, and adds a
Windows note: set the URL with the -Dfess.search_engine.http_address
option in bin\fess.in.bat, or with search_engine.http.url in
fess_config.properties.
@marevol marevol self-assigned this Sep 23, 2026
@marevol marevol added the task label Sep 23, 2026
@marevol
marevol merged commit 8804209 into main Sep 23, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant