Apache Tomcat 5.5 Servlet/JSP 容器

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

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

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

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	启动服务的状态，可以是 auto 或 manual
--DependsOn	罗列Tomcat服务必须依赖的其他系统服务。如果有多个服务，用# 或 ;符号来分开
--Environment	罗列需要提供给该服务的环境变量。格式为： key=value. 用 # 或 ; 符号来区分
--User	用来运行该指令的用户名。只是用在 StartMode 下的 java 或 exe，这样可以使Tomcat服务以没有 LogonAsService 特权的用户的名义来运行。
--Password	--User 所列用户的密码
JAVA_HOME	JAVA_HOME	可以定义一个不同于系统的JAVA_HOME环境变量，指定使用不同的Java
--Jvm	auto	允许的值为auto或jvm.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 java 或 exe
--StopImage	收到终止信号后运行的文件名
--StopPath	收到终止信号后运行文件的工作目录
--StopClass	收到终止信号后运行的Java类
--StopParams	需要传递个终止信号后运行文件的变量数值。变量用# 或 ; 字符分开
--StopMethod	main	收到终止信号后运行的Java类中的开始方法，可以不是main()
--StopMode	运行文件	可以是jvm java 或exe；中的一个
--StopTimeout	没有限制	定义 procrun 需要等待多少秒让程序安全退出。
--LogPath	工作目录	定义日志所在目录
--LogPrefix	jakarta_service	定义日志文件名称
--LogLevel	info	定义日志写入的底限，可以是 error, info, warn 或 debug
--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+C 或 CTRL+BREAK终止。 如果你把 tomcat5.exe 重新命名为 testservice.exe， 那么你只要运行 testservice.exe， 控制模式是缺省的模式。

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