Category:Cumulus MX: Difference between revisions

264 bytes added ,  20:40, 18 March 2020
m
(→‎Introduction: Rewritten, was previously talking about volunteers testing an experimental project)
Line 31: Line 31:
= Installing Cumulus MX =
= Installing Cumulus MX =


There is no automatic installer (this may change). If you want to start a completely new installation, create a directory and unzip the contents into it. I've assumed that zip files are not a problem on Linux or OS X, please let me know if that's not the case. If you want to run Cumulus MX with your existing Cumulus data, take a copy of your existing Cumulus directory, and then unzip Cumulus MX into it. Alternatively, you can unzip Cumulus MX into new directory first, and then copy over your existing data files and your Cumulus.ini file, and any other configuration files that you may have created (e.g. strings.ini, twitter.txt etc). If your Cumulus.ini is actually called "cumulus.ini" you should rename it to start with a capital letter.
There is no automatic installer (this may change). Cumulus MX is supplied as a zipped package.


On Linux and OS X you will need to install the Mono runtime. For OS X, you can download this here - http://www.mono-project.com/download/. How you install on Linux depends on the flavour of Linux you are running. There are download links for Linux at the same URL, but it is often easier to use a package manager, which will download and install it automatically. For example, in 'Raspbian' on the Raspberry Pi, you can install mono with these commands:
== Completely new installation ==
Create a new directory (recommended name CumulusMX) and unzip the contents into it.


== Changing from Cumulus 1 to MX ==
* If you want to run Cumulus MX with your existing Cumulus data, take a back up copy of your existing Cumulus directory, and then unzip Cumulus MX into the original Cumulus folder.
* Alternatively, create a new directory (recommended name CumulusMX) and unzip the contents into it. Then copy over your existing data files and your Cumulus.ini file, and any other configuration files that you may have created (e.g. strings.ini, twitter.txt etc). If your "Cumulus.ini" was actually called "cumulus.ini" you should rename it to start with a capital letter.
== Requirements for running on Windows ==
To run MX on Windows, you need .NET 4.5 installed. This is only available for newer versions of Windows.
== Requirements for running on Linux and OS X ==
You will need to install the Mono runtime.
* For OS X, you can download this here - http://www.mono-project.com/download/.
* How you install on Linux depends on the flavour of Linux you are running. There are download links for Linux at the same URL, but it is often easier to use a package manager, which will download and install it automatically.
**For example, in 'Raspbian' on the Raspberry Pi, you can install mono with these commands:
<pre>
sudo apt-get update
sudo apt-get update
sudo apt-get install mono-complete
sudo apt-get install mono-complete
 
</pre>
Make sure that you have the mono-complete package installed.  
Make sure that you have the mono-complete package installed.  


If you have a Raspberry Pi 2, there is a later version of Mono available, which you may find works better that the one in the standard distribution, particularly if you use decimal commas. Mono 3.2.8 (which is the default in some Linux distributions) will not work if you use commas for decimals, as in some countries.
**If you have a Raspberry Pi 2, there is a later version of Mono available, which you may find works better that the one in the standard distribution, particularly if you use decimal commas. Mono 3.2.8 (which is the default in some Linux distributions) will not work if you use commas for decimals, as in some countries.


On Linux you will need library libudev.so.0 which may not be installed by default. Installing package libudev0 may resolve this. There may be issues if you are using a 64-bit version of Linux. I'm not sure what the resolution is at the moment, if this is the case.
**On Linux you will need library libudev.so.0 which may not be installed by default. Installing package libudev0 may resolve this. There may be issues if you are using a 64-bit version of Linux. I'm not sure what the resolution is at the moment, if this is the case.


= Running Cumulus MX =
= Running Cumulus MX =
5,838

edits