This is an automated email from the ASF dual-hosted git repository. martinzink pushed a commit to branch main in repository https://gitbox.apache.org/repos/asf/nifi-minifi-cpp.git
commit dd8e54e517e52ff05142c34490d159dbb2f8cb72 Author: Gabor Gyimesi <gamezb...@gmail.com> AuthorDate: Tue Mar 12 13:52:59 2024 +0100 MINIFICPP-2192 Document user requirements for Windows service installation Closes #1737 Signed-off-by: Martin Zink <martinz...@apache.org> --- Windows.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/Windows.md b/Windows.md index 82fb21a8d..c1f7ca7ee 100644 --- a/Windows.md +++ b/Windows.md @@ -126,3 +126,18 @@ copy minifi_main\Release\minifi.exe minifi_main\ cpack ctest -C Release ``` + +## Using MiNiFi C++ as a Windows service + +Building and packaging MiNiFi C++ results in an MSI installer. This installer can be used to install MiNiFi C++ as a Windows service. Depending on the build options, specific extensions can be selected for installation. + +The installer also provides an option to specify a service account to be used for the Windows service. By default, the `LocalSystem` account is used. If you want to specify a different account, make sure to provide the account name in the `DOMAIN\username` format. + +**NOTE:** To start the Windows service using the specified account, the account must have the `Log on as a service` right. If this right is missing, the following error event will appear in the system logs: + +``` +The Apache NiFi MiNiFi service was unable to log on as .\username with the currently configured password due to the following error: +Logon failure: the user has not been granted the requested logon type at this computer. +``` + +This right can be granted using the Local Security Policy tool (`secpol.msc`). Navigate to `Local Policies` -> `User Rights Assignment` -> `Log on as a service` and add the account.