5,838
edits
Category:Cumulus MX: Difference between revisions
m
→What I did to Install MX: added sub-headings
m (→Comparing Cumulus 1 and MX: corrected reference) |
m (→What I did to Install MX: added sub-headings) |
||
| Line 93: | Line 93: | ||
== What I did to Install MX == | == What I did to Install MX == | ||
I have used Cumulus 1 for a decade or so, and been very happy with it, but I wanted to give MX a go without affecting my Cumulus 1 installation. Here is exactly what I did on my ex NHS Windows 10 Pro PC, step by step; I am hoping it might help some readers. | I have used Cumulus 1 for a decade or so, and been very happy with it, but I wanted to give MX a go without affecting my Cumulus 1 installation. Here is exactly what I did on my ex NHS Windows 10 Pro PC, step by step; I am hoping it might help some readers. | ||
#I downloaded the '''CumulusMXDist3069''' zip from [[Software#Current_Release|the Current Release section]] on the downloads page. | === Download and unzip === | ||
#I downloaded the '''CumulusMXDist3069''' zip from [[Software#Current_Release|the Current Release section]] on the downloads page. N.B. 3069 is no longer latest distribution, but the link will give you latest. | |||
#I unzipped the contents (on my Windows PC) into a partition I use just for software downloads | #I unzipped the contents (on my Windows PC) into a partition I use just for software downloads | ||
#I used a package that verifies the files it copies to duplicate the folder '''CumuluxMX''' onto the drive where I run Cumulus. I then noticed that the package contained some very obsolete copies of some external packages: | #I used a package that verifies the files it copies to duplicate the folder '''CumuluxMX''' onto the drive where I run Cumulus. I then noticed that the package contained some very obsolete copies of some external packages: | ||
#*In "\CumulusMX\interface\lib\jquery" it contained jQuery version 1.9.1, that is 2014 vintage and very obsolete, so I downloaded latest compressed production version from [https://jquery.com/download/ jQuery web site]. I prefixed the version in the MX package with the word OBSOLETE (OBSOLETEjquery-latest.min.js) and renamed the version I had downloaded (jquery-3.4.1.min.js) to the old name in the correct path (on my Windows PC) "\CumulusMX\interface\lib\jquery\jquery-latest.min.js". I later noticed the old jQuery version 1.9.1, that is 2014 vintage and very obsolete was also in "\CumulusMX\webfiles\lib\jquery" so I renamed that with the word obsolete (OBSOLETEjquery-latest.min.js) just to remind me that despite its file name it was not latest. I already have the latest jQuery on my web server, so I did not need to put that new version into this webfiles\lib location, I just noted that this new path meant I ''may'' have to make some change on my web server later. | #*In "\CumulusMX\interface\lib\jquery" it contained jQuery version 1.9.1, that is 2014 vintage and very obsolete, so I downloaded latest compressed production version from [https://jquery.com/download/ jQuery web site]. I prefixed the version in the MX package with the word OBSOLETE (OBSOLETEjquery-latest.min.js) and renamed the version I had downloaded (jquery-3.4.1.min.js) to the old name in the correct path (on my Windows PC) "\CumulusMX\interface\lib\jquery\jquery-latest.min.js". I later noticed the old jQuery version 1.9.1, that is 2014 vintage and very obsolete was also in "\CumulusMX\webfiles\lib\jquery" so I renamed that with the word obsolete (OBSOLETEjquery-latest.min.js) just to remind me that despite its file name it was not latest. I already have the latest jQuery on my web server, so I did not need to put that new version into this webfiles\lib location, I just noted that this new path meant I ''may'' have to make some change on my web server later. | ||
#*Similarly, the MX package contained obsolete vintage version 2.1.4 (2015-03-10) of Highstocks and Highcharts, so I downloaded latest versions from [https://www.highcharts.com/blog/download/ the Highstock link] on this page. I then created a new folder obsolete at "\CumulusMX\interface\lib\highstock\js", moved the folders "modules" and "themes" that were there in my new folder, and the various highstock and highchart files that were there were moved into the obsolete folder. Now I navigated to the code folder within that download, copied the files within it to "\CumulusMX\interface\lib\highstock\js" and then copied the folders "modules" and "themes" from that code download folder into the same location. So now (in March 2020) everything is related to version 8.04 released 10 March 2020. | #*Similarly, the MX package contained obsolete vintage version 2.1.4 (2015-03-10) of Highstocks and Highcharts, so I downloaded latest versions from [https://www.highcharts.com/blog/download/ the Highstock link] on this page. I then created a new folder obsolete at "\CumulusMX\interface\lib\highstock\js", moved the folders "modules" and "themes" that were there in my new folder, and the various highstock and highchart files that were there were moved into the obsolete folder. Now I navigated to the code folder within that download, copied the files within it to "\CumulusMX\interface\lib\highstock\js" and then copied the folders "modules" and "themes" from that code download folder into the same location. So now (in March 2020) everything is related to version 8.04 released 10 March 2020. | ||
=== Copying Cumulus 1 files into MX folder === | |||
#The locale I used for Cumulus 1 is going to be the same I will use for MX (same PC!) so my copying across of my existing files should be fairly easy: | #The locale I used for Cumulus 1 is going to be the same I will use for MX (same PC!) so my copying across of my existing files should be fairly easy: | ||
#*First, I copied my '''\Cumulus\strings.ini''' to '''\CumulusMX\strings.ini'''. This preserves any tailoring I have done of terminology. | #*First, I copied my '''\Cumulus\strings.ini''' to '''\CumulusMX\strings.ini'''. This preserves any tailoring I have done of terminology. | ||
| Line 114: | Line 116: | ||
#* So left to last is the "data" folder: | #* So left to last is the "data" folder: | ||
#** I have copied all files from "\Cumulus\data" to "\CumulusMX\data", and will see what edits I need to make later. Some of my '''.ini''' contain date-time entries like "12/03/2019 14:50:45". | #** I have copied all files from "\Cumulus\data" to "\CumulusMX\data", and will see what edits I need to make later. Some of my '''.ini''' contain date-time entries like "12/03/2019 14:50:45". | ||
=== Almost "Ready to run" === | |||
#** I find after running the CumulusMX engine, that it edits those '''.ini''' files it needs to, and the new versions contain date-time entries in the "2019-03-16T12:45:00" style, but despite what I picked up from reading on the forum, you '''don't''' need to edit these entries in log files like '''month.ini''' as Cumulus MX can read the old ones. | #** I find after running the CumulusMX engine, that it edits those '''.ini''' files it needs to, and the new versions contain date-time entries in the "2019-03-16T12:45:00" style, but despite what I picked up from reading on the forum, you '''don't''' need to edit these entries in log files like '''month.ini''' as Cumulus MX can read the old ones. | ||
# I right clicked on the "CumulusMX.exe" entry in the top level folder and selected '''Send to ... desktop (create shortcut) '''. On the same right click menu I also selected '''Pin to taskbar'''. | # I right clicked on the "CumulusMX.exe" entry in the top level folder and selected '''Send to ... desktop (create shortcut) '''. On the same right click menu I also selected '''Pin to taskbar'''. | ||
# I clicked on one of my new shortcuts. '''Windows Defender''' popped up, so I told it '''allow all''' for Cumulus MX. | # I clicked on one of my new shortcuts. '''Windows Defender''' popped up, so I told it '''allow all''' for Cumulus MX. | ||
# I opened my Internet Security premium package, in the "unrecognised files" section I selected CumulusMX.exe then right clicked and selected '''Change File Rating to Trusted''' and in the "Firewall" section added port '''8998''' as one that was permitted. | # I opened my Internet Security premium package, in the "unrecognised files" section I selected CumulusMX.exe then right clicked and selected '''Change File Rating to Trusted''' and in the "Firewall" section added port '''8998''' as one that was permitted. | ||
# I right clicked on my desktop (you may need to | # I right clicked on my desktop (you may need to right click on the windows symbol at bottom left), selected '''command prompt as administrator''' and typed | ||
netsh http add urlacl url=http://*:8998/ user=\users | netsh http add urlacl url=http://*:8998/ user=\users | ||
to allow all users to bind to port 8998 (i.e. that used for the Cumulus interface). | to allow all users to bind to port 8998 (i.e. that used for the Cumulus interface). | ||
# I viewed my hub (router) to see the IP address allocated to my Cumulus MX computer (192.168.1.64), that told me that I would find the user interface by typing "http://192.168.1.64:8998/" into my browser while the MX engine command window remains open (so MX is actually running), so I typed that and I saw the user interface and navigated around it. | |||
I | |||
When I am happy to stop using MX, I type '''Control + C''' into that MX command window and MX closes. | When I am happy to stop using MX, I type '''Control + C''' into that MX command window and MX closes. | ||
=== Success === | |||
My installation of Cumulus MX has succeeded, and as the experiment did help me find a mistake in one of my Cumulus templates where I had not defined input parameters for "Recent History", it has been useful. I am continuing to use Cumulus 1 for the moment, until I am absolutely sure MX can do everything I want. I believe it will do some tasks better, but there is a lot more to learn about how to use it. | |||
=== Tip ==== | |||
"Water01" supplied the following tip that I followed to give me a fixed address 192.168.1.64:8998 for MX user interface: | |||
Give your Computer a fixed address by finding the network card via Network and Sharing Centre (Control Panel), click on Change Adapter Settings, then Right click on Ethernet or WiFi Adapter, select Properties and in the window that opens right click on Internet Protocol Version 4 (TCP/IP 4), and select properties and on that pop up screen tell the computer to "use the following IP address and fill it out (in your case 192.168.1.64, with a subnet mask of 255.255.255.0 and gateway address of either 192.168.1.1 or 192.168.1.254 depending on the address of your router). | |||
== Editing the User Interface == | == Editing the User Interface == | ||