diff --git a/DEPLOY.md b/DEPLOY.md index 33c4bee..6faf2b7 100644 --- a/DEPLOY.md +++ b/DEPLOY.md @@ -255,3 +255,27 @@ docker load -i /path/to/php-8.3-apache.tar docker load -i /path/to/alpine-3.20.tar exit ``` + +### Service fails with `status=226/NAMESPACE` and `Failed to set up mount namespacing: No such file or directory` + +Your binary is fine; systemd's service-execution environment is broken. Diagnose by running the binary manually as `administrator`: + +```bash +ssh administrator@172.18.139.186 +./SDP/bin/control-plane -addr :3452 -data ./SDP/data +# Should print "control-plane listening on :3452 (data=./SDP/data)" +# Ctrl-C to exit +exit +``` + +If that works, the binary is fine. systemd's namespace setup is failing — common cause on this Ubuntu: `/run/systemd` is missing. Force it to be recreated: + +```bash +ssh administrator@172.18.139.186 +sudo systemctl daemon-reexec +sudo systemctl restart sdp-control-plane.service +sudo systemctl --no-pager status sdp-control-plane.service | head -10 +exit +``` + +If still failing, the systemd manager itself is in a bad state. Reboot the VM (last resort; will interrupt any other work on it).