Skip to content

Commit 5eb5ca6

Browse files
author
root
committed
Remove container references from toolkit debugging guidance
1 parent 3239c56 commit 5eb5ca6

File tree

1 file changed

+43
-50
lines changed

1 file changed

+43
-50
lines changed

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

Lines changed: 43 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1748,79 +1748,68 @@ Perform these checks before handing the host over to operations:
17481748
17491749
??? failure "perfSONAR services not running"
17501750
1751-
**Symptoms:** Web interface not accessible, tests not running.
1751+
**Symptoms:** Web interface not accessible, pScheduler tests not running.
17521752
1753-
**Diagnostic steps:**
1753+
**Diagnostic steps (RPM install):**
17541754
17551755
```bash
1756-
# Check service status inside container
1757-
podman exec perfsonar-testpoint systemctl status apache2
1758-
podman exec perfsonar-testpoint systemctl status pscheduler-ticker
1759-
podman exec perfsonar-testpoint systemctl status owamp-server
1756+
# Check key services
1757+
systemctl status httpd pscheduler-scheduler pscheduler-runner pscheduler-ticker
17601758
1761-
# Check for errors in service logs
1762-
podman exec perfsonar-testpoint journalctl -u apache2 -n 50
1763-
podman exec perfsonar-testpoint journalctl -u pscheduler-ticker -n 50
1759+
# Check for recent errors in service logs
1760+
journalctl -u httpd -u pscheduler-scheduler -u pscheduler-runner -u pscheduler-ticker -n 100
17641761
1762+
# pScheduler diagnostics
1763+
pscheduler troubleshoot
17651764
```
17661765
17671766
**Solutions:**
17681767
1769-
- Restart services inside container: `podman exec perfsonar-testpoint systemctl restart apache2`
1770-
- Check Apache SSL configuration was patched correctly
1771-
- Verify certificates are in place: `ls -la /etc/letsencrypt/live/`
1772-
- Restart container: `podman restart perfsonar-testpoint`
1768+
- Restart services: `systemctl restart httpd pscheduler-scheduler pscheduler-runner pscheduler-ticker`
1769+
- Verify certificates are in place (if using HTTPS): `ls -la /etc/letsencrypt/live/`
1770+
- Check Apache SSL configuration and vhost
17731771
17741772
### Auto-Update Issues
17751773
17761774
??? failure "Auto-update not working"
17771775
1778-
**Symptoms:** Containers not updating despite new images available.
1776+
**Symptoms:** `yum update`/`dnf update` not picking up perfSONAR updates or cron/Ansible automation failing.
17791777
1780-
**Diagnostic steps:**
1778+
**Diagnostic steps (RPM install):**
17811779
17821780
```bash
1783-
# Check timer status
1784-
systemctl status perfsonar-auto-update.timer
1785-
systemctl list-timers perfsonar-auto-update.timer
1786-
1787-
# Check service logs
1788-
journalctl -u perfsonar-auto-update.service -n 100
1789-
1790-
# Check update log
1791-
tail -50 /var/log/perfsonar-auto-update.log
1781+
# Check when repo metadata was last refreshed
1782+
sudo dnf repolist -v | head -n 20
17921783
1793-
# Manually test update
1794-
systemctl start perfsonar-auto-update.service
1784+
# Check for available perfSONAR updates
1785+
sudo dnf list updates 'perfsonar*'
17951786
1787+
# If you have a local cron/automation script, review its logs
1788+
sudo journalctl -u cron -n 200
17961789
```
17971790
17981791
**Solutions:**
17991792
1800-
- Enable timer if not active: `systemctl enable --now perfsonar-auto-update.timer`
1801-
- Verify script exists and is executable: `ls -la /usr/local/bin/perfsonar-auto-update.sh`
1802-
- Check podman-compose is installed and working
1803-
- Review script for errors and update if needed
1793+
- Refresh metadata: `sudo dnf clean all && sudo dnf makecache`
1794+
- Update packages: `sudo dnf update -y 'perfsonar*'`
1795+
- Verify repositories are enabled and reachable (perfSONAR, EPEL, CRB)
1796+
- If using site automation, confirm the job is scheduled and succeeds
18041797
18051798
### General Debugging Tips
18061799
18071800
??? tip "Useful debugging commands"
18081801
1809-
**Container management:**
1802+
**Service management (RPM install):**
18101803
18111804
```bash
1812-
# View all containers (running and stopped)
1813-
podman ps -a
1805+
# Check key services
1806+
systemctl status httpd pscheduler-scheduler pscheduler-runner pscheduler-ticker
18141807
1815-
# View container resource usage
1816-
podman stats
1817-
1818-
# Enter container for interactive debugging
1819-
podman exec -it perfsonar-testpoint /bin/bash
1820-
1821-
# View compose configuration
1822-
cd /opt/perfsonar-toolkit && podman-compose config
1808+
# Restart key services
1809+
systemctl restart httpd pscheduler-scheduler pscheduler-runner pscheduler-ticker
18231810
1811+
# pScheduler diagnostics
1812+
pscheduler troubleshoot
18241813
```
18251814
18261815
**Networking:**
@@ -1829,12 +1818,14 @@ Perform these checks before handing the host over to operations:
18291818
# Check which process is listening on a port
18301819
ss -tlnp | grep <port>
18311820
1832-
# Test connectivity to remote testpoint
1821+
# Test connectivity to remote host
18331822
ping <remote-ip>
18341823
traceroute <remote-ip>
18351824
1836-
# Check nftables rules
1825+
# Check nftables rules (or firewalld if used)
18371826
nft list ruleset
1827+
# or
1828+
firewall-cmd --list-all
18381829
```
18391830
18401831
??? note "What to include when reporting issues via email"
@@ -1852,17 +1843,19 @@ Perform these checks before handing the host over to operations:
18521843
18531844
Send reports to your usual perfSONAR support contact or project mailing list with the subject prefix `[perfSONAR toolkit install issue]`.
18541845
1855-
**Logs:**
1846+
**Logs (RPM install):**
18561847
18571848
```bash
1858-
# System journal for container runtime
1859-
journalctl -u podman -n 100
1849+
# Web server errors
1850+
journalctl -u httpd -n 200
1851+
tail -n 200 /var/log/httpd/error_log
18601852
1861-
# All logs from a container
1862-
podman logs perfsonar-testpoint --tail=100
1853+
# pScheduler services
1854+
journalctl -u pscheduler-scheduler -u pscheduler-runner -u pscheduler-ticker -n 200
18631855
1864-
# Follow logs in real-time
1865-
podman logs -f perfsonar-testpoint
1856+
# perfSONAR application logs (if present)
1857+
ls /var/log/perfsonar
1858+
tail -n 200 /var/log/perfsonar/pscheduler.log 2>/dev/null
18661859
```
18671860
18681861
---

0 commit comments

Comments
 (0)