注册jar包为windows服务

说明:

  • 推荐使用winsw
  • 可以将Windows上的任何一个程序注册为服务的工具,只介绍jar包部署方式

1.下载

https://github.com/kohsuke/winsw/releases

下载完之后最好把文件改成一个比较短小的名字,例如:WinSW.exe 方便后面输入命令时使用。 

同时配置文件的名字跟exe名字保持一直,我习惯将jar包和它们放一起,如图

注册jar包为windows服务

2.修改配置文件

(1)id

指定在Windows系统内部使用的识别服务的ID。在系统中安装的所有服务中,这必须是唯一的,它应该完全由字母数字字符组成。

(2)name

服务的简短名称,它可以包含空格和其他字符。尽量简短,就像“id”一样,在系统的所有服务名称中,也要保持唯一。

(3)description

该服务可读描述。当选中该服务时,它将显示在Windows服务管理器中。

(4)executable

该元素指定要启动的可执行文件。它可以是绝对路径,也可以指定可执行文件的名称,然后从环境变量“PATH”中搜索(需要注意的是,服务经常在不同的用户账户中运行,因此它可能需要有不同于你设置在环境变量Path中的路径)。

(5)startmode

该元素指定Windows服务的启动模式。它可以是下列值之一:开机、系统、自动或手动。有关详细信息,请参阅MSDN【https://msdn.microsoft.com/en-us/library/aa384896%28v=vs.85%29.aspx】。默认值是“Automatic”。

(6)delayedAutoStart

这个布尔选项允许在定义“自动”启动模式时延时启动。关于延时启动模式,可参阅【https://blogs.technet.microsoft.com/askperf/2008/02/02/ws2008-startup-processes-and-delayed-automatic-start】。

请注意,延时启动模式在早于Windows 7和Windows Server 2008的操作系统中可能失效。在这种情况下,Windows服务安装可能会失败。

(7)depend

指定该服务所依赖的其他服务的id。当服务“X”依赖于服务“Y”时,“X”只能在“Y”运行后运行。可以使用多个元素来指定多个依赖项。

(8)logging

关于服务进程的日志以及错误信息,有单独的一个配置说明文档【WinSW Logging and Error Reporting】,咱们下次再详细说。

(9)argument

该元素指定要传递给可执行文件的参数。

如果有必要,Winsw会给每一个参数外加引号(“”),所以为了避免双重引号,尽量不要在参数中使用引号。

为了向后兼容,可以使用“arguments”来指定单个元素中的整个命令行。

(10)stopargument/stopexecutable

请求停止服务时,winsw通过调用终止进程的API函数来立即终结服务。然而,如果存在“stopargument”元素,winsw将通过使用”stopargument“作为参数,来启动“executable“元素(或者是”stopexecutable“元素)中配置的进程,来代替调用终止进程的API函数。期望通过这种方式来优雅的关闭服务进程。

然后,Winsw将等待两个进程自行退出,然后向Windows报告该服务已经终止。

当你使用“stopargument”元素时,你必须使用“startargument”元素代替“argument”元素。参见下面的完整示例:

catalina.sh

jpda

run

catalina.sh

stop

注意,元素的名称是“startargument”,而不是“startarguments”。因此,要指定多个参数,你必须指定多个元素。

(11)stoptimeout

当服务被要求停止时,winsw首先尝试调用GenerateConsoleCtrlEvent 方法(类似于Ctrl+C),然后等待长达15秒的时间,让进程自行退出。

如果这样做了,进程关闭还是失败了(或者如果进程没有控制台),

然后winsw会调用终止进程的API函数来立即终止服务。

这个可选元素允许您改变这个“15秒”的值,这样您就可以控制winsw等待服务进程自行关闭的时间。

如何指定时间期限,可参考下面的“onfailure”元素的设置:

10sec

(12)env

如果有必要,可以使用这个可多次指定的可选元素,为子进程设置环境变量。其语法是:

(13)interactive

如果指定了这个可选的元素,那么该服务将被允许与桌面交互,比如显示一个新的窗口和对话框。

如果你的程序需要GUI,那么设置如下:

请注意,自从引入UAC(Windows Vista及之后的版本)以来,服务不再被允许与桌面交互。

在这些操作系统中,所有这一切都是为了允许用户切换到一个单独的窗口来与服务交互。

(14)beeponshutdown

这个可选元素是为了在服务关闭时发出简单的音调。

这个特性应该只用于调试,因为一些操作系统和硬件不支持这种功能。

(15)download

这个可选元素可以多次指定,让服务包装器从URL检索资源,并将其作为文件放置在本地。这个操作是在服务启动时运行的,在“executable”指定的应用程序启动之前。

