Blueforce-Linux/scripts/diagnostics/bf-diagnostics
emirhanmamak-blueforce ef102b9657 feat(field-os): provisioning layer, real ISO build, offline contracts
Adds the Blueforce Field OS provisioning stack on top of the existing fleet
architecture, without rewriting the working systems (installer, diagnostics,
Ansible, WireGuard/SSH/xRDP/RustDesk, Docker policies, monitoring, Docusaurus).

ISO build (the previous builder was a skeleton that produced no medium):
- boot layout is read from the base ISO at build time via
  `xorriso -report_el_torito as_mkisofs` and rebuilt with `-as mkisofs`;
  `-boot_image any replay` cannot work on Ubuntu live ISOs because the GRUB2
  MBR lives in the source image's first 16 sectors and the EFI system partition
  is an appended partition, neither of which is a file in the ISO9660 tree
- preflight now asserts El Torito boot metadata positively: xorriso exits 0 on
  a non-ISO input, which previously let an arbitrary file pass --check
- artifact produced and verified: dist/Blueforce-Field-OS-1.0.0-amd64.iso,
  6 481 917 952 bytes, SHA256 cb0cc56f...d431296, BIOS+UEFI entries preserved,
  /autoinstall.yaml at the media root, casper/minimal.squashfs byte-identical
  to the base
- recorded baseline deviation: the verified medium on the build host is the
  Desktop flavour, so the manifest carries a baseline_deviation block instead
  of hiding it; Server remains one flag away

Offline and identity:
- offline APT contract with concrete package requirements, pin format and an
  audit table; builds fail closed while pins are UNPINNED
- autoinstall keeps interactive-sections: [storage]: the operator confirms the
  target disk, and no automatic wipe is ever performed
- firstboot terminal wizard for the 8-digit dealer id, three-state lifecycle
  (PROVISIONED_OFFLINE -> ENROLLED -> READY) with fail-closed gates, so a
  missing internet link or WireGuard handshake cannot fail provisioning but can
  never produce a false READY

Fleet and migration:
- five read-only Ansible playbooks for Field OS version, provisioning,
  enrollment, remote channels and offline readiness, all wave-scoped with a
  separate production override
- Windows pre-migration inventory and data export extended to the full brief
  scope, read-only, never collecting credentials

Tests: tests/run-all.sh -> 8/8 pass, exit 0. Boot acceptance (UEFI, Legacy
BIOS, Secure Boot), air-gapped install, real enrollment endpoint and Windows
rollback remain LAB work and are listed in IMPLEMENTATION-REPORT.md.
2026-09-16 11:14:42 +03:00

116 lines
3.6 KiB
Bash
Executable file

#!/usr/bin/env bash
#
# bf-diagnostics - Deep health check for a Blueforce field terminal.
#
# Detailed version of bf-status: SMART, journal errors, docker ps,
# WireGuard state, unattended-upgrades lock, sockets, inodes, textfiles.
# Never prints secrets, keys, or passwords (handshake keys are redacted).
#
# Install: install -m 0755 bf-diagnostics /usr/local/bin/bf-diagnostics
# Usage: bf-diagnostics [--help]
#
set -euo pipefail
usage() {
cat <<'EOF'
Usage: bf-diagnostics [--help]
Run deep checks: SMART, journal errors, docker ps, wg show,
unattended-upgrades lock state, sockets, inodes, textfile collectors.
Options:
--help Show this help and exit
EOF
}
if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
usage
exit 0
elif [[ $# -gt 0 ]]; then
echo "ERROR: unknown argument: $1" >&2; usage >&2; exit 2
fi
set +e # report, don't abort
sec() { printf '\n### %s\n' "$*"; }
sec "HOST"
hostname; uptime; systemctl get-default 2>/dev/null || echo "target: unknown"
sec "SMART"
if command -v smartctl >/dev/null 2>&1; then
for dev in /dev/sd? /dev/nvme?n1; do
[[ -b "${dev}" ]] || continue
echo "--- ${dev} ---"
smartctl -H -A "${dev}" 2>/dev/null | grep -Ei 'health|reallocated|pending|uncorrect|wear|temperature|power_on' || echo "no SMART attributes parsed"
done
else
echo "smartctl not installed; skipping SMART."
fi
sec "JOURNAL ERRORS (last 24h, top 20)"
if command -v journalctl >/dev/null 2>&1; then
journalctl --since "24 hours ago" -p err --no-pager -o short 2>/dev/null | tail -20 || echo "no journal access"
else
echo "journalctl not available."
fi
sec "FAILED SYSTEMD UNITS"
if command -v systemctl >/dev/null 2>&1; then
systemctl --failed --no-pager 2>/dev/null || echo "no failed units"
else
echo "systemctl not available."
fi
sec "DOCKER PS"
if command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1; then
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}' 2>/dev/null || echo "docker ps failed"
echo "--- restart counts ---"
docker ps --format '{{.Names}} restarts={{.RestartCount}}' 2>/dev/null || true
else
echo "docker daemon not reachable."
fi
sec "WIREGUARD (keys redacted)"
if command -v wg >/dev/null 2>&1; then
wg show 2>/dev/null | sed -E 's/(private-key|public-key|preshared-key): .*/\1: <redacted>/' || echo "no WireGuard interfaces"
echo "--- latest handshakes ---"
wg show all latest-handshakes 2>/dev/null || echo "no handshake data"
else
echo "wg tool not installed."
fi
sec "UNATTENDED-UPGRADES LOCK (must be DISABLED)"
grep -H . /etc/apt/apt.conf.d/20auto-upgrades 2>/dev/null || echo "20auto-upgrades file missing"
for t in apt-daily.timer apt-daily-upgrade.timer; do
printf '%s: %s\n' "$t" "$(systemctl is-enabled "$t" 2>/dev/null || echo unknown)"
done
sec "SOCKETS (listening)"
ss -ltnp 2>/dev/null || ss -ltn 2>/dev/null || echo "ss not available"
sec "DISK + INODES"
df -h / /var 2>/dev/null
df -i / /var 2>/dev/null | head -5
sec "TEXTFILE COLLECTORS"
ls -l /var/lib/node_exporter/textfile/ 2>/dev/null || echo "textfile dir missing"
for f in /var/lib/node_exporter/textfile/*.prom; do
[[ -f "$f" ]] || continue
echo "--- $f ---"; head -10 "$f"
done
sec "SECURITY UPDATES PENDING"
if command -v apt >/dev/null 2>&1; then
apt list --upgradable 2>/dev/null | grep -ci security || echo "0 security updates (or apt list unavailable)"
else
echo "apt not available."
fi
sec "REBOOT REQUIRED"
if [[ -f /var/run/reboot-required ]]; then echo "YES"; cat /var/run/reboot-required.pkgs 2>/dev/null || true
else echo "NO"; fi
echo
echo "Diagnostics complete. For remote triage run: bf-support-bundle"
exit 0