5,838
edits
MX on Linux: Difference between revisions
m
Minor rephrasing and layout improvement re release 3.15.1 change
m (Updated for MX release 3.15.1 - only affects section 9.4 re editing service file) |
m (Minor rephrasing and layout improvement re release 3.15.1 change) |
||
|
=====Technical users - optional edit to "[Unit]" section=====
The content of the "[Unit]" section of the service description file described here has evolved slightly as MX develops. The
#*
#** That means that '''after''' "systemd" has started the "cumulusmx" service, it can start the network service.
#** Note that the terminology ''after'' does not guarantee the network online detection service will be started.
# From release 3.15.1 build 3170 (19 March 2022) a second mention was added, so the content became: <pre>Wants=network-online.target
After=network-online.target</pre>
#* The "wants" line tells "systemd" that the "cumulusmx" service wants the network online detection service to be started.
#**
# Within the provided file you should find a '''[Unit]''' section:▼
#* As mentioned above, the content of this section depends upon which MX release you are using.▼
#* All release distributions that contain the file should have the following three lines:▼
#*# <code>Description=CumulusMX service</code>▼
#
#
# Use the editor to create a blank line after <code>Documentation=https://cumuluswiki.org/a/Main_Page</code>
▲#** You may see a line saying <code>Wants=network-online.target</code>, that tells "systemd" that the "cumulusmx" service wants the network online detection service to be started. Note that the terminology ''wants'' means MX can still start even if the network service is not running, or if the attempt to start the network service fails
▲# Technical users should use the editor to create a blank line after <code>Documentation=https://cumuluswiki.org/a/Main_Page</code>
# Type into that blank line the following: <code>Requires= time-sync.target local-fs.target</code>
#* The terminology ''Requires'' tells "systemd" that the "cumulusmx" service
#*# The '''local-fs.target''' specifies that the ''cumulusmx'' service requires the file service to have started, i.e. checks your computer can read files before it attempts to start the ''cumulusmx'' service
#*# The '''time-sync.target''' specifies that the ''cumulusmx'' service requires the computer to have synced with either a real-time clock chip, or a time found on the internet (NTP), i.e. this will ensure that Cumulus obtains the correct time from the computer to control all its actions
#*#* If you are using a weather station type that does not time-stamp the
#*#* A standard RPi does not include a real time clock chip (it can be added via connections available), therefore when the RPi boots it initially uses a dummy clock, and this sets the time to when the RPi was last running.
#*#* That means without this target being included, a newly booted-up RPi will tell Cumulus MX the time is just after when the computer was shut down, that might be very different to the true current time. It means your Cumulus MX on restarting will skip the catch-up of historic data (should your weather station settings make that available). Some measurements will then get logged against the wrong time.
| |||