Repository navigation
issue 962 slice 1: Inventory Linux service install/start/stop scripts (CMS Jetty + DTS) #1975
Description
Parent
Parent issue: #962
Slice
Child A / Slice 1 — Inventory current Linux service install, start, and stop scripts for CMS Jetty and DTS; document init.d touchpoints and packaging paths.
Already on main (inventory baseline from night split)
Do not re-implement systemd cutover. Capture / keep inventory accurate for ops and residual slices.
CMS Jetty (modules/perc-jetty)
| Path | Role |
|---|---|
src/main/jetty/service/install-jetty-service.sh |
Linux service install/uninstall; prefers native systemd when available; --initd / --systemd flags |
src/main/jetty/service/install-jetty-service.bat |
Windows Procrun (out of scope for this Linux slice) |
src/main/jetty/service/percussion-cms.service.in |
systemd unit template (Type=forking, TimeoutStartSec=1800, journal) |
src/main/jetty/service/README-systemd.md |
Operator install / migrate / journal notes |
src/main/jetty/StartJetty.sh / StopJetty.sh |
Foreground / helper start-stop |
src/main/jetty/resolve-java-home.sh |
JAVA_HOME resolution (sourced by service install) |
| Packaged via | perc-jetty assembly (src/main/assembly/jetty-assembly.xml copies full distribution tree including service/) into CMS install under Jetty layout |
| init.d helper template | ${JETTY_DEFAULTS}/bin/rxjetty.sh → written to /etc/init.d/<ServiceName> at install |
| Runtime config | /etc/default/<ServiceName>, PID under /var/run/rxjetty/<ServiceName>/rxjetty.pid |
| Unit path | /etc/systemd/system/<ServiceName>.service (default name PercussionCMS) |
| Structural tests | SystemdUnitTemplateTest, InstallJettyServiceScriptTest, InstallJettyServiceJavaHomeTest |
DTS (deliverytiersuite/delivery-tier-suite/delivery-tier-distribution)
| Path | Role |
|---|---|
src/main/rootFiles/DTSProductionService.sh |
Production DTS install/uninstall; systemd prefer + --initd |
src/main/rootFiles/DTSStagingService.sh |
Staging DTS install/uninstall |
src/main/rootFiles/dts-tomcat.service.in |
Shared Tomcat unit template |
src/main/rootFiles/README-systemd.md |
Ops notes |
| Defaults | PercussionProductionDTS / PercussionStagingDTS |
| Structural tests | DtsSystemdUnitTemplateTest (+ related script tests) |
Spec / prior PR
- Spec:
specs/988-linux-systemd-services/ - Merged CMS implementation: feat(jetty): native systemd unit for CMS Linux service (#962) #1334
Acceptance
- Inventory table above validated against current
main(or corrected if packaging moved) - Note any installer/distribution-tree path that must copy
service/into a real install (beyond perc-jetty assembly) - Confirm init.d is still dual-shipped as start helper +
--initdfallback (no silent removal) - Link findings on parent Migrated: Update the Linux service scripts to use systemd services instead of init.d #962
Out of scope
- Removing init.d
- Live root systemd soak (Child C)
- Product deprecation of SysV (Child D; human ops review required)
Labels / assignment
Unassigned. Night-issue residual slice under #962.
Activity
natechadwick-intsof commentedon Aug 5, 2026
Inventory complete (slice 1)
PR: #1985
Durable inventory:
specs/988-linux-systemd-services/inventory.md(commitdaec4f5407)Validated
service/scripts, unit template, README, Start/StopJetty, resolve-java-home — presentjetty/— present--initd/--systemd) CMS + DTS — present, no silent init.d removalinstallDts.xmlservice script placement underDeployment/Server/— presentGaps (residuals, not fixed in inventory PR)
modules/perc-jetty/.../defaults/bin/rxjetty.sh(deleted in Refactor/webui build structure #662, still required by install script): issue 1975 residual: Restore CMS jetty defaults/bin/rxjetty.sh start-helper template #1983dts-tomcat.service.innot co-located with DTS service scripts afterinstallDts: issue 1975 residual: Co-locate DTS dts-tomcat.service.in with installDts service scripts #1984Out of scope held: no init.d removal, no live root soak.
Operator: Grok night-issue-prs (model grok-4.5)
fix(1984): co-locate DTS dts-tomcat.service.in with service scripts
fix(perc-jetty): restore defaults/bin/rxjetty.sh start-helper template (
fix(1984): co-locate DTS dts-tomcat.service.in with service scripts
fix(1984): co-locate DTS dts-tomcat.service.in with service scripts (#…
docs(1975): inventory Linux CMS Jetty + DTS service scripts (#962 sli…