5,838
edits
MX on Windows OS: Difference between revisions
m
→Setting up for either manual or automatic running (without service)
| Line 155: | Line 155: | ||
#the path where all the required '''.dll''' files are located | #the path where all the required '''.dll''' files are located | ||
Therefore it is best to always start MX using what Windows calls a '''shortcut''', because when creating the shortcut you can enter all the required information into the properties. If you want MX to automatically start whenever you log into your PC, then the place to store your shortcut is < | Therefore it is best to always start MX using what Windows calls a '''shortcut''', because when creating the shortcut you can enter all the required information into the properties. If you want MX to automatically start whenever you log into your PC, then the place to store your shortcut is <code>C:\Users\...\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\Run_CumulusMX</code>. Don't forget to put your Microsoft username where I have put ... | ||
With this you might want to right click on that shortcut, select properties, then you can set the starting position for the command window, the colours and font it will use, and even choose to start minimised, amongst many other selections. | With this you might want to right click on that shortcut, select properties, then you can set the starting position for the command window, the colours and font it will use, and even choose to start minimised, amongst many other selections. | ||
| Line 162: | Line 162: | ||
#Create a shortcut on your desktop (and/or the taskbar) for the '''CumulusMX.exe''' executable < | #Create a shortcut on your desktop (and/or the taskbar) for the '''CumulusMX.exe''' executable <code>cmd.exe /C start CumulusMX C:\CumulusMX\CumulusMX.exe -debug</code>, the "-debug" is ''optional'', it starts the logging in debugging mode so the log created in MXDiags folder has more information. There are other optional parameters all listed later. | ||
#*In that shortcut define the path where the executable is located as the path to start in. | #*In that shortcut define the path where the executable is located as the path to start in. | ||
#* '''Remember, if you have not done the < | #* '''Remember, if you have not done the <code>''netsh http add urlacl url=http://*:8998/ user=\users''</code> command mentioned above, you must run as administrator.''' | ||
#* Add any of the parameters that can be used with the executable, as listed later, such as specifying a different port for the admin interface , or starting with debugging. | #* Add any of the parameters that can be used with the executable, as listed later, such as specifying a different port for the admin interface , or starting with debugging. | ||
#*Choose whether to start as minimised or as a command window | #*Choose whether to start as minimised or as a command window | ||
| Line 171: | Line 171: | ||
#OR place the shortcut as defined above in the start up folder for the user account so MX automatically starts when you connect/log in (see a later section for how to find that start up folder). | #OR place the shortcut as defined above in the start up folder for the user account so MX automatically starts when you connect/log in (see a later section for how to find that start up folder). | ||
# OR declare a task in the scheduler to start MX; in the '''Actions''' tab fill in fields as follows (the other tabs should be obvious): | # OR declare a task in the scheduler to start MX; in the '''Actions''' tab fill in fields as follows (the other tabs should be obvious): | ||
#**'''Action''' < | #**'''Action''' <code>Start a program</code> from drop-down | ||
#**'''Program/script''' < | #**'''Program/script''' <code>cmd.exe</code> (this is standard Windows environment to run something) | ||
#**'''Add arguments''' < | #**'''Add arguments''' <code>/C start Start_MX \CumulusMX\CumulusMX.exe -debug -port=nnnn</code> (the "/C" means this task will close once it has started the task, the "Start_MX" is how the task will be labelled as it is running, the next argument "\CumulusMX\CumulusMX.exe" actually starts the executable and it does not need a drive prefix as that is in next box. | ||
#**Note in this example I have included next two optional parameters that can be used after the .exe call in that same box, here '''-debug''' (only include if you want full debugging logging) and '''-port=nnnn''' where nnnn is the port to be used for admin interface (only include if want to change from default 8998), | #**Note in this example I have included next two optional parameters that can be used after the .exe call in that same box, here '''-debug''' (only include if you want full debugging logging) and '''-port=nnnn''' where nnnn is the port to be used for admin interface (only include if want to change from default 8998), | ||
#** all optional parameters are listed later | #** all optional parameters are listed later | ||
#**'''Start in''' < | #**'''Start in''' <code>\CumulusMX</code> (include a drive specifier if necessary) | ||
=== Each time you want to run Cumulus MX on Windows: === | === Each time you want to run Cumulus MX on Windows: === | ||
| Line 194: | Line 194: | ||
''You should not'' issue a '''TASKKILL''' instruction, as that will prevent MX correctly writing out to all the files it should update on exit. Consequently, it will not restart correctly and may actually lose settings and data. | ''You should not'' issue a '''TASKKILL''' instruction, as that will prevent MX correctly writing out to all the files it should update on exit. Consequently, it will not restart correctly and may actually lose settings and data. | ||
= Executables = | = Executables = | ||