docs(1975): inventory Linux CMS Jetty + DTS service scripts (#962 slice 1)

[natechadwick-intsof]

Summary

Validates and documents the Linux service install/start/stop inventory for CMS Jetty and DTS (issue #1975 / parent #962 slice 1).

• New durable inventory: specs/988-linux-systemd-services/inventory.md
• Spec drift corrections in plan.md, data-model.md, tasks.md (DTS is in-scope; rxjetty.sh path status)

Findings

Claim from #1975	Result
CMS Jetty service/ scripts + unit template + README	Present
Dual-ship systemd prefer + --initd (CMS + DTS)	Present — no silent init.d removal
perc-jetty assembly + distribution-tree copies service/	Present
init.d helper defaults/bin/rxjetty.sh	Missing source (deleted with system/Tools/jetty in #662; never restored under perc-jetty) → Gap A
DTS rootFiles scripts + dts-tomcat.service.in	Present in source
DTS installDts.xml places service scripts under Deployment/Server/	Present
DTS unit template co-located with service scripts	Mismatch (.in at product root; scripts look next to \) → Gap B

Residuals (product code — not this PR)

• issue 1975 residual: Restore CMS jetty defaults/bin/rxjetty.sh start-helper template #1983 Restore CMS defaults/bin/rxjetty.sh
• issue 1975 residual: Co-locate DTS dts-tomcat.service.in with installDts service scripts #1984 Co-locate / resolve DTS dts-tomcat.service.in

Test plan

• Path existence checked against main tree (list/grep)
• Dual-ship markers grepped in CMS + DTS install scripts
• Packaging chain traced: perc-jetty copy of src/main/jetty → assembly → perc-distribution-tree jetty/; DTS rootFiles + installDts.xml
• Spotless: mvnw spotless:apply then spotless:check (root); only in-scope specs/988-* files committed
• No Maven module product code changes → no per-module clean install required (docs/spec only)
• Live root systemd soak — out of scope (Child C)

Gates evidence

• Erlang-style self-review: docs-only; no product code delete; portable-path N/A for new code
• Spotless apply → check: PASS (out-of-scope Spotless hits discarded, not stuffed into PR)
• Module clean install: N/A (docs only)

Operator

Operator: Grok: night-issue-prs (model grok-4.5)

Fixes #1975
Partial progress on #962 (inventory only; packaging gaps filed as #1983 #1984)

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (4 files)

• specs/988-linux-systemd-services/inventory.md - 0 issues
• specs/988-linux-systemd-services/data-model.md - 0 issues
• specs/988-linux-systemd-services/plan.md - 0 issues
• specs/988-linux-systemd-services/tasks.md - 0 issues

Previous Review Summary (commit daec4f5)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit daec4f5)

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	0
SUGGESTION	1

Issue Details (click to expand)

SUGGESTION

File	Line	Issue
specs/988-linux-systemd-services/inventory.md	235	DTS re-validate paths missing repo-root prefix deliverytiersuite/delivery-tier-suite/

Files Reviewed (4 files)

• specs/988-linux-systemd-services/inventory.md - 1 issue (new file)
• specs/988-linux-systemd-services/data-model.md - 0 issues
• specs/988-linux-systemd-services/plan.md - 0 issues
• specs/988-linux-systemd-services/tasks.md - 0 issues

Verification performed

This is a docs-only PR. All path and behavioral claims in inventory.md were verified against the actual source tree on main:

• CMS source scripts (install-jetty-service.sh, .bat, percussion-cms.service.in, README-systemd.md, win/) — all Present (verified in modules/perc-jetty/src/main/jetty/service/)
• Gap A — confirmed: modules/perc-jetty/src/main/jetty/defaults/ has no bin/ directory; install-jetty-service.sh:213-215 requires ${JETTY_DEFAULTS}/bin/rxjetty.sh and hard-fails with Missing Jetty service template if absent; installInitScriptAndDefaults (line 358) is called before the systemd/init.d branch split (line 364), so both paths fail
• CMS packaging chain — verified: modules/perc-jetty/pom.xml:331 copies src/main/jetty/** to assembly-directory; jetty-assembly.xml includes ** with no service/ exclusion; installDistributionFiles.xml:64-67 copies perc-jetty artifact to ${assembly-directory}/jetty
• CMS structural tests — present and assert dual-ship: SystemdUnitTemplateTest, InstallJettyServiceScriptTest, InstallJettyServiceJavaHomeTest (assert --initd, --systemd, use_systemd_install, SysV boot registration skipped)
• CMS runtime layout — /var/run/rxjetty/${SERVICE_NAME} (line 208) and JETTY_PID=${JETTY_RUN}/rxjetty.pid (line 234) match the inventory table
• DTS source scripts + unit template — all Present in deliverytiersuite/delivery-tier-suite/delivery-tier-distribution/src/main/rootFiles/ (DTSProductionService.sh, DTSStagingService.sh, dts-tomcat.service.in, README-systemd.md, .bat variants, resolve-java-home.sh, installDts.xml)
• installDts.xml — verified on both paths: fresh install (lines 500-524) and upgrade (lines 648-674 + 809-828) exclude DTSProductionService.{sh,bat} and DTSStagingService.{sh,bat} from root * copy and separately place the selected script under Deployment/Server/; dts-tomcat.service.in is not specially copied to Deployment/Server/
• Gap B — confirmed: DTSProductionService.sh:209 resolves unit_template="$(dirname "$(abspath "$0")")/dts-tomcat.service.in", but installDts.xml lands the .in at the product surface root, not next to the service script
• DTS structural tests — present and assert dual-ship: DtsSystemdUnitTemplateTest, DtsServiceInstallScriptTest (assert SysV boot registration skipped, had_initd, --initd, --systemd)
• Unit template name — confirmed as percussion-cms.service.in (dashes), matching inventory; plan.md:55 lists the old PercussionCMS.service.in variant, correctly flagged as drift
• Spec/docs — contracts/systemd-unit-contract.md and spec.md both exist as referenced

Notes

• No Java/JS/TS code changes in this PR; Spotless apply/check and per-module Maven clean install are N/A (confirmed in PR description). No cross-platform path concerns apply.

Fix Link: https://app.kilo.ai/cloud-agent-fork/review/394ae93c-81f5-4420-8da3-62d7b37e1d26

---

_{Reviewed by ling-3.0-flash:free · Input: 45.7K · Output: 10.5K · Cached: 348.2K}

_{Review guidance: REVIEW.md from base branch main}