mirror of https://github.com/winsw/winsw
307 lines
8.9 KiB
XML
307 lines
8.9 KiB
XML
<!--
|
|
MIT License
|
|
|
|
Copyright (c) 2008-2020 Kohsuke Kawaguchi, Sun Microsystems, Inc., CloudBees,
|
|
Inc., Oleg Nenashev and other contributors
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
-->
|
|
|
|
<!--
|
|
This is a sample configuration of the Windows Service Wrapper.
|
|
This configuration file should be placed near the WinSW executable, the name should be the same.
|
|
E.g. for myapp.exe the configuration file name should be myapp.xml
|
|
|
|
You can find more information about configuration options here: https://github.com/winsw/winsw/blob/master/docs/xml-config-file.md
|
|
-->
|
|
<service>
|
|
|
|
<!--
|
|
SECTION: Mandatory options
|
|
All options in other sections are optional
|
|
-->
|
|
|
|
<!-- ID of the service. It should be unique accross the Windows system. -->
|
|
<id>myapp</id>
|
|
|
|
<!-- Path to the executable, which should be started. -->
|
|
<executable>%BASE%\myExecutable.exe</executable>
|
|
|
|
<!-- Display name of the service. -->
|
|
<!--
|
|
<name>MyApp Service (powered by WinSW)</name>
|
|
-->
|
|
|
|
<!-- Service description. -->
|
|
<!--
|
|
<description>This service is a service created from a sample configuration</description>
|
|
-->
|
|
|
|
<!--
|
|
SECTION: Installation
|
|
These options are being used during the installation only.
|
|
Their modification will not take affect without the service re-installation.
|
|
-->
|
|
|
|
<!--
|
|
OPTION: serviceaccount
|
|
Defines account, under which the service should run.
|
|
-->
|
|
<!--
|
|
<serviceaccount>
|
|
<domain>YOURDOMAIN</domain>
|
|
<user>useraccount</user>
|
|
<password>Pa55w0rd</password>
|
|
<allowservicelogon>true</allowservicelogon>
|
|
</serviceaccount>
|
|
-->
|
|
|
|
<!--
|
|
OPTION: onfailure
|
|
Defines a sequence of actions, which should be performed if the managed executable fails.
|
|
Supported actions: restart, reboot, none
|
|
-->
|
|
<!--
|
|
<onfailure action="restart" delay="10 sec"/>
|
|
<onfailure action="restart" delay="20 sec"/>
|
|
<onfailure action="reboot" />
|
|
-->
|
|
|
|
<!--
|
|
OPTION: resetfailure
|
|
Time, after which the Windows service resets the failure status.
|
|
Default value: 1 day
|
|
-->
|
|
<!--
|
|
<resetfailure>1 hour</resetfailure>
|
|
-->
|
|
|
|
<!--
|
|
OPTION: securityDescriptor
|
|
The security descriptor string for the service in SDDL form.
|
|
For more information, see https://docs.microsoft.com/windows/win32/secauthz/security-descriptor-definition-language.
|
|
-->
|
|
|
|
<!--<securityDescriptor></securityDescriptor>-->
|
|
|
|
<!--
|
|
SECTION: Executable management
|
|
-->
|
|
|
|
<!--
|
|
OPTION: arguments
|
|
Arguments, which should be passed to the executable.
|
|
-->
|
|
<!--
|
|
<arguments>-classpath c:\cygwin\home\kohsuke\ws\hello-world\out\production\hello-world test.Main</arguments>
|
|
-->
|
|
|
|
<!--
|
|
OPTION: startarguments
|
|
Arguments, which should be passed to the executable when it starts.
|
|
If specified, overrides 'arguments'.
|
|
-->
|
|
<!--
|
|
<startarguments></startarguments>
|
|
-->
|
|
|
|
<!--
|
|
OPTION: workingdirectory
|
|
If specified, sets the default working directory of the executable.
|
|
Default value: Directory of the service wrapper executable.
|
|
-->
|
|
<!--
|
|
<workingdirectory>C:\myApp\work</workingdirectory>
|
|
-->
|
|
|
|
<!--
|
|
OPTION: priority
|
|
Desired process priority.
|
|
Possible values: Normal, Idle, High, RealTime, BelowNormal, AboveNormal
|
|
Default value: Normal
|
|
-->
|
|
<priority>Normal</priority>
|
|
|
|
<!--
|
|
OPTION: stoptimeout
|
|
Time to wait for the service to gracefully shutdown the executable before we forcibly kill it.
|
|
Default value: 15 seconds
|
|
-->
|
|
<stoptimeout>15 sec</stoptimeout>
|
|
|
|
|
|
<!--
|
|
OPTION: stopexecutable
|
|
Path to an optional executable, which performs shutdown of the service.
|
|
This executable will be used if and only if 'stoparguments' are specified.
|
|
If 'stoparguments' are defined without this option, 'executable' will be used as a stop executable.
|
|
-->
|
|
<!--
|
|
<stopexecutable>%BASE%\stop.exe</stopexecutable>
|
|
-->
|
|
|
|
<!--
|
|
OPTION: stoparguments
|
|
Additional arguments, which should be passed to the stop executable during termination.
|
|
This OPTION also enables termination of the executable via stop executable.
|
|
-->
|
|
<!--
|
|
<stoparguments>-stop true</stoparguments>
|
|
-->
|
|
<!--
|
|
SECTION: Service management
|
|
-->
|
|
<!--
|
|
OPTION: startmode
|
|
Defines start mode of the service.
|
|
Supported modes: Automatic, Manual, Boot, System (latter ones are supported for driver services only)
|
|
Default mode: Automatic
|
|
-->
|
|
<startmode>Automatic</startmode>
|
|
|
|
<!--
|
|
OPTION: delayedAutoStart
|
|
Enables the Delayed Automatic Start if 'Automatic' is specified in the 'startmode' field.
|
|
See the WinSW documentation to get info about supported platform versions and limitations.
|
|
-->
|
|
<!--<delayedAutoStart>true</delayedAutoStart>-->
|
|
|
|
<!--
|
|
OPTION: depend
|
|
Optionally specifies services that must start before this service starts.
|
|
-->
|
|
<!--
|
|
<depend>Eventlog</depend>
|
|
<depend>W32Time</depend>
|
|
-->
|
|
|
|
<!--
|
|
OPTION: interactive
|
|
Indicates the service can interact with the desktop.
|
|
-->
|
|
<!--
|
|
<interactive>true</interactive>
|
|
-->
|
|
|
|
<!--
|
|
SECTION:Logging
|
|
-->
|
|
|
|
<!--
|
|
OPTION: logpath
|
|
Sets a custom logging directory for all logs being produced by the service wrapper.
|
|
Default value: Directory, which contains the executor.
|
|
-->
|
|
<!--
|
|
<logpath>%BASE%\logs</logpath>
|
|
-->
|
|
|
|
<!--
|
|
OPTION: log
|
|
Defines logging mode for logs produced by the executable.
|
|
Supported modes:
|
|
* append - Rust update the existing log
|
|
* none - Do not save executable logs to the disk
|
|
* reset - Wipe the log files on startup
|
|
* roll - Roll logs based on size
|
|
* roll-by-time - Roll logs based on time
|
|
* rotate - Rotate logs based on size, (8 logs, 10MB each). This mode is deprecated, use "roll"
|
|
Default mode: append
|
|
|
|
Each mode has different settings.
|
|
See https://github.com/winsw/winsw/blob/master/docs/logging-and-error-reporting.md for more details
|
|
-->
|
|
<log mode="append">
|
|
<!--
|
|
<setting1/>
|
|
<setting2/>
|
|
-->
|
|
</log>
|
|
|
|
<!--
|
|
SECTION: Environment setup
|
|
-->
|
|
<!--
|
|
OPTION: env
|
|
Sets or overrides environment variables.
|
|
There may be multiple entries configured on the top level.
|
|
-->
|
|
<!--
|
|
<env name="MY_TOOL_HOME" value="C:\etc\tools\myTool" />
|
|
<env name="LM_LICENSE_FILE" value="host1;host2" />
|
|
-->
|
|
|
|
|
|
<!--
|
|
OPTION: download
|
|
List of downloads to be performed by the wrapper before starting.
|
|
-->
|
|
<!--
|
|
<download from="http://www.google.com/" to="%BASE%\index.html" />
|
|
|
|
Download and fail the service startup on Error:
|
|
<download from="http://www.nosuchhostexists.com/" to="%BASE%\dummy.html" failOnError="true"/>
|
|
|
|
An example for unsecure Basic authentication because the connection is not encrypted:
|
|
<download from="http://example.com/some.dat" to="%BASE%\some.dat"
|
|
auth="basic" unsecureAuth=“true”
|
|
username="aUser" password=“aPassw0rd" />
|
|
|
|
Secure Basic authentication via HTTPS:
|
|
<download from="https://example.com/some.dat" to="%BASE%\some.dat"
|
|
auth="basic" username="aUser" password="aPassw0rd" />
|
|
|
|
Secure authentication when the target server and the client are members of the same domain or
|
|
the server domain and the client domain belong to the same forest with a trust:
|
|
<download from="https://example.com/some.dat" to="%BASE%\some.dat" auth="sspi" />
|
|
-->
|
|
|
|
<!--
|
|
SECTION: Other options
|
|
-->
|
|
|
|
<!--
|
|
OPTION: beeponshutdown
|
|
Indicates the service should beep when finished on shutdown (if it's supported by OS).
|
|
-->
|
|
<!--
|
|
<beeponshutdown>true</beeponshutdown>
|
|
-->
|
|
|
|
<!--
|
|
SECTION: Extensions
|
|
This configuration section allows specifying custom extensions.
|
|
More info is available here: https://github.com/winsw/winsw/blob/master/docs/extensions/extensions.md
|
|
-->
|
|
|
|
<!--
|
|
<extensions>
|
|
Extension 1: id values must be unique
|
|
<extension enabled="true" id="extension1" className="winsw.Plugins.SharedDirectoryMapper.SharedDirectoryMapper">
|
|
<mapping>
|
|
<map enabled="false" label="N:" uncpath="\\UNC"/>
|
|
<map enabled="false" label="M:" uncpath="\\UNC2"/>
|
|
</mapping>
|
|
</extension>
|
|
...
|
|
</extensions>
|
|
-->
|
|
|
|
</service>
|