5,838
edits
MX on Linux: Difference between revisions
m
Simplify some instructions by saying novice can skip
m (→apt) |
m (Simplify some instructions by saying novice can skip) |
||
| Line 206: | Line 206: | ||
MX uses this library for weather stations (like Fine Offset and USB connected Oregon Scientific models) that appear as a HID via a USB connection. To check if your weather station appears as a HID, download this [https://cumulus.hosiene.co.uk/download/file.php?id=11414 USB HID test package] and run it. | MX uses this library for weather stations (like Fine Offset and USB connected Oregon Scientific models) that appear as a HID via a USB connection. To check if your weather station appears as a HID, download this [https://cumulus.hosiene.co.uk/download/file.php?id=11414 USB HID test package] and run it. | ||
This HidSharp library calls a package ''libudev shared library'' file called ''libudev.so.1''. Most recent Linux distributions will already include the libudev shared library. On my Raspberry Pi, [[#install|typing]] <code>apt search libudev</code> showed ''libudev.so.1'' was already installed. If it is missing, then [[#install]] it. | This HidSharp library calls a package ''libudev shared library'' file called ''libudev.so.1''. Most recent Linux distributions will already include the libudev shared library. On my Raspberry Pi, [[#install|typing]] <code>apt search libudev</code> showed ''libudev.so.1'' was already installed. If it is missing, then [[#install]] it. | ||
| Line 271: | Line 270: | ||
=Cumulus packages= | =Cumulus packages= | ||
Note use of plural in section name above, the following sub-sections will install various packages produced by Developer Mark Crossley. If you are using the [[Software#Cumulus_MX|pre-built disc image]], then (unless the MX release version included in your image is an old one) you should skip the instructions for "CumulusMX". | Note use of plural in section name above, the following sub-sections will install various packages produced by Developer Mark Crossley. If you are using the [[Software#Cumulus_MX|pre-built disc image]], then (unless the MX release version included in your image is an old one) you should skip the instructions for installing "CumulusMX" itself. | ||
==Handling zip files== | ==Handling zip files== | ||
| Line 299: | Line 298: | ||
*# The developer suggests you use ‘’’/opt’’’ for EXISTING PATH (which should be available on any Linux computer). | *# The developer suggests you use ‘’’/opt’’’ for EXISTING PATH (which should be available on any Linux computer). | ||
*#* By default, the code Mark provides for installing Cumulus as a service, will run that service as a root user, and the root user has full permissions in /opt (and everywhere else) | *#* By default, the code Mark provides for installing Cumulus as a service, will run that service as a root user, and the root user has full permissions in /opt (and everywhere else) | ||
*#* If you do choose a EXISTING PATH outside your home folder, | *#* (Novices: Skip this step) If you do choose a EXISTING PATH outside your home folder, then a more technical user can change the ownership of the "CumulusMX" sub-folder, to the default user (Pi) with <code>sudo chown -R pi: EXISTING PATH/CumulusMX</code>, and reduce the need to use "sudo" on many actions. | ||
==Packages to install== | ==Packages to install== | ||
| Line 445: | Line 444: | ||
This list of parameters covers every parameter, if you are using the latest release skip the historic 3.0.0 sub-sections. | This list of parameters covers every parameter, if you are using the latest release skip the historic 3.0.0 sub-sections. | ||
Note that you ''may'' need to supply your root password after typing any 'sudo ...' command line if the instruction changes something set by another package (e.g. changing the locale for MX from the locale set by mono). The system will prompt you for this if it is needed. | Note that you ''may'' need to supply your root password after typing any 'sudo ...' command line if the instruction changes something set by another package (e.g. changing the locale for MX from the locale set by mono). The system will prompt you for this if it is needed. | ||
| Line 452: | Line 449: | ||
=== -port parameter for changing Port === | === -port parameter for changing Port === | ||
When Cumulus starts, it will display the URL of the user interface. It runs on port 8998 by default; if this is not suitable for some reason you can | When Cumulus starts, it will display the URL of the user interface. It runs on port 8998 by default; if this is not suitable for some reason you can change it using the '-port' parameter on the command line, e.g. to use port 9999 instead: | ||
<pre>sudo mono CumulusMX.exe -port 9999</pre> | <pre>sudo mono CumulusMX.exe -port 9999</pre> | ||
=== -lang parameter for changing Locale === | === -lang parameter for changing Locale === | ||
Individual computers may have different default for their locale. The forum reported an issue with OS X with its default US locale even if that is not your locale. | |||
As MX starts its output (to diagnostic log and to any interactive terminal window) says which locale is being used, '''Current culture: English (United States)'''. That default locale will relate to the one your computer had when mono is installed, as it is mono that tells MX all the locale settings. If you notice MX starting with wrong locale, issue the correct instruction to close MX. | |||
You can use a '''-lang''' parameter to change the locale as you restart MX. For example, in the UK, type: | |||
:<code>sudo mono CumulusMX.exe -lang en-GB</code> | :<code>sudo mono CumulusMX.exe -lang en-GB</code> | ||
Other locale examples: | Other locale examples: '''CumulusMX.exe -lang de-DE''', '''CumulusMX.exe -lang el-GR''' (this is one of the locales that reads numbers with '''integer,decimal''' format), '''CumulusMX.exe -lang nl-NL'''. | ||
If you are not sure what value you need to supply for the -lang parameter, there is a list here - http://msdn.microsoft.com/en-gb/library/ee825488%28v=cs.20%29.aspx. You need to supply the code in the first column ("Language Culture Name") in that list. | If you are not sure what value you need to supply for the -lang parameter, there is a list here - http://msdn.microsoft.com/en-gb/library/ee825488%28v=cs.20%29.aspx. You need to supply the code in the first column ("Language Culture Name") in that list. | ||
| Line 488: | Line 489: | ||
There are some edits needed to that section: | There are some edits needed to that section: | ||
# | # Technical users might want to edit the '''User=root''' line so that the service will run as a different user, novice users are best to leave this alone | ||
# | # Everyone must edit the line that begins with '''ExecStart=''' | ||
#* The mandatory change is to replace '''/home/install''' by what you have selected for EXISTING PATH | #* The mandatory change is to replace '''/home/install''' by what you have selected for EXISTING PATH | ||
#* An optional change is to add additional parameters after the '''-service''' (select from '''-debug''', -locale, -port) as described in sub-sections above | #* An optional change is to add additional parameters after the '''-service''' (select from '''-debug''', -locale, -port) as described in sub-sections above | ||
#save file with a new name ''' | # Next save file with a new name '''cumulusmx_edited.service''' (using a new name stops it being overwritten when we upgrade MX | ||
# | # Now copy file to where it is needed to run the service <code>sudo cp EXISTING_PATH/CumulusMX/MXutils/linux/cumulusmx_edited.service /etc/systemd/system/cumulusmx.service</code> | ||
# Finally, optionally create a symbolic link to that file using <code>sudo systemctl enable cumulusmx</code> if you want the service to start after a reboot | |||
< | |||
====Setting up as a service in release 3.8.0 ==== | ====Setting up as a service in release 3.8.0 ==== | ||