Troubleshooting

Something’s wrong and you want it fixed. Good — that’s what this section is for. But before anything else, understand this:

Important

The logs almost always already tell you what’s wrong. WPSD ships with a built-in Log Viewer (Dashboard -> Log Viewer) that shows you every service’s log in real time, and a one-click Download All Logs button that zips them all up for you. Most support requests could be answered by the person asking, in under a minute, just by looking at the log for the service that’s misbehaving. If you skip this step and go straight to asking for help without having looked, expect the first reply you get to be “post your logs.”

How to actually troubleshoot

  1. Identify which service is involved. DMR issue? Look at DMRGateway and MMDVMHost. D-Star issue? ircDDBGateway and MMDVMHost. YSF? YSFGateway. And so on — see Using the Log Viewer for the full list.

  2. Reproduce the problem while watching the log live. The Log Viewer auto-refreshes. Do the thing that fails (key up, try to link, try to load the dashboard) and watch what the log does at that exact moment.

  3. Read the error, not just the fact that there is one. “Network error” and “Invalid TG” are different problems needing different fixes. Read the actual line.

  4. Check Common Symptoms below for the specific problem you’re seeing, cross-referenced against what you found in the logs.

  5. If you still can’t solve it, download all logs and bring them with you when asking for help — see Getting Help/Support. “It doesn’t work” with no logs attached is not a support request anyone can act on.