|
1 | 1 | --- |
2 | | -title: Triage checklist for network issues |
3 | | -description: Short checklist to quickly gather the information needed to troubleshoot network and perfSONAR problems. |
| 2 | +title: "Triage checklist (minimal)" |
| 3 | +description: "Short checklist to quickly gather the information needed to troubleshoot network and perfSONAR problems." |
4 | 4 | persona: troubleshoot |
5 | | -owners: [networking-team@osg-htc.org] |
| 5 | +owners: ["networking-team@osg-htc.org"] |
6 | 6 | status: draft |
7 | 7 | tags: [troubleshoot, checklist] |
8 | 8 | --- |
9 | 9 |
|
10 | 10 | ## Quick triage checklist |
11 | 11 |
|
12 | | -1. Gather host information: hostname, distro, kernel, NICs. |
13 | | -1. Check basic connectivity: ping, traceroute to remote testpoints. |
14 | | -1. Verify perfSONAR services: systemctl status perfsonar-* and web UI. |
15 | | -1. Check firewall/ports (nftables/iptables) and required ports for perfSONAR. |
16 | | -1. Collect logs and measurement samples for sharing with support. |
| 12 | +1. Gather host information |
17 | 13 |
|
18 | | -Use relevant playbooks in `playbooks/` for specific scenarios. |
| 14 | +```bash |
| 15 | +hostnamectl |
| 16 | +cat /etc/os-release |
| 17 | +uname -a |
| 18 | +ip -c a |
| 19 | +``` |
| 20 | + |
| 21 | +2. Check basic connectivity |
| 22 | + |
| 23 | +```bash |
| 24 | +ping -c 4 <remote-ip-or-host> |
| 25 | +traceroute -n <remote-ip-or-host> |
| 26 | +``` |
| 27 | + |
| 28 | +3. Verify perfSONAR services and containers |
| 29 | + |
| 30 | +```bash |
| 31 | +systemctl status perfsonar-* |
| 32 | +ps aux | grep perfsonar |
| 33 | +sudo podman ps || sudo docker ps |
| 34 | +``` |
| 35 | + |
| 36 | +4. Check firewall and ports |
| 37 | + |
| 38 | +```bash |
| 39 | +sudo nft list ruleset |
| 40 | +sudo ss -ltnp |
| 41 | +``` |
| 42 | + |
| 43 | +5. Collect logs and measurements |
| 44 | + |
| 45 | +- Container logs: `sudo podman logs perfsonar-testpoint` |
| 46 | +- perfSONAR checks: `pscheduler tasks --host localhost` |
| 47 | + |
| 48 | +Use the scenario playbooks in `playbooks/` for step-by-step remediation instructions. |
0 commit comments