MX on Windows OS: Difference between revisions

150 bytes added ,  09:55, 11 April 2021
m
→‎ExportMySQL.exe: rewrite as no longer part of release distribution
m (→‎Parameter for changing Locale: cut (not written for Windows))
m (→‎ExportMySQL.exe: rewrite as no longer part of release distribution)
(One intermediate revision by the same user not shown)
Line 184: Line 184:
== CumulusMX.exe ==
== CumulusMX.exe ==


Whilst effectively MX is run by a '''CumulusMX.exe''' or '''sudo mono CumulusMX.exe''' depending on device, you actually need to ensure all the other components are loaded, so you either have a package that runs it for you, or you click a shortcut that includes the necessary path setting.
Whilst effectively MX is run by a '''CumulusMX.exe''', you actually need to ensure all the other components are loaded, so you either have a package that runs it for you, or you click a shortcut that includes the necessary path setting.


=== Optional parameters to add to the instruction to run the MX engine ===
=== Optional parameters to add to the instruction to run the MX engine ===
Line 193: Line 193:


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 over-ride it using the '-port' parameter on the command line, e.g. to use port 9999 instead:
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 over-ride 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>CumulusMX.exe -port 9999</pre>


==== Parameter for adding debugging ====
==== Parameter for adding debugging ====
Line 203: Line 203:
You can also add  '''CumulusMX.exe -debug''' (to have full debugging of actions by MX turned on as MX starts), and/or '''CumulusMX.exe -Logging=1''' (for the station to MX transfers to have increased debugging logging).  
You can also add  '''CumulusMX.exe -debug''' (to have full debugging of actions by MX turned on as MX starts), and/or '''CumulusMX.exe -Logging=1''' (for the station to MX transfers to have increased debugging logging).  


<pre>sudo mono CumulusMX.exe -debug -Logging=1</pre>
<pre>CumulusMX.exe -debug -Logging=1</pre>


Since this parameter is applied when you start MX, it applies while MX continues to run. Obviously, it must be applied every time you start MX if you want this increased level of logging to continue every time you restart MX.
Since this parameter is applied when you start MX, it applies while MX continues to run. Obviously, it must be applied every time you start MX if you want this increased level of logging to continue every time you restart MX.
Line 211: Line 211:
== [[ExportMySQL.exe]] ==
== [[ExportMySQL.exe]] ==


This second exe file (see link in heading) was available since the original MX beta package that Steve Loft developed this in April 2015, until Mark Crossley replaced it in March 2021.


<big>The package described here has been replaced by '''ExportToMySQL.exe''', which is an improved version with slight differences in parameters and functionality.  The new package is documented at [https://github.com/cumulusmx/ExportToMySQL Export To My SQL]</big>
<big>The package described here has been replaced by '''ExportToMySQL.exe''', which is an improved version with slight differences in parameters and functionality.  The new package is documented at [https://github.com/cumulusmx/ExportToMySQL Export To My SQL]</big>


Sadly few people even notice it exists, and if they do, it is unlikely they know how to use it. Hopefully, some people will read this section and find out!


Obviously it was updated when Mark Crossley added the Feels Like fields to log files.
This second exe file (see link in heading) was available in the original MX beta package that Steve Loft developed in April 2015, it remained part of the standard release distribution until March 2021. As noted above, it is no longer part of the MX release distribution and has been replaced by Mark Crossley with a separate package with a slightly more meaningful name.
 
Sadly few people even notice ExportMySQL.exe exists, and if they do, it is unlikely they know how to use it. Hopefully, some people will read this section and find out!
 
Obviously, the original executable was updated when Mark Crossley added the Feels Like fields to log files.


Put simply, this executable will read log files and insert (insert ignore) rows into an existing database table. Since it only does inserts, despite the name of this function, it is not just for MySQL tables, the included SQL should work with whatever database table type you have.  
Put simply, this executable will read log files and insert (insert ignore) rows into an existing database table. Since it only does inserts, despite the name of this function, it is not just for MySQL tables, the included SQL should work with whatever database table type you have.  
5,838

edits