MX on Linux: Difference between revisions

37 bytes added ,  10:27, 23 July 2021
m
→‎Running MX on Linux: change sequence of parameters
m (→‎Running MX on Linux: change sequence of parameters)
Line 406: Line 406:
This section explores the optional parameters, and then covers 2 ways to run MX:
This section explores the optional parameters, and then covers 2 ways to run MX:
# as a service and  
# as a service and  
#directly with terminal window left open.
# interactively with terminal window left open.


== 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 415: Line 415:


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.
=== Version 3.0.0 Beta builds of MX ===
The following two parameters cannot be used with MX since it came out of 3.0.0 beta.
==== web sockets ====
Beta builds in MX version 3.0.0 had an optional parameter <code>sudo mono EXISTING PATH/CumulusMX/CumulusMX.exe -wsport nnnn</code> that determined which port (represented by a 4 digit number ''nnnn'') was used for '''Web Sockets'''.
That parameter is now deprecated as Web Sockets in all builds since 3045 uses the same port as the rest of the [[MX_Administrative_Interface#The_API_interface|Admin Interface]], see Port parameter below.
==== Debugging of data flow between station and MX====
Use '''sudo mono CumulusMX.exe -Logging=1''' (for the station to MX transfers to have increased debugging logging).
Note use of this parameter is now deprecated.
Although this is not mentioned in any release announcements, it appears that on all recent MX releases this effect is incorporated into the '''-debug''' parameter.  Perhaps someone could confirm whether this is true.


=== Parameter for changing Port ===
=== Parameter for changing Port ===
Line 512: Line 493:
# Type <code> mono-service -l:/var/run/cmx.pid CumulusMX.exe -service</code>
# Type <code> mono-service -l:/var/run/cmx.pid CumulusMX.exe -service</code>
# (to verify) note this does not allow you to add -port, -debug, -locale parameters
# (to verify) note this does not allow you to add -port, -debug, -locale parameters
=== Parameters only applicable to Version 3.0.0 Beta builds of MX ===
The following two parameters cannot be used with MX since it came out of 3.0.0 beta.
==== web sockets ====
Beta builds in MX version 3.0.0 had an optional parameter <code>sudo mono EXISTING PATH/CumulusMX/CumulusMX.exe -wsport nnnn</code> that determined which port (represented by a 4 digit number ''nnnn'') was used for '''Web Sockets'''.
That parameter is now deprecated as Web Sockets in all builds since 3045 uses the same port as the rest of the [[MX_Administrative_Interface#The_API_interface|Admin Interface]], see Port parameter below.
==== Debugging of data flow between station and MX====
Use '''sudo mono CumulusMX.exe -Logging=1''' (for the station to MX transfers to have increased debugging logging).
Note use of this parameter is now deprecated.
Although this is not mentioned in any release announcements, it appears that on all recent MX releases this effect is incorporated into the '''-debug''' parameter.  Perhaps someone could confirm whether this is true.


==Running as a service==
==Running as a service==
5,838

edits