Troubleshooting Demonsaw: Common Issues and Fixes
1) Client won’t connect to network
- Cause: Incorrect server/incident address, blocked ports, or incorrect clock.
- Fix: Verify network address/port match the network’s settings; ensure UDP/TCP ports (per your network setup) are allowed in firewall/ISP; sync system clock (NTP).
2) Peers show offline / can’t discover peers
- Cause: NAT or firewall blocking peer discovery; multicast disabled.
- Fix: Enable/forward required ports on router (UDP/TCP used by the network); use UPnP or manual port forwarding; confirm any multicast required is allowed or use direct node address.
3) File transfers stall or are slow
- Cause: Low peer availability, bandwidth limits, throttling, or excessive encryption overhead on slow CPUs.
- Fix: Add more peers or wait for active nodes; disable strict rate limits in client settings; test network bandwidth; try transfers between two local peers to isolate CPU vs network.
4) Authentication / login failures
- Cause: Wrong credentials, expired or mismatched keys, or clock skew.
- Fix: Re-enter credentials, re-import the correct identity/keypair, regenerate keys if corrupted, and ensure system clocks are accurate.
5) Corrupted or missing files after download
- Cause: Interrupted transfers or inconsistent file hashing.
- Fix: Re-download from another peer; enable/verify integrity checks (hash verification) in client; ensure peers have complete file copies before downloading.
6) Client crashes or high CPU / memory use
- Cause: Large queue sizes, buggy client version, or insufficient resources.
- Fix: Update to the latest stable client release, reduce concurrent transfers, clear queues/logs, and restart client. If persistent, collect client logs and reinstall.
7) Can’t start server / daemon
- Cause: Port conflicts, missing dependencies, or permission issues.
- Fix: Check logs for error lines, ensure the configured port is free (use netstat/lsof), run with proper user permissions, install required libraries, and restart service.
8) Encrypted channels fail to establish
- Cause: Key mismatch, certificate problems, or TLS handshake blocked.
- Fix: Verify both peers use compatible encryption settings, replace or re-import certificates/keys, and ensure intermediate devices aren’t intercepting TLS.
9) UI shows stale or incorrect status
- Cause: Cached data or client-server sync issues.
- Fix: Refresh or restart the client, clear cache/config files, and confirm server time/settings match.
10) General diagnostic steps (quick checklist)
- Update to latest stable Demonsaw release.
- Check client/server logs for errors (include timestamps).
- Verify ports and firewall/NAT rules; test with a simple TCP/UDP tool.
- Sync system clocks (NTP).
- Test between two local machines to isolate network vs app.
- Recreate identity/keys if cryptographic errors appear.
- Collect logs and exact error messages before seeking help.
If you want, I can write specific command examples for checking ports, collecting logs, or a short step-by-step for a particular OS—tell me which OS.
Leave a Reply