Skip to content

[RUN-3585] add alternative mode to start runner as service#1815

Merged
fdevans merged 5 commits into
4.0.xfrom
RUN-3585
Jun 4, 2026
Merged

[RUN-3585] add alternative mode to start runner as service#1815
fdevans merged 5 commits into
4.0.xfrom
RUN-3585

Conversation

@ronaveva
Copy link
Copy Markdown
Contributor

@ronaveva ronaveva commented Jun 4, 2026

This pull request updates the Windows service installation documentation for the Runner, making it clearer and more comprehensive by introducing tabbed instructions for different installation modes. The most important changes are:

Documentation improvements for Windows service installation:

  • Added tabbed sections to the runner-service-windows.md guide, allowing users to choose between standard (java mode) and alternative (jvm mode) installation instructions for runner.exe.
  • Introduced a detailed example for installing the Runner in jvm mode, which provides more robust logging by capturing System.out/System.err directly into the log file.
  • Added a warning explaining the importance of setting the --Jvm parameter to the correct jvm.dll path in jvm mode, and clarified differences between java and jvm modes, including architecture compatibility requirements.

@ronaveva ronaveva added this to the 5.20.1 milestone Jun 4, 2026
@ronaveva ronaveva requested review from a team, Copilot and fdevans June 4, 2026 16:26
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Windows Runner service installation guide to present two alternative Apache Commons Daemon (procrun) installation modes via tabs, including an enhanced-logging jvm mode example and additional guidance around jvm.dll selection/architecture.

Changes:

  • Added tabbed instructions separating “Standard (java mode)” and an “Alternative (jvm mode)” installation approach.
  • Documented why jvm mode captures System.out/System.err into --StdOutput/--StdError for more reliable logging.
  • Added a warning about setting --Jvm to an explicit jvm.dll path and noted architecture compatibility requirements.

Comment thread docs/learning/howto/runner-service-windows.md
Comment thread docs/learning/howto/runner-service-windows.md Outdated
Comment thread docs/learning/howto/runner-service-windows.md
Comment thread docs/learning/howto/runner-service-windows.md Outdated
Comment thread docs/learning/howto/runner-service-windows.md
fdevans and others added 4 commits June 4, 2026 09:30
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@fdevans fdevans merged commit 05424f0 into 4.0.x Jun 4, 2026
3 checks passed
@fdevans fdevans deleted the RUN-3585 branch June 4, 2026 16:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants