Category:Cumulus MX: Difference between revisions

4,179 bytes removed ,  13:30, 13 April 2020
m
Line 586: Line 586:


Finally, don't delete your old installation for a week or so as you may notice something from the older version that you haven't copied across!
Finally, don't delete your old installation for a week or so as you may notice something from the older version that you haven't copied across!
= Running Cumulus MX =
# Make sure your weather station (and any extra sensors) is connected to the device on which you have installed Cumulus MX, before you try to run Cumulus MX.
# Start Cumulus MX engine (command to do this varies between operating systems, so see sub-heading for your device below
# Start user interface, it runs in a browser, by default on port 8998, see [[#User_Interface|section]] below.
If you are running MX for the first time, without a configuration file (none is included in download package), see [[Cumulus.ini#Cumulus_MX|here]] for screen shots and instructions.
== Windows ==
Cumulus MX initiates a web server, to do this it may need administrative access, consequently to avoid having to run MX as an administrator you can issue a command that allows all users to bind to port 8998 which is the web server it initiates (this is used for the Cumulus MX user interface). Note that if you plan to change the interface port by using the port parameter in your launch of MX, you should change the 8998 to whatever port you are planning on using. To enter the command, first open a command window as administrator. One way to do this is to right click the windows symbol at the start of the windows task bar. The option to choose there (on windows 10) is '''Windows PowerShell (admin)''', but an option called '''Command Prompt (Administrator)''' will also work. Once that opens a new window type:
<pre>
netsh http add urlacl url=http://*:8998/ user=\users
</pre>
You only need to do that once. After than you can initiate MX from any user, you don't need to run as administrator.
'''Each time you want to run Cumulus:'''
#First start the engine in one of the following 3 ways  (there are some optional parameters that can be used with the .exe call as mentioned below):
#*Open the folder where you installed MX and click on the CumulusMX.exe to run it.
#* OR create a shortcut on your desktop (and/or the taskbar) for that executable and click the shortcut to start the engine.
#* OR place the shortcut in the start up folder for the user account so MX automatically starts when you connect/log in.
# Next start the user interface, it does not need to run all the time, but only when you need it (when you first use MX you will need it to access the settings where you tell MX what type of station you have and what units you want to use, and set various timing options), it normally runs on port 8998 (to vary that there is a '''-port''' parameter that is followed by required port and that port parameter has to be entered every time you start MX if you are not using the default port).
== Linux and OS X ==
Open a terminal window, change to the Cumulus MX directory, and then type:
<pre>sudo mono CumulusMX.exe</pre>
== Optional parameters to add to the instruction to run the MX engine ==
=== 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 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>
=== Parameter for changing Locale ===
On Linux and (in particular) OS X, Cumulus MX may not be given the correct locale to use, and you may get the default US locale even if that is not your locale. It will output the local it is using when it starts; if it is not correct, close it down and start it again, this time specifying your locale on the command line, using the -lang parameter . For example, in the UK, type:
<pre>
sudo mono CumulusMX.exe -lang en-GB
</pre>
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"). Note that this does not affect the language used by Cumulus MX (although it may in the future), it affects the decimal separator and the list separator.
Note that you ''may'' need to supply your administrator password after typing the 'sudo ...' command line. The system will prompt you for this if it is needed.


= User Interface =
= User Interface =
5,838

edits