对于需要身份验证的服务器,必须根据认证的类型指定一些参数。只有基本身份验证需要额外的子参数。支持的身份验证类型是:

none:默认类型,不能指定

sspi:微软认证,包括Kerberos、NTLM等。

basic:基本身份认证,子参数包括:

1)user=“UserName”

2)password=“Password”

3)unsecureAuth=“true”:default=“false”

当传输协议是未加密的HTTP数据传输时,参数“unsecureAuth”才生效。这是一个安全漏洞,因为凭证是用明文发送的!对于SSPI认证,这是不相关的,因为身份验证令牌是加密的。

对于使用HTTPS传输协议的目标服务器这是必须的,因为服务器发出的CA证书是客户端信任的。这通常是服务器在Internet上的情况。当一个组织在内网中使用自发布的CA时,情况可能不是这样。在这种情况下,有必要将CA导入到Windows客户端的证书MMC。可以看一下微软的说明(https://technet.microsoft.com/en-us/librar/cc754841.aspx)。自发布CA必须被导入到计算机的受信任的根证书颁发机构。

默认情况下,如果操作失败(例如,无效的下载地址),“download”命令也不会在服务启动时失败。为了在这种情况下强制下载失败,可以指定“failOnError”布尔属性。示例如下:

这是开发自动更新服务的另一个有用的构建块。

(16)onfailure

这个可选的可重复元素控制了winsw启动的进程失败后的行为(例如,执行带有非零退出码的退出操作)。

例如,上面的配置使服务在第一次故障后10秒内重新启动,在第二次失败后20秒重新启动,如果服务再次失败,Windows将重新启动。

每个元素都包含一个强制的“action”属性,它控制着Windows SCM将要做什么,以及可选的“延迟”属性,它控制着延迟,直到采取行动为止。“action”属性的值包含以下几种:

restart:重启服务

reboot:重启系统

none:什么也不做,就让服务那么停着

延迟属性的可能后缀是sec/secs/min/mins/hours/day/days。如果未设置,延迟属性默认为0。

如果服务持续失败的次数超出了配置的“onfailure”的数量,那么最后的操作将会被重复。因此,如果只是想要自动重启服务,只需指定一个“onfailure”元素即可:

(17)resetfailure

这个可选元素控制了Windows SCM重新设置故障计数的时间。

例如,如果指定``,并且您的服务持续运行超过一个小时,那么故障计数将重置为零。

这会影响故障操作的行为(见上面的“onfailure”)。

换句话说,这是你认为服务已经成功运行的持续时间。

默认值为1天。

(18)Service account

有可能需要指定服务运行所需要的的useraccount(和密码)。要做到这一点,可以按照下面的方法指定一个“serviceaccount”元素:

YOURDOMAIN

useraccount

Pa55w0rd

true

“”是可选的。如果设置为“true”,则会自动给上面列出的用户设置“Allow Log On As A Service”的权限。

可以使用(组)管理服务帐户 附加'$'到帐户名称,并删除'password'元素:

YOURDOMAIN

gmsa_account$

true

(19)Working directory

有些服务需要使用指定的工作目录运行。

要做到这一点,要指定一个像这样的“workingdirectory”元素:

C:\application

(20)priority

可选地指定服务流程的调度优先级(类似于Unix)。可能的值有“idle”、“belownormal”、“normal”、“abovenormal”、“high”、“realtime”(大小写不敏感)。

idle

指定高于正常值的优先级会产生意想不到的后果。请参阅MSDN文章ProcessPriorityClass Enumeration来了解详细信息。

这个特性主要是为了在较低的优先级上启动一个进程,以避免干扰计算机的交互使用。

(21)stopparentprocessfirst

可选地指定服务关闭的顺序。

如果“true”,父进程首先关闭。

当主进程是一个控制台时,这是很有用的,它可以响应Ctrl+C命令,并优雅地关闭子进程。

true

  (22) log/logpath日志的路径

我只使用了简单的几个,如图

注册jar包为windows服务

 3.命令说明:

winsw install 安装服务

winsw uninstall 卸载服务

winsw start 开启服务

winsw stop 停止服务

winsw restart 重新启动服务

winsw status 检查服务的当前状态
 

4.部署服务

将配置文件与WinSW.exe放在同一目录中。注意对应WinSW.exe的配置文件名称应该是WinSW.xml,

打开cmd,cd进入到应用程序所在目录

如果报以下错,说明是非管理员启动,

注册jar包为windows服务

 选择管理员启动即可,成功如下

注册jar包为windows服务

注册jar包为windows服务

 启动服务后会有日志生成

注册jar包为windows服务

5.卸载服务

同理cd 到该目录 ,执行winsw uninstall命令即可

注册jar包为windows服务

 

资料:https://cloud.tencent.com/developer/news/246538