MX on Linux: Difference between revisions

MX on Linux (view source)

Revision as of 12:45, 30 August 2020

2,997 bytes added , 12:45, 30 August 2020

m

→‎Installing MX

Sfws

5,838

edits

@@ Line 192: / Line 192: @@
 As the Pi does not know exactly which components are needed when multiple packages are installed with various dependencies, sometimes extra components are installed which in the end are not needed when you complete all your installations. To clear up, delete any components that are not included in dependencies by typing <tt>sudo apt autoremove</tt>.
-== Installing MX ==
+== Installing (or updating) MX ==
+=== MX Distribution ===
 Download whatever version of MX you have decided to install (sometimes the latest version has bugs that might cause a problem for your station or the functionality you use) from [https://github.com/cumulusmx/CumulusMX/releases CumulusMX/releases]
+If you are doing this on your Pi, you will need to click '''extract''' and choose where the files go.
+If you are download on your PC, then you will probably unzip the distribution there and use a tool like FileZilla to copy the installation to your Pi.
+First of all you need to configure FileZilla Client, unless you have done that previously and saved the configuration:
+* Host - this is the IPv4 address of your Pi, I can't tell you what it is, but it is likely to be '''192.168.z.xy''' where the z is likely to be a single figure like 0 or 1, and the xy is two figures you can find out by looking for "pi" (or whatever host username you have set on your Pi) in the admin interface for your hub or router. (It can also be found out by typing <tt>hostname -I</tt>). Most networks are setup in a way that the subnet range is from 192.168.1.0 to 192.168.1.255.
+* Username - the default for this is '''raspberrypi''' (although on older Pi it might be '''Pi'''), but you can may have changed this (as described earlier). (It can be found by typing <tt>hostname</tt>).
+* Password - again the default for this is '''raspberry''' but we changed it as one of the mandatory configurations earlier.
+* Port - 22 is the default, and I have not said how you can change this!
+Click '''QuickConnect''' and you should see the local files in the left frame and your Pi files in the right frame. The easiest way is to find the folder called '''CumulusMX''' in the distribution on the left and drag it to the correct position in the right hand frame. Then all you need to do is watch the progress until it successfully finishes.
+=== Configuration files ===
+If you have used Cumulus before, but this is first installation on Pi, then you need to copy some files from old installation to your Pi, here are a couple but you may have further configuration files to copy across:
+*Cumulus.ini
+*Strings.ini
+The two examples above are in same folder as Cumulus.exe or CumulusMX.exe. You also may have configuration files in a '''mqtt''' folder, or elsewhere (for example I store some batch files that Cumulus runs for me in a batch folder).
+=== data and Reports files ===
+The entire content of your existing  '''data''' and '''Reports''' folder should also be copied  across to your Pi or transferred across using FileZilla or a similar tool. The same settings as for the distribution can be used, but you will have a different starting point in your left frame.
+== Running Cumulus ==
+The simplest command to start Cumulus is <tt>sudo mono CumulusMx.exe</tt>, but you may wish to add [[Cumulus_MX#Optional_parameters_to_add_to_the_instruction_to_run_the_MX_engine|Optional_parameters]].
+In the Cumulus Support forum, there are articles about a stop/start routine, a backup routine, and how to run MX as a service. I will let you hunt for and read the relevant topics, as you may find details in more than one place. This article will avoid these and try to keep it simple.
 = old notes =