Skip to main content...

How to Report a WPSD Issue or Get Help, the Right Way

We frequently see user content starting with “it doesn’t work”, and no other details. We can’t help without more information. This document is intended to inform you how to ask for help in a way that the volunteers, users and developers actually help you.

First, we always implore you to read the official documentation and FAQs before reporting an issue. I cannot stress how many times folks have reported issues, when they are already covered in the documentation. 🤦‍♂️

Note that me and the other few developers don’t regularly monitor the Facebook group nor the Discord server for user issues; those mediums are designated to user/community support. If you believe there’s a bug and want to file an issue report for developers, the correct place to do so, is via the official issue trackers.

However, even when posting your issue in the Facebook group or Discord server, the same guidelines outlined below still apply, so that experienced users can help you.

Now, please keep reading so that you can get actual help…

What a Good Issue Report Contains

  • What you are trying to do
  • What you expected to see (or happen)
  • What you actually saw (or what happened)
  • What is the configuration of your WPSD system and/or your rig
  • What recent changes you made (if anything)
  • What version #/hash you are running (in the top-right corner of the dashboard), or better, run: wpsd-version from command line.
  • What mode(s) are you using/trying to use
  • What the various or relevant log files indicate in Admin -> Live Log Viewer
  • What steps you took in troubleshooting thus far

A Bad Issue Report Example

“I tried to TX/RX on BM TG 3100 and it doesn’t work. Will somebody help me?”

A Good Issue Report Example

“I installed the WPSD RaspberryPi disk image, and restored all of the config files from my old setup. I am trying to TX/RX on DMR using BrandMeister, Talkgroup 3100, but I’m unsuccessful.

I ensured that my BrandMeister security key is entered in the BrandMeister config section.

No other changes have been made to my system after restoring the previous config files.

I do see that DMRGateway doesn’t seem to start since the DMR status panel mentions “Service Not Started”. Here are the last 20 lines from the DMRGateway log file showing the error. And here are the contents of my DMRGateway config file.

My hotspot is running version # 4220ac03f9.”

Providing Log Files

Frequently, you will be asked to provide log file information which enables us to help you. It’s best to inspect these BEFORE asking for help, because you’ll be likely be asked anyway!

Log files can be viewed “live”, from the Live Log admin page:

Admin -> Live Logs

However, sometimes these logs won’t display anything or update if there is an issue starting the respective service. In this case, you can click the “Download This Log”/“Download All Logs” button on the Live Log page which will download a zip file with all relevant logs inside. Please provide the log file for the service you’re having an issue with.

Screenshots of Logs or Photos of Computer Monitors Are Not Acceptable

  • Don’t send screenshots of logs. We need the actual log text output.
  • Don’t take photos or videos of your computer monitor with your mobile devices and post them; take a proper screenshot of what you are trying to show us on your screen.
  • Posting screenshots of logs or photos/videos of computer monitors will result in the post being removed.

Providing Config Files

You may be asked to provide a copy of the relevant config file(s) for your issue. We will need the actual files, not screenshots of your configuration (your post/issue will be deleted if screenshots are submitted).

If you don’t know where the config files are or how to access them, you can easily download them from the dashboard:

Admin -> Advanced -> Backup/Restore -> Download Configuration

This will download a zip file with all of the relevant config files. You will likely be asked to provide a specific config file(s) from that zip archive.

Sometimes, you will be specifically asked for screenshots of your configuration page.

Never Say These Things:

“This worked fine in the original Pi-Star”

“It only works when I revert back to the original Pi-Star”

Just…don’t. Never say those things.

There are HUGE differences between my software and the “original Pi-Star”, so the comparison and argument that “it works in the original” is actually invalid.

Many of these differences are due to my software using up-to-date back-end software, which is sometimes not compatible with “the original Pi-Star”, especially when config files are migrated over. It’s easier and more successful to begin the configuration from scratch when using my software if you run into issues.

Say these things, and the post may risk being removed.

Ver. # accbc1b - Document last revised: 11/27/2023
[ Permanent Link ]