Skip to content

Commit f25f5c1

Browse files
committed
Minor tweaks to the pn troubleshooting
1 parent fc29a0a commit f25f5c1

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

docs/pn-troubleshooting-guide.md

+6-5
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Debugging Guide for Acorn App Push Notifications
1+
# Push Notifications Troubleshooting Guide
22

3-
This guide provides steps to troubleshoot issues with push notifications in the Acorn app using the `hemlock-sendmsg` daemon. Follow these steps to identify and resolve problems with notifications on both iOS and Android devices.
3+
This guide provides steps to troubleshoot issues with push notifications using the `hemlock-sendmsg` daemon. Follow these steps to identify and resolve problems with notifications on both iOS and Android devices.
44

55
## Common Issues
66
1. **Notifications not received on iOS or Android.**
@@ -12,8 +12,8 @@ This guide provides steps to troubleshoot issues with push notifications in the
1212

1313
### 1. Verify Build and Device Registration
1414
- Ensure that the device has the correct build version of the app:
15-
- **Android:** Version should be 3.1.0.6. Check via `Play Store >> Profile Icon >> Manage apps & device >> Acorn >> About this app`.
16-
- **iOS:** Version should be 3.1.0 (2). Check via TestFlight or App Store.
15+
- **Android:** Version should be at least 3.1.0.x. Check via `Play Store >> Profile Icon >> Manage apps & device >> Acorn >> About this app`.
16+
- **iOS:** Version should be at least 3.1.0 (x). Check via TestFlight or App Store.
1717
- Confirm the device is registered to receive push notifications:
1818
- Only one device can be registered for push notifications per patron account. The last device to log in will be the active one.
1919

@@ -46,6 +46,7 @@ This guide provides steps to troubleshoot issues with push notifications in the
4646
~~~bash
4747
git pull
4848
make
49+
sudo make install
4950
sudo systemctl restart hemlock-sendmsg
5051
~~~
5152
- Check the daemon output for correct startup and notification processing:
@@ -98,4 +99,4 @@ This guide provides steps to troubleshoot issues with push notifications in the
9899
2. Ensure that the `hemlock-sendmsg` daemon is updated and configured properly.
99100
100101
## Additional Notes
101-
- The `hemlock-sendmsg` daemon has a new feature that allows filtering out patrons who do not have accounts in the app (EmptyToken metric). Refer to the [README](https://github.com/kenstir/hemlock-sendmsg/blob/main/README.md#collecting-metrics) for more details.
102+
- The `hemlock-sendmsg` daemon filters out requests with an empty `token` parameter, so it does not attempt to send a push notification to a patron that does not use the app. The `EmptyToken` metric tracks the number of such requests. Refer to the [README](https://github.com/kenstir/hemlock-sendmsg/blob/main/README.md#collecting-metrics) for more details.

0 commit comments

Comments
 (0)