ExecStop runs 'podman stop -t 120' but the unit never set TimeoutStopSec, so systemd's 90 s default cut the graceful stop short: journal shows 'Stopping timed out. Terminating.' then 'Failed with result timeout' on 2026-10-01 13:27:17 — every stop of this unit was logging a failed stop. 180 s covers the engine's drain with margin, and the seam now guards the RELATIONSHIP (TimeoutStopSec > the podman grace) rather than a literal. StartLimitIntervalSec is a [Unit] directive; the copy in [Service] made systemd log 'Unknown key StartLimitIntervalSec in section Service' on every load. Seam asserts it appears exactly once and not in [Service].
67 lines
3.5 KiB
Desktop File
67 lines
3.5 KiB
Desktop File
# frank-primary.service — tcclaviger RDNA4 vLLM endpoint (orcarouter
|
|
# Qwen3.8-Flash-Next-Uncensored-FP8, MTP4 spec decode, KV q8/q8, 600k total
|
|
# context over 3 sessions, TP=2, tiered experts, 131-shard payload) on the
|
|
# 2x R9700 pair, dankserver :7770. 2026-09-29 cutover from the R9V radiance
|
|
# fork (git tag frank-primary-r9v-q8-20260929 is the pre-cutover state; its
|
|
# launcher/shim/setup-state machinery is retired and the state dirs stay on
|
|
# disk as rollback).
|
|
#
|
|
# Same port, same served alias; the harness models.yml id is unchanged.
|
|
# The serve script drives `podman run` directly (the image entrypoint execs
|
|
# `vllm serve`) and then waits on the container. NOTE: that wait can return
|
|
# 0 even when the engine died mid-request (vLLM's API server drains and
|
|
# exits clean on a worker fault), which is why the restart policy is
|
|
# `always` — see the [Service] note.
|
|
#
|
|
# WHY A ROOT UNIT (not a rootless quadlet): the tiered-expert shape pins tens
|
|
# of GiB of host RAM (the expert host slabs, ~20.5 GiB per rank of pinned
|
|
# anonymous memory). Pinned pages are charged against RLIMIT_MEMLOCK; dank's
|
|
# login session on this host carries 8 MiB and a user quadlet is capped by the
|
|
# user manager's own hard limit — raising that means restarting
|
|
# user@1000.service and bouncing every user container on the host. A root unit
|
|
# grants LimitMEMLOCK=infinity to the dank process via PID1, and the image
|
|
# stays in dank's rootless podman storage.
|
|
[Unit]
|
|
Description=frank-primary — tcclaviger vLLM Qwen3.8-Flash-Next-Uncensored-FP8 on 2x R9700
|
|
After=network-online.target
|
|
Wants=network-online.target
|
|
# Never let the start-rate limiter give up after a crash loop (a failed LLM
|
|
# endpoint that systemd refuses to retry is worse than a retrying one).
|
|
StartLimitIntervalSec=0
|
|
|
|
[Service]
|
|
User=dank
|
|
Group=dank
|
|
# The tiered-expert offloader pins host RAM; an RLIMIT_MEMLOCK smaller than
|
|
# the pinned set fails the load mid-start. PID1 grants infinity here —
|
|
# parity with the fleet's other LLM units.
|
|
LimitMEMLOCK=infinity
|
|
Environment="FRANK_PRIMARY_ENV_FILE=/home/dank/serverAppConfigs/scripts/frank-primary.env"
|
|
ExecStart=/home/dank/serverAppConfigs/scripts/serve-frank-primary.sh
|
|
# systemd stop: wait alone cannot stop the container child; stop it
|
|
# explicitly. vLLM 0.26 drains gracefully on SIGTERM.
|
|
ExecStop=/usr/bin/podman stop -t 120 frank-primary-qwen
|
|
# Boot cost: FP8 payload page-in plus torch compile/graph capture —
|
|
# ~15 min cold (measured 2026-09-29), faster warm.
|
|
TimeoutStartSec=1800
|
|
# Restart=always, NOT on-failure (measured 2026-10-01): a runtime
|
|
# torch.OutOfMemoryError kills the engine while vLLM's API server still
|
|
# exits 0, so ExecStart returned clean, systemd logged "Deactivated
|
|
# successfully", and on-failure NEVER fired — the endpoint stayed down until
|
|
# a human noticed. `always` restarts on any container death; an explicit
|
|
# `systemctl stop` still wins (systemd does not restart a unit the operator
|
|
# stopped), so bench windows and deploys are unaffected.
|
|
Restart=always
|
|
RestartSec=10
|
|
# ExecStop allows the engine 120 s to drain (`podman stop -t 120`); without an
|
|
# explicit TimeoutStopSec systemd's 90 s default cuts the stop short, kills it,
|
|
# and records 'Failed with result timeout' (measured 2026-10-01 13:27:17).
|
|
# Must exceed the podman grace with margin for the engine's own shutdown.
|
|
TimeoutStopSec=180
|
|
# The engine pins tens of GiB of host RAM (expert host slabs); it is the
|
|
# last process on this host that should be chosen by the kernel OOM killer.
|
|
OOMScoreAdjust=-500
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|