Old description below

We assume that BOSWatch is installed to /opt/boswatch! Otherwise you need to adapt all the pathes in this description and in the service-file itself.

Enter the frequency and the decoder(s) you want to use in line 7; you can add more specific switches if you need to

1. Use the install-script install_service.sh as sudo: sudo bash install_service.sh (self explaining)

OR

1. Copy the file to /etc/systemd/system: sudo cp /opt/boswatch/service/boswatch.service /etc/systemd/system/
2. Enable the service: sudo systemctl enable boswatch.service
3. Start the service: sudo systemctl start boswatch.service
4. Check the status: sudo systemctl status boswatch.service

Lines 14 and 15 define where to find the Python script. In this case the script expects that there is a folder /usr/local/bin/BOSWatch and that the script is inside there.

Line 23 sets what user to run the script as. Using a root-user is necessary for BOSWatch.

Line 19 sets the parameters for BOSWatch, use the same as starting BOSWatch from the shell. We recommend to use "-u" and "-q" when you want to run BOSWatch as a daemon.

• "-u": You will find the logfiles in /var/log/BOSWatch
• "-q": Shows no information. Only logfiles

To actually use this script, put BOSWatch where you want (recommend /usr/local/bin/BOSWatch) and make sure it is executable (e.g. sudo chmod 755 boswatch.py). Edit the init script accordingly. Copy it into /etc/init.d using e.g. sudo cp boswatch.sh /etc/init.d. Make sure the script is executable (chmod again) and make sure that it has UNIX line-endings. After creating this new daemon it's neccessary to do a sudo systemctl daemon-reload in order to make it findable.

At this point you should be able to start BOSWatchcd ~/srt using the command sudo /etc/init.d/boswatch.sh start, check its status with the sudo /etc/init.d/boswatch.sh status argument and stop it with sudo /etc/init.d/boswatch.sh stop.

To make the Raspberry Pi use your init script at the right time, one more step is required: Running the command sudo update-rc.d boswatch.sh defaults. This command adds in symbolic links to the /etc/rc.x directories so that the init script is run at the default times. You can see these links if you do ls -l /etc/rc?.d/*boswatch.sh