链接

用户手册

参考

Apache Tomcat 开发

Apache Tomcat 5.5 Servlet/JSP 容器

如何把Tomcat注册为视窗的服务

Printer Friendly Version
print-friendly
version
NOTICE

本说明适用于procrun 1.0,现已淘汰。

Tomcat5应用程序

Tomcat5 是一个可以在视窗NT下注册为服务的程序。

Tomcat5w监视程序

Tomcat5w 是一个可用来监视和修改 Tomcat 设置的程序,它有方便使用的界面。

指令选项:

//ES// 修改设置 这是却省是的选项。 运行命令的名称将以servicenameW.exe出现
//MS// 监视程序运行状况 代表程序运行的小图标会出现在视窗有下角

指令行选项

指令行选项的格式为: //XX//ServiceName

现有指令行的选项:

//TS// 把服务按控制台模式运行 不过没有提供其他选项,这是缺省运行模式。其中ServiceName时是可运行文件的名字去 掉exe后缀,这里是Tomcat5
//RS// 运行为系统的服务 由系统ServiceManager来执行
//SS// 停止服务
//US// 更新属性
//IS// 把Tomcat安装为系统的服务
//DS// 删除Tomcat服务 如果Tomcat服务正在运行,这个指令首先终止Tomcat

指令行允许的属性

每个属性都以--开始。以++的属性会给附加在已有的属性里。 如果有系统环境变量的名称与指令的属性相同,有PR_前缀的优先。 例如:

set PR_CLASSPATH=xx.jar

与下面的指令项属性效果一样:

--Classpath=xx.jar

属性名称 默认值 描述
--Description 描述Tomcat服务,最多1024个字符
--DisplayName 名称 服务显示的名称
--Install procrun.exe //RS//ServiceName 安装服务
--Startup manual 启动服务的状态,可以是 automanual
--DependsOn 罗列Tomcat服务必须依赖的其他系统服务。如果有多个服务,用#;符号来分开
--Environment 罗列需要提供给该服务的环境变量。格式为: key=value. 用 #; 符号来区分
--User 用来运行该指令的用户名。只是用在 StartMode 下的 javaexe,这样可以使Tomcat服务以没有 LogonAsService 特权的用户的名义来运行。
--Password --User 所列用户的密码
JAVA_HOME JAVA_HOME 可以定义一个不同于系统的JAVA_HOME环境变量,指定使用不同的Java
--Jvm auto 允许的值为autojvm.dll的完整路径。 路径中可以有环境变量出现。
--JvmOptions -Xrs Java虚拟机器的选项。都用-D or -X开始, 将会被传递给JVM。 选项间用 # or ;字符隔开。
--Classpath 设置Java的classpath环境变量
--JvmMs 指定开始时所用的内存,单位是MB
--JvmMx 最大内存,单位用MB
--JvmSs Thread stack size in KB
--StartImage 可运行文件
--StartPath 程序运行时的工作目录
--StartClass 程序开始时执行的类
--StartParams 需要传递个程序的变量数值,变量用#;字符分隔
--StartMethod main 如果开始执行类中的方法名称,可以不是 main()
--StartMode 可运行文件 exe 可以是jvm javaexe
--StopImage 收到终止信号后运行的文件名
--StopPath 收到终止信号后运行文件的工作目录
--StopClass 收到终止信号后运行的Java类
--StopParams 需要传递个终止信号后运行文件的变量数值。变量用#; 字符分开
--StopMethod main 收到终止信号后运行的Java类中的开始方法,可以不是main()
--StopMode 运行文件 可以是jvm javaexe;中的一个
--StopTimeout 没有限制 定义 procrun 需要等待多少秒让程序安全退出。
--LogPath 工作目录 定义日志所在目录
--LogPrefix jakarta_service 定义日志文件名称
--LogLevel info 定义日志写入的底限,可以是 error, info, warndebug
--StdOutput 把标准输出导入到文件的文件名
--StdError 把错误输出stderr导入到文件的文件名

安装服务

最方便安全的办法是用 Tomcat 提供的service.bat脚本文件。

安装名为'Tomcat5'的服务
C:\> service.bat install

如果你使用 tomcat5.exe,你需要用//IS//选项

安装名为'Tomcat5'的服务
C:\> tomcat5 //IS//Tomcat5 --DisplayName="Apache Tomcat 5" \
C:\> --Install="C:\Program Files\Tomcat\bin\tomcat5.exe" --Jvm=auto \
C:\> --StartMode=jvm --StopMode=jvm \
C:\> --StartClass=org.apache.catalina.startup.Bootstrap --StartParams=start \
C:\> --StopClass=org.apache.catalina.startup.Bootstrap --StopParams=stop

更新服务

更新服务的变量,用 //US// 选项

更新服务'Tomcat5
C:\> tomcat5 //US//Tomcat5 --Description="Apache Tomcat Server - http://tomcat.apache.org/ " \
C:\> --Startup=auto --Classpath=%JAVA_HOME%\lib\tools.jar;%CATALINA_HOME%\bin\bootstrap.jar

删除服务

如果你要删除服务,用 //DS// 变量。
如果该服务正在运行,它先会被终止运行,然后删除。

删除名为'Tomcat5'的服务
C:\> tomcat5 //DS//Tomcat5

纠错

如果需要让服务在控制台运行,用 //TS// 选项。 该服务可用 CTRL+CCTRL+BREAK终止。 如果你把 tomcat5.exe 重新命名为 testservice.exe, 那么你只要运行 testservice.exe, 控制模式是缺省的模式。

用控制台模式运行 'Tomcat5'
C:\> tomcat5 //TS//Tomcat5 [更多变量]
或简单运行:
C:\> tomcat5


Copyright © 1999-2006, Apache Software Foundation