mirror of https://github.com/winsw/winsw
68 lines
3.0 KiB
Markdown
68 lines
3.0 KiB
Markdown
winsw: Windows service wrapper in less restrictive license
|
|
=========================
|
|
|
|
WinSW is an executable binary, which can be used to wrap and manage a custom process as a Windows service.
|
|
Once you download the installation package, you can rename `winsw.exe` to any name, e.g. `myService.exe`.
|
|
|
|
### Why?
|
|
|
|
See the [project manifest](MANIFEST.md).
|
|
|
|
### Download
|
|
Right now the project uses [Jenkins](https://jenkins.io/index.html) Maven repository as a main storage of release files.
|
|
Binaries are available [here](http://repo.jenkins-ci.org/releases/com/sun/winsw/winsw/).
|
|
|
|
Some releases (e.g. alpha- and beta-versions) can be also downloaded from the project's GitHub page.
|
|
This source of releases is not an **official one**.
|
|
|
|
### Usage
|
|
|
|
WinSW is being managed by configuration files: [Main XML Configuration file](doc/xmlConfigFile.md) and [EXE .config file](TODO).
|
|
|
|
Your renamed `winsw.exe` binary also accepts the following commands:
|
|
|
|
* `install` to install the service to Windows Service Controller.
|
|
This command requires some preliminary steps described in the [Installation Guide](doc/installation.md).
|
|
* `uninstall` to uninstall the service. The opposite operation of above.
|
|
* `start` to start the service. The service must have already been installed.
|
|
* `stop` to stop the service.
|
|
* `restart` to restart the service. If the service is not currently running, this command acts like `start`.
|
|
* `status` to check the current status of the service. This command prints one line to the console. `NonExistent` to indicate the service is not currently installed, `Started` to indicate the service is currently running, and `Stopped` to indicate that the service is installed but not currently running.
|
|
|
|
### Documentation
|
|
|
|
* [Installation Guide](doc/installation.md) - Describes the installation process for different systems and .NET versions
|
|
* [Release notes](CHANGELOG.md)
|
|
* Configuration:
|
|
* [Main XML Configuration file](doc/xmlConfigFile.md)
|
|
* [Configuration File](doc/xmlConfigFile.md)
|
|
* [Logging and Error Reporting](doc/loggingAndErrorReporting.md)
|
|
* Use-cases:
|
|
* [Self-restarting services](doc/selfRestartingService.md)
|
|
* [Deferred File Operations](doc/deferredFileOperations.md)
|
|
|
|
### Release lines
|
|
|
|
#### WinSW 2.x
|
|
|
|
This is a new release line under active development.
|
|
API stability is not guaranteed till the first release, the project structure is in flux.
|
|
|
|
Major changes since 1.x:
|
|
* Rework of the project structure
|
|
* Better logging
|
|
* Internal plugin engine, which allows extending the WinSW behavior
|
|
|
|
#### WinSW 1.x
|
|
|
|
This is an old baseline of WinSW.
|
|
Currently it is in the maintenance-only state.
|
|
New versions with fixes may be released on-demand.
|
|
|
|
### Build Environment
|
|
|
|
* IDE: [Visual Studio Community 2013](http://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx) (free for open-source projects)
|
|
* winsw_cert.pfx should be available in the project's root
|
|
* You can generate the certificate in "Project Settings/Signing"
|
|
* The certificate is in <code>.gitignore</code> list. Please do not add it to the repository
|