Skip to content

feat: add perfSONAR-diagnostic-report.sh v1.0.0#81

Merged
ShawnMcKee merged 1 commit intomasterfrom
feat/diagnostic-report-script
Feb 26, 2026
Merged

feat: add perfSONAR-diagnostic-report.sh v1.0.0#81
ShawnMcKee merged 1 commit intomasterfrom
feat/diagnostic-report-script

Conversation

@ShawnMcKee
Copy link
Contributor

Summary

New read-only diagnostic collection script for remote troubleshooting of perfSONAR deployments.

New files

  • perfSONAR-diagnostic-report.sh v1.0.0 — collects 12 diagnostic sections into a self-contained report file at /tmp/perfsonar-diag-<hostname>-<date>.txt
  • perfSONAR-diagnostic-report.sh.sha256 — integrity checksum

Modified files

  • install_tools_scripts.sh v1.0.4 → v1.0.5 — bootstrap now downloads the new script
  • install-perfsonar-testpoint.md — troubleshooting section updated to reference the diagnostic report script instead of manual log collection
  • CHANGELOG.md — [1.5.5] entry added

Diagnostic sections (12)

  1. Host Environment (OS, kernel, memory, disk, CPU)
  2. Network Configuration (IP, routes, DNS, firewall, multi-NIC)
  3. SELinux & Security (mode, booleans, MCS labels)
  4. Container Runtime (podman info, images, ps, inspect, exec-into checks)
  5. Configuration Files (compose, node_exporter.defaults, service files)
  6. Toolkit (RPM packages, native services — when applicable)
  7. Endpoint Connectivity (curl tests for all 4 endpoints, SSL cert)
  8. TLS / Let's Encrypt Certificates
  9. Systemd Units & Timers
  10. Network Tuning (sysctl, ethtool, tc qdisc, fasterdata audit)
  11. Known Issue Checks (cpufreq, certbot :Z, D-Bus boolean, Initialized state, cgroup)
  12. Quick Health Summary

CLI flags

--base DIR, --type TYPE, --output FILE, --no-color, --brief, --version, --help

Testing

Tested on psum01 (container deployment, RHEL 9, Podman 5.6.0). All 12 sections complete successfully. Report file generated at 748K with full diagnostic data.

Read-only diagnostic collection script for remote troubleshooting.
Runs 12 diagnostic sections and writes a self-contained report file
to /tmp/perfsonar-diag-<hostname>-<date>.txt.

Supports both container (Podman) and RPM toolkit deployments with
auto-detection. Includes targeted checks for all previously-fixed
bugs (cpufreq panic, certbot :Z mount, D-Bus SELinux boolean,
stale service file mounts, container Initialized state).

Also:
- install_tools_scripts.sh v1.0.5: bootstrap downloads the new script
- install-perfsonar-testpoint.md: troubleshooting section updated to
  reference the diagnostic report script
- CHANGELOG.md: [1.5.5] entry added
@ShawnMcKee ShawnMcKee merged commit 9c157e7 into master Feb 26, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant