5,838
edits
MX on Windows OS: Difference between revisions
m
→Introduction: add Cumulus.ini notes to bring in line with MX on Linux page
m (→Optional parameters to add to the instruction to run the MX engine: Make definitive) |
m (→Introduction: add Cumulus.ini notes to bring in line with MX on Linux page) |
||
| Line 13: | Line 13: | ||
*If you encounter a problem when running MX, see [[What to do when I have a problem with MX]] | *If you encounter a problem when running MX, see [[What to do when I have a problem with MX]] | ||
*The [[Cumulus MX FAQ]] page was created with snippets from the forum, but nobody has yet sorted this out into a useful page or updated it for recent releases | *The [[Cumulus MX FAQ]] page was created with snippets from the forum, but nobody has yet sorted this out into a useful page or updated it for recent releases | ||
*If you want to use a script language, you might want to read [[PHP|PHP Hypertext Pre-processor and JavaScript]] page | *If you want to use a script language, you might want to read [[PHP|PHP Hypertext Pre-processor and JavaScript]] page | ||
If you previously used an older release of Cumulus, but in this new installation will be using the latest release (latest is what is normally best, unless it has bugs), you may want to read up on all the changes between your old release, and the current release, not just changes that affect the configuration file mentioned in section after next. | |||
==Migrating from Cumulus 1== | |||
If you were using the original (now legacy) Cumulus software, please read [[Migrating_from_Cumulus_1_to_MX]], before you follow the instructions on this page. | |||
Please note that migration from Cumulus 1 gets harder and harder as MX is developed and diverges more and more from the original software. Therefore, it is strongly recommended that you transfer to an old MX release and then upgrade to a newer MX release as described below. | |||
In particular you need to understand configuration differences, so that is covered next. | |||
==Cumulus.ini== | |||
If you are moving from the legacy software to a MX release of 3.8.0 or later, many people prefer to not migrate their existing “Cumulus.ini” file. Instead, they work through all the settings manually on the new install, so that MX can create a fresh file, with them having confidence every setting reflects their preference. | |||
There were significant changes to “Cumulus.ini” when moving from 1.9.4 to 3.0.0, see [[Cumulus_3_(MX)_beta_documentation]] and [[Migrating_from_Cumulus_1_to_MX]] pages. As described [[Updating_MX_to_new_version|on upgrading advice page]] in this Wiki, moving from 1.9.4 to MX is best done gradually upgrading through releases, as a number of Cumulus files (e.g. [[Amending_dayfile#Date_Separator_in_MX|dayfile.txt]]), and any database tables you are using, may also need adjusting as you progress up through releases, and that is best done at correct in-between releases (see individual MX release announcements in support forum). Documentation for the 1.9.4 '''cumulus.ini''' file can be found [[Cumulus.ini_(Cumulus_1)|here]] should you need to work on your old legacy file. | |||
There were gradual changes to “Cumulus.ini” as releases went from 3.0.0 to 3.7.0, documentation can be found [[Cumulus.ini (MX_3.0.0_to_3.7.0)| here]] where, hopefully, the changes are made clear. ''Within that range of releases, you should continue to use any existing '''Cumulus.ini''' file, as you might lose vital "read-only" parameters by starting a new file.'' As mentioned before, the [[Updating_MX_to_new_version|upgrading advice page]] is the best place to seek advice on which releases to upgrade to which, rather than attempting to directly upgrade to latest release. | |||
The documentation for various later MX releases (covering just 3.8.0 to 3.12.0 at the time this paragraph was last updated) can be found at [[Cumulus.ini]]. ''If you previously used Cumulus 1.x.y, or a release before 3.8.0, please note that there have been '''major changes''' to the parameters included in the file. You must proceed with caution if you want to use a file created by an older release as it will lack loads of new parameters that are now mandatory in MX''. However, [[Cumulus.ini|the configuration file page]] does include advice on (while MX is running) you can automatically update, either an existing file, or to create a new file, that approach will add all the new parameters (although some will not receive valid values, and others might default away from your preferences). | |||
=Download MX release= | =Download MX release= | ||