Differences

This shows you the differences between two versions of the page.

--- startwindowsmixasservice [2022/03/24 16:45]
wikiadmin [Install the Service]
+++ startwindowsmixasservice [2025/03/24 11:05] (current)
amyw [Setting up MIX as a Service on Windows]
@@ Line 1: / Line 1: @@
 =====Setting up MIX as a Service on Windows=====
-This article provides instructions on how to set up MIX as a service on Windows. As a service you can use the Windows Service manager panel to stop and start MIX, and to set it to run automatically when Windows starts. It is distributed with a permissive MIT license.
+This article provides instructions on how to set up MIX as a service on Windows. As a service you can use the Windows Service manager panel to stop and start MIX, and to set it to run automatically when Windows starts. The wrapper software is distributed with a permissive MIT license.
 These instructions use the service wrapper (WinSW) from https://github.com/winsw. This is an active open-source project and is very easy to set up and use. There are more features available for this wrapper than the basic setup described in this article, but the basic setup should be useful for most MIX installations.
@@ Line 13: / Line 13: @@
 ====Get the Service Wrapper Files====
-The first step to setting up the wrapper for MIX is to download the main executable and a configuration from https://github.com/winsw/winsw/releases.
+The first step to setting up the wrapper for MIX is to download the main executable and a configuration from https://github.com/winsw/winsw/releases .
 WinSW can be set up on x86 (32-bit) or x64 (64-bit) and the executable you select to download will depend on the MIX deployment Windows version and architecture. The most straightforward setup is for Windows 10+ which has .net 4.61+ installed (it will be by default on Windows 10+ systems). Download the current release (not the beta release). As of the date of this article the current release is 2.11, and version 3 is in alpha phase and probably should not be used except for experimentation. The links below are for version 2.11 and you should check if there is a later version.
-The executable to download for Windows 10 (and systems using .net 4.61 or newer) is https://github.com/winsw/winsw/releases/download/v2.11.0/WinSW.NET461.exe. If you are running an X86 version of Windows or an older version, please read the documentation page (link in the first section above) to understand which exe you will need.
+The executable to download for Windows 10 (and systems using .net 4.61 or newer) is https://github.com/winsw/winsw/releases/download/v2.11.0/WinSW.NET461.exe . If you are running an X86 version of Windows or an older version, please read the documentation page (link in the first section above) to understand which exe you will need.
-Also download the simple configuration example (sample-minimal.xml) from https://github.com/winsw/winsw/releases/download/v2.11.0/sample-minimal.xml. You can also download the more extensive (examples of every configurable property) configuration (sample-allOptions.xml) from https://github.com/winsw/winsw/releases/download/v2.11.0/sample-allOptions.xml.
+Also download the simple configuration example (sample-minimal.xml) from https://github.com/winsw/winsw/releases/download/v2.11.0/sample-minimal.xml . You can also download the more extensive (examples of every configurable property) configuration (sample-allOptions.xml) from https://github.com/winsw/winsw/releases/download/v2.11.0/sample-allOptions.xml .
 ==== Copy the Wrapper for MIX====
@@ Line 177: / Line 177: @@
 C:\Users\Public\mixruntime>mixruntime install
--03-24 15:44:21,848 INFO  - Installing service 'MIX Runtime (powered by WinSW) (MIXRuntime)'...
+-03-24 15:44:21,848 INFO  - Installing service 'MIX Runtime Service (powered by WinSW) (MIXRuntime)'...
--03-24 15:44:21,864 INFO  - Service 'MIX Runtime (powered by WinSW) (MIXRuntime)' was installed successfully.
+-03-24 15:44:21,864 INFO  - Service 'MIX Runtime Service (powered by WinSW) (MIXRuntime)' was installed successfully.
+====Monitoring the Service====
+To see what you have accomplished, run the Windows Service panel. You can find this in the Windows start menu under Windows Administrative Tools, then scroll down to Services (it is actually running this: C:\WINDOWS\system32\services.msc).
+When you run the Services panel you can find the "MIXRuntime" service that you just installed:
+{{:pasted:20220324-165530.png}}
+You can see that the service is set up to run automatically when Windows starts (more precisely, when the LocalSystem account starts).
+if you ever need to uninstall the service, use mixruntime uninstall.
+====Starting the Service====
+You can start MIX by right clicking in the Status column of the Services panel for the MIXRuntime service and selecting Start. After you do this you will see that the service is running, so MIX is running.
+{{:pasted:20220324-165849.png}}
+You can also start the service in the command shell (or write a batch file to do this) by typing "mixruntime start".
+====Stopping the Service====
+The service can be stopped by right clicking on the "Running" status in the Service console and selecting "Stop". Alternatively you can stop the service on the command line using "mixruntime stop".