Skip to main content

Prove the Node Is Actually Serving

A node that answers systemctl status is not necessarily serving traffic. The process can be running while the listener never bound, or the listener can be up while local DNS resolution is dead — and in both cases users see failures that look like network problems, so the proxy is the last thing anyone checks. Run these checks first. Everything else in validation assumes the service is genuinely up.

Validate prerequisites

Confirm:
  • SafeSquid is installed on the host under test.
  • You have shell access to the SafeSquid server.
  • The approved proxy listener port is known and recorded in the change record.

Prove the listener bound

Run the listener check on the SafeSquid server:
Expected result: SafeSquid listens on the approved proxy port. An empty result with a healthy service means the process started but failed to bind — usually a port already in use, or a listener address that does not exist on this host. Check the service log before changing configuration.

Prove the process is alive

Expected result: one or more process IDs. On systemd systems, confirm service state:
Expected result: Active: active (running) and no recent startup errors. Read the startup lines even when the state is active. A service that restarted minutes ago is reporting health for a process that has not yet been under load.

Prove local DNS resolution

SafeSquid cannot categorise or reach a destination it cannot resolve. Where integrated DNS security is deployed, BIND9 is part of the service, not a separate concern.
Expected result: DNS returns a valid IP address for example.com. If resolution fails:
  • Check BIND9 service state with systemctl status bind9 --no-pager.
  • Check /etc/bind/named.conf for syntax or forwarder errors.
  • Use BIND to repair local DNS service configuration.

Capture service evidence

Store these artifacts with the deployment record:
  • ss -lntp output showing the bound proxy listener.
  • systemctl status safesquid output, including the startup lines.
  • nslookup output from the SafeSquid host.
  • The date of the check and the named owner of the node.

Troubleshoot service failures

Next steps