@@ -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