Apache Tomcat 5.5 Servlet/JSP 容器

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

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 启动服务的状态，可以是 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