Skip to content

Commit 9eb1801

Browse files
committed
Canonicalize triage checklist and remove -v2 files
1 parent 798690e commit 9eb1801

File tree

3 files changed

+39
-122
lines changed

3 files changed

+39
-122
lines changed

docs/personas/quick-deploy/quickstart-perfsonar-testpoint-v2.md

Lines changed: 0 additions & 65 deletions
This file was deleted.

docs/personas/troubleshoot/triage-checklist-v2.md

Lines changed: 0 additions & 48 deletions
This file was deleted.
Lines changed: 39 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,48 @@
11
---
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."
44
persona: troubleshoot
5-
owners: [networking-team@osg-htc.org]
5+
owners: ["networking-team@osg-htc.org"]
66
status: draft
77
tags: [troubleshoot, checklist]
88
---
99

1010
## Quick triage checklist
1111

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
1713

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

Comments
 (0)