MX on Windows OS: Difference between revisions

m
#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 <ttcode>C:\Users\...\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\Run_CumulusMX</ttcode>. 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.
 
 
#Create a shortcut on your desktop (and/or the taskbar) for the '''CumulusMX.exe''' executable <ttcode>cmd.exe /C start CumulusMX C:\CumulusMX\CumulusMX.exe -debug</ttcode>, 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.
#* '''Remember, if you have not done the <ttcode>''netsh http add urlacl url=http://*:8998/ user=\users''</ttcode> 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.
#*Choose whether to start as minimised or as a command window
#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):
#**'''Action''' <ttcode>Start a program</ttcode> from drop-down
#**'''Program/script''' <ttcode>cmd.exe</ttcode> (this is standard Windows environment to run something)
#**'''Add arguments''' <ttcode>/C start Start_MX \CumulusMX\CumulusMX.exe -debug -port=nnnn</ttcode> (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),
#** all optional parameters are listed later
#**'''Start in''' <ttcode>\CumulusMX</ttcode> (include a drive specifier if necessary)
 
=== Each time you want to run Cumulus MX on Windows: ===
 
''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 =
5,838

edits