Skip to content

Migrate Tomcat-Apache to Debian Trixie - #15

Open
lirazsiri wants to merge 5 commits into
masterfrom
wish/tomcat-apache-v19-trixie
Open

Migrate Tomcat-Apache to Debian Trixie#15
lirazsiri wants to merge 5 commits into
masterfrom
wish/tomcat-apache-v19-trixie

Conversation

@lirazsiri

Copy link
Copy Markdown
Member

Summary

  • migrate the appliance to OpenJDK 21 and Debian Trixie Tomcat 10.1 packages
  • preserve Apache mod_jk, localhost AJP, manager authentication, MariaDB, and Webmin integration
  • add focused v19 acceptance covering both services, proxying, JSP execution, package provenance, and updates

Validation

  • appliance acceptance passed in LibreSBX run 20260826t050023z-440-32142 at f8fd03f
  • bash -n conf.d/main tests/v19.sh
  • shellcheck -x conf.d/main tests/v19.sh
  • git diff --check origin/master...HEAD

Move the packaged runtime from unavailable OpenJDK 17 to Debian Trixie OpenJDK 21 while retaining Tomcat 10.1, Apache mod_jk, localhost AJP, firstboot manager credentials, and the documented control-panel deployment. Refresh the appliance description for MariaDB and journal-based logging.

Add functional acceptance for service and connector configuration, Apache-to-Tomcat HTTPS requests, manager authentication, live JSP execution, MariaDB, Webmin, package provenance, and the supervised APT update path. Document the README evidence crosswalk, Core inheritance, source choice, and deferred common-runtime cleanup.
The first full Trixie run reached the runtime test but a silent shell assertion stopped after Apache configuration validation, leaving no actionable child result. Report the failing line, status, and command so the next serialized run can distinguish a product defect from a test expectation without broad tracing or harness changes.

Verification: bash -n tests/v19.sh; git diff --check.
Debian Trixie reports the numeric Tomcat release as `Server number:  10.1.55.0`. The acceptance test assumed a single space after the colon, so it rejected a healthy runtime before exercising the application flow. Match the exact label while accepting variable field spacing, then retain the 10.1 assertion.

Verification: disposable Debian Trixie tomcat10 probe; parser fixture for the two-space 10.1.55.0 output; bash -n tests/v19.sh; git diff --check.
Debian Trixie exposes manager, host-manager, and docs through context descriptors backed by package-owned directories rather than copies in the writable webapps directory. Validate those effective mappings and retain authenticated endpoint checks. Match the Tomcat 10.1 server-info response and use the MariaDB root credential established by firstboot for the database roundtrip.

Verification: run 20260824t142905z-2693-26173 reached the descriptor assertion after a healthy boot; disposable Debian Trixie tomcat10-admin/docs probe confirmed all docBase paths; the sibling Tomcat v19 flow supplied the server-info and initialized MariaDB contracts; bash -n tests/v19.sh; git diff --check.
Java may render its IPv4 loopback AJP listener as an IPv4-mapped IPv6 address in ss output. Remove that redundant formatting assertion while retaining the server.xml connector contract, mod_jk worker configuration, disabled HTTP connector check, and real Apache HTTPS requests through AJP.

Verification: bash -n tests/v19.sh; git diff --check.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant