Skip to content

Commit 3239c56

Browse files
author
root
committed
Clarify toolkit issue reporting for RPM installs
1 parent 2ad1938 commit 3239c56

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

docs/personas/quick-deploy/install-perfsonar-toolkit.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1839,17 +1839,18 @@ Perform these checks before handing the host over to operations:
18391839
18401840
??? note "What to include when reporting issues via email"
18411841
1842-
To help us diagnose install problems quickly, please include:
1842+
To help us diagnose toolkit (RPM) install problems quickly, please include:
18431843
1844-
- Host details: OS version (e.g., `cat /etc/os-release`), kernel (`uname -r`), and whether this is testpoint or toolkit.
1845-
- Script/log context: which script/step failed and the exact command you ran.
1844+
- Host details: OS version (`cat /etc/os-release`), kernel (`uname -r`), and that this is a **Toolkit/RPM** install.
1845+
- What failed: which step/command you ran and the exact error output (paste the terminal snippet).
18461846
- Timestamps: approximate time of failure and timezone.
1847-
- Outputs/logs: relevant console output and excerpts from `journalctl -u podman -n 200`, `tail -200 /var/log/perfSONAR-install-nftables.log`, and any script-specific log mentioned in the error.
1848-
- Network state: `ip -br addr`, `ip rule show`, `nmcli connection show`, and whether port 80/443 should be open externally.
1849-
- Certificates (if LE): whether port 80 was reachable from the Internet and the contents of `/var/log/letsencrypt/letsencrypt.log` around the failure.
1847+
- Packages/services: `rpm -qa 'perfsonar*' | sort | head -n 30`, and `systemctl status pscheduler-scheduler pscheduler-runner pscheduler-ticker httpd`.
1848+
- Logs: `journalctl -u pscheduler-scheduler -u pscheduler-runner -u pscheduler-ticker -u httpd -n 200`, plus any relevant `/var/log/perfsonar/*.log` excerpts.
1849+
- Network state: `ip -br addr`, `ip rule show`, `nmcli connection show`, and `nft list ruleset` (or `firewall-cmd --list-all` if firewalld is used).
1850+
- Certificates (if Let’s Encrypt or custom HTTPS involved): whether port 80/443 are reachable externally and excerpts from `/var/log/httpd/error_log` and `/var/log/letsencrypt/letsencrypt.log`.
18501851
- Contact info: your name, site, and a callback email.
18511852
1852-
Send reports to your usual perfSONAR support contact or project mailing list with the subject prefix `[perfSONAR install issue]`.
1853+
Send reports to your usual perfSONAR support contact or project mailing list with the subject prefix `[perfSONAR toolkit install issue]`.
18531854
18541855
**Logs:**
18551856

0 commit comments

Comments
 (0)