ukmon general - markmac99/ukmon-pitools GitHub Wiki
Follow these instructions on the GMN wiki.
-
If you're starting from scratch, follow these instructions to install RMS onto an SD card. The latest RMS image can be obtained from the GMN website here
-
Once you've burned the image (see note below), insert the SD card into the Pi, boot it and follow the onscreen instructions to configure RMS.
-
Once you have RMS configured and ready to run you can add the UKMON tools by following the instructions here
We recommend Balena Etcher to burn the image to disk. You don't need to uncompress the image as Balena will recognise it. For first boot, you must have a keyboard, mouse and screen attached to the Pi because some configuration steps are graphical. Also make sure the micro-HDMI cable is plugged into the port nearest the USBC power inlet. After the system boots you'll see the RMS configuration window onscreen. Follow the instructions in this window carefully. Every step is needed.
After booting the Pi, you must run the following commands in a Terminal window to make sure your station's anyDesk ID is unique:
sudo rm /etc/anydesk/service.conf
sudo systemctl restart anydesk
If you don't do this its likely your AnyDesk ID will be shared with another station allowing people to hack into your Pi and make unexpected changes.
- ''liveMonitor.sh'' uploads potential meteor images in near-realtime to the ukmeteor data website.
- ''ukmonPostProc.py'' uploads detailed data to the UKMON servers at the end of the night, once RMS has finished data capture and processing.
- ''gatherLogs.sh'' allows you to upload logs to the servers so someone can provide help and diagnose problems.
You don't need to. RMS contains an EventMonitor that allows us to collect the data within 30 minutes if needed.
However, if you spot a fireball you think we've missed, please post details of the time and date in groups.io channel. We'll then collect the data using the toolset.
- open a terminal window and type
echo "1" > /home/pi/source/ukmon-pitools/domp4s
- to disable creation, simply remove the file by typing:
rm /home/pi/source/ukmon-pitools/domp4s
This is now a part of RMS and can't be disabled.
Sometimes, RMS or the ukmon tools can become corrupted. This can happen if there's a power outage or the pi runs out of diskspace during the daily refresh process. It often shows up as git errors in the logs, references to missing functions or failures to upload properly. This corruption must be repaired as it means your station is missing out on upgrades, bugfixes and enhancements, and may stop functioning correctly.
The safest fix is to reinstall the tools and copy the config files over. Fortunately its extremely simple and quick.
During the day, when the system isn't capturing data, open a Terminal window and run the following commands:
cd $HOME/source
mv ukmon-pitools ukmon-pitools.old
git clone https://github.com/markmac99/ukmon-pitools.git
cp ukmon-pitools.old/ukmon.ini ./ukmon-pitools
cp ukmon-pitools.old/live.key ./ukmon-pitools
Now check that ukmon.ini has the correct server address 3.11.55.160 and then rerun refreshTools.sh which should run cleanly. There may be unrelated warnings that pip is out of date, to remove those follow the onscreen advice.
Finally, reboot the pi to ensure the new code is picked up. After a few days of successful operation you can delete the old folder.