Editing Tornedo.tetrain.com Runbook (section)

=== 3.2 Critical: add swap before attempting <code><nowiki>--setup-ca</nowiki></code> ===

This box has 1.6G RAM and (originally) zero swap. The CA database init step spawns a JVM (<code><nowiki>ca-db-init</nowiki></code>) that OOMs *silently* — no debug log, no catalina output, exit code 255, no kernel OOM-killer entry (the JVM fails to reserve heap before its own logging initializes). '''Add swap before attempting the CA setup, not after failing once''':

<pre>
<nowiki>
fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile swap swap defaults 0 0' >> /etc/fstab
free -h   # confirm swap is present
</nowiki>
</pre>

(Confirmed live 2026-07-25: this exact <code><nowiki>/swapfile</nowiki></code> + <code><nowiki>/etc/fstab</nowiki></code> entry is still in place and in active use — 295MB in use at time of check.)