核心執行檔說明
| 執行檔 | 用途 |
|---|
Tomcat5.exe | 服務安裝、啟動、停止、更新、移除 |
Tomcat5w.exe | 圖形化監控與設定介面 (系統匣圖示) |
一、Tomcat5w.exe 監控程式參數
| 參數 | 說明 |
|---|
//ES// | 編輯服務設定 (預設動作)。若將執行檔重命名為 %SERVICE_NAME%.exe 執行，同樣觸發此模式 |
//MS// | 監控服務，將圖示置於系統匣 |
二、Tomcat5.exe 服務程式命令列語法
所有指令格式：//XX//ServiceName (ServiceName 為不含 .exe 後綴的檔名，預設 Tomcat5)
服務控制指令
| 指令 | 全名 | 用途 |
|---|
//TS// | Run as Console | 主控台模式執行 (預設無參數時動作)，Ctrl+C 或 Ctrl+Break 結束 |
//RS// | Run Service | 啟動服務 (服務管理員啟動時呼叫) |
//SS// | Stop Service | 停止服務 |
//US// | Update Service | 更新服務參數 |
//IS// | Install Service | 安裝服務 |
//DS// | Delete Service | 刪除服務 (若執行中先停止) |
命令列參數 (以 -- 開頭，++ 表示附加值)
環境變數 PR_* 同名參數優先於命令列 (如 set PR_CLASSPATH=xx.jar 等同 --Classpath=xx.jar)
| 參數 | 預設值 | 說明 |
|---|
--Description | | 服務描述 (最多 1024 字元) |
--DisplayName | ServiceName | 服務顯示名稱 |
--Install | procrun.exe //RS//ServiceName | 安裝命令 |
--Startup | manual | 啟動模式：auto 自動 / manual 手動 |
--DependsOn | | 依賴服務清單，# 或 ; 分隔 |
--Environment | | 環境變數 key=value，多組用 # 或 ; 分隔 |
--User | | 執行服務的使用者帳號 (需「作為服務登入」權限) |
--Password | | 上述帳號密碼 |
--JavaHome | JAVA_HOME | 覆寫 JAVA_HOME |
--Jvm | auto | auto 或 jvm.dll 完整路徑 |
--JvmOptions | -Xrs | JVM 參數 (-D, -X)，多組用 # 或 ; 分隔 |
--Classpath | | Java ClassPath |
--JvmMs | | 初始記憶體池 (MB) |
--JvmMx | | 最大記憶體池 (MB) |
--JvmSs | | 執行緒堆疊大小 (KB) |
--StartImage | | 啟動執行檔 |
--StartPath | | 啟動工作目錄 |
--StartClass | | 啟動類別 (含 main) |
--StartParams | | 傳遞給 StartClass/StartImage 參數 |
--StartMethod | main | 啟動方法名 |
--StartMode | executable | jvm, Java, exe 三選一 |
--StopImage | | 停止執行檔 |
--StopPath | | 停止工作目錄 |
--StopClass | | 停止類別 |
--StopParams | | 傳遞給 StopClass/StopImage 參數 |
--StopMethod | main | 停止方法名 |
--StopMode | executable | jvm, Java, exe 三選一 |
--StopTimeout | No Timeout | 優雅關閉等待秒數 |
--LogPath | | 日誌路徑 |
--LogPrefix | jakarta_service | 日誌檔案前綴 |
--LogLevel | INFO | error, info, warn, debug |
--StdOutput | | stdout 重導向檔案 |
--StdError | | stderr 重導向檔案 |
三、實戰範例
1. 使用 service.bat 安裝 (最安全)
C:\> service.bat install Tomcat5
2. 直接用 Tomcat5.exe 安裝
C:\> tomcat5 //IS//Tomcat5 --DisplayName="Apache Tomcat 5" ^
--Install="C:\Program Files\Tomcat\bin\tomcat5.exe" ^
--Jvm=auto --StartMode=jvm --StopMode=jvm ^
--StartClass=org.apache.catalina.startup.Bootstrap --StartParams=start ^
--StopClass=org.apache.catalina.startup.Bootstrap --StopParams=stop
3. 更新服務參數
C:\> tomcat5 //US//Tomcat5 --Description="Apache Tomcat Server - https://jakarta.apache.org/tomcat" ^
--Startup=auto --Classpath=%JAVA_HOME%\lib\tools.jar;%CATALINA_HOME%\bin\bootstrap.jar
4. 移除服務
C:\> tomcat5 //DS//Tomcat5
5. 主控台模式除錯
C:\> tomcat5 //TS//Tomcat5
# 或直接執行
C:\> tomcat5
四、最佳實務建議
- 優先使用
service.bat 管理服務，減少參數錯誤
- 生產環境設定
--Startup=auto、--JvmMx 依記憶體調整
--JvmOptions 加入 -Dfile.encoding=UTF-8 避免中文亂碼- 設定
--StdOutput、--StdError 導向檔案便於事後分析
- 若需自訂使用者執行，務必授予「作為服務登入」權限
