http://gceclub.sun.com.cn/staticcontent/html/webservices/web_services_tutorial/3/3.3.htm
Java Web Services Developer Pack包括Tomcat Web 服務器管理工具，后文簡稱管理工具。管理工具 Web應用程序可用于操作Tomcat的運行。例如，可以添加和（或）配置上下文、主機、成員域和連接器，或者為容器管理安全性設置用戶和角色。
為啟動admintool，執行下列步驟。
1． 按照啟動Tomcat中的說明啟動Tomcat。
2． 啟動Web瀏覽器。
3． 在Web瀏覽器內，指向下列URL：
http://localhost:8080/admin
<user name="adeveloper" password="secret"
roles="admin, manager" />
該命令調用了admin Web應用程序。在使用該應用程序前必須添加用戶名/密碼組合并將其與角色名admin關聯。訪問這個工具所需的的初始用戶名和密碼必須在Java WSDP安裝期間設置。如果忘記了用戶名和密碼，可以用任意的文本編輯器參閱<JWSDP_HOME>/conf/tomcat-users.xml。該文件包含各個用戶的元素<user>，該元素可能如下所示：<user name="adeveloper" password="secret"
roles="admin, manager" />
4． 使用分配了admin角色的用戶名和密碼組合登錄到admintool。該用戶名和密碼必須與build.properties文件中的用戶名和密碼匹配。
5． 結束時，通過選擇上窗格中的Logout來退出管理工具。
本節介紹了如何利用管理工具設置角色、組和用戶。比如關于利用管理工具創建、刪除、和（或）配置的信息：
· Tomcat服務器。
· 運行在Tomcat服務器上的服務，以及嵌套在這些服務里的各種元素，例如主機、上下文、成員域、連接器、日志記錄器以及過濾閥。
· 各種資源例如數據源、環境條目，以及用戶數據庫。
理解角色、組以及用戶
Tomcat服務器驗證服務包括下列組件：
· 角色——用于設置具體的資源訪問權限的抽象名。角色可比作能開鎖的鑰匙。許多人可能都配有同樣的鑰匙，而鎖不會考慮你是誰，只要有正確的鑰匙就行了。
· 用戶——經過驗證（關于驗證前面章節已討論過）的個人（或者應用程序）身份。一個用戶可以有一系列與他身份相關聯的角色，這樣他就可以訪問所有被保護的資源。
· 組——按照像工種或客戶資料這樣的普通特性分類的一組驗證用戶。組還與一組角色關聯，并且屬于該組的用戶繼承了所有分配給該組的角色。
· 成員域——角色、用戶和組的完整數據庫，用于識別Web應用程序的合法用戶。
我們將在管理角色和用戶一節中詳細討論了這些概念，關于管理工具的更多信息也可以找到。
利用管理工具添加角色
為設置容器管理安全的全新角色，遵循下列說明。管理工具中的添加、刪除和改變寫在tocamt-users.xml文件中。
1． 向下滾動管理工具的左窗格到User and Group Administration（用戶和組管理）節點。
2． 選擇Role Administration（角色管理）。
3． 從Roles List（角色列表）中選擇Create New Role（創建新角色）。
4． 輸入角色名和描述，例如Customer或User。
5． 選擇Save（保存）。
利用管理工具添加用戶
要想為容器管理安全設置新用戶，遵循下列說明。管理工具中的添加、刪除和改變寫在tocamt-users.xml文件中。
1． 向下滾動管理工具的左窗格到User and Group Administration（用戶和組管理）節點。
2． 選擇User Administration（用戶管理）。
3． 從Users List（用戶列表）中選擇Create New User（創建新用戶）。
4． 輸入用戶名和密碼，并為新用戶選擇一個角色。如果為新用戶選擇admin角色，該用戶將能訪問管理工具.
5． 選擇Save（保存）。
修改應用程序
由于Java Web Services Developer Pack用于實驗目的，它支持重復開發。只要改動了應用程序，就必須重新部署和加載該應用程序。在build.xml文件中定義的任務使得將這些改動部署到ConverterBean和JSP頁面變得更簡單。
在build.xml文件里，我們設置了一個在運行Tomcat服務器上安裝應用程序的目標，和一個在運行Tomcat服務器內重載該應
用程序的目標。這些任務是用Tomcat服務器管理程序工具完成的，該工具是一個manager Web應用程序。可以使用在Java WSDP安裝期間設置的用戶名/密碼組合，因為它能使管理程序的角色名與它關聯。如果忘記了在安裝期間設置的用戶名/密碼組合，可以利用任何文本編輯器查閱<JWSDP_HOME>/conf/tomcat/-user.xml。
修改類文件
為了修改Java組件內的類文件，更改源代碼，重編譯它，然后重新部署應用程序。使用Tomcat manager Web應用程序時，不需要停止并重新啟動Tomcat以便重新部署這個更改過的應用程序。例如，假定你想改變ConverterBean組件的yenRate屬性中的匯率：
1. 在源目錄中編輯ConverterBean.java。
2. 通過輸入ant build重新編譯ConverterBean.java。
3. 通過輸入ant reload重新部署ConverterBean.java。
4. 在Web瀏覽器中重新加載JSP頁面。
修改Web客戶端
為了修改JSP頁面，更改源代碼并重新部署應用程序。使用Tomcat manager Web應用程序時，不需要停止并重新啟動Tomcat以便重新部署更改過的Web客戶端程序。例如，假定你想修改字體或者在JSP頁面中添加另外的描述文本。為了修改Web客戶端程序：
1． 在源目錄中編輯index.jsp。
2． 通過輸入ant reload重新加載Web應用程序。
3． 在Web瀏覽器里重新加載JSP頁面。
常見問題及其解決方案
使用下列指南來解決創建、編譯、安裝、部署和運行示例應用程序時遇到的問題。
啟動Tomcat時的錯誤
"Out of Environment Space"錯誤
癥狀：在基于Microsoft Windows 9x/ME操作系統上，運行啟動和關閉批處理文件時候出現“out of environment Space“錯誤。
解決方案：在Microsoft Windows 資源管理器中，右鍵單擊startup.bat和shutdown.bat文件。選擇“屬性”，接著選擇“內存”選項卡。 將“初始環境”域中的值增加到4096。選擇“應用”。
選中“應用”后，在用來啟動和停止容器的目錄內將生成快捷方式。
"Unable to Locate the Server localhost:8080"錯誤
癥狀：試圖在瀏覽器里加載Web應用程序時出現的"unable to locate server"錯誤。
解決方案：Tomcat的完全加載要花費一些時間，所以在繼續疑難解決前首先要保證給Tomcat至少5分鐘的加載時間。為了檢驗Tomcat是否正在運行，將瀏覽器指向http://localhost:8080。在Tomcat索引屏幕出現時，便可以繼續了。如果索引屏幕沒有立即加載，等幾分鐘然后再重試。如果Tomact還沒有加載，就像下面描述的那樣，點擊日志文件以獲取更多的疑難解答信息。
Tomcat啟動時將初始化自身，然后加載<JWSDP_HOME>/webapps中的所有Web應用程序。當通過調用startup.sh運行Tomcat時，服務器消息被登入到<JWSDP_HOME>/logs/launcher.server.log中。加載Web應用程序的過程可在<JWSDP_HOME>/logs/jwsdp_log.<date>.txt文件中看到。
編譯錯誤
Ant 不能定位生成文件
癥狀：在輸入ant build時，出現如下消息：
Buildfile: build.xml does not exist!
解決方案：從<JWSDP_HOME>/docs/tutorial/sxample/gs/目錄啟動Ant，或者從創建應用程序的目錄。如果希望從當前目錄啟
動Ant，那么必須在命令行指定生成文件。例如，輸入如下命令：
<JWSDP_HOME>/docs/tutorial/examples/gs/build.xml
編譯器不能解析符號
癥狀：輸入ant build時，編譯器會報告許多錯誤，包括：
Compile failed, messages should have been provided
解決方案：確定所使用的Ant版本是與該Java WSDP版本一起發布的。確保這一要求的最好方法是使用Ant文件的完整PATH來構建應用程序，<JWSDP_HOME>/jakarta-ant-1.5.1/bin/ant build。其他版本可能不包括示例應用程序生成文件所期望的所有功能。
“連接拒絕“錯誤
癥狀：在終端提示窗口中輸入ant install時，收到下列消息：
<JWSDP_HOME>/docs/tutorial/examples/gs/build.xml:82:
java.net.ConnectException: Connection refused
解決方案：Tomcat沒有完全啟動。等待幾分鐘，然后嘗試再次安裝應用程序。關于Tomcat啟動疑難解答的更多信息，參閱無效的本地服務器localhost:8080 。
試圖運行安裝任務時，系統出現中止
癥狀：輸入ant install時，系統出現了中止。
解決方案：Tomcat啟動腳本在后臺啟動了Tomcat，然后立即將用戶返回命令提示行。盡管返回了命令行，但啟動腳本可能還沒有完全啟動Tomcat。如果這個安裝任務沒有立即運行，等待幾分鐘后重試安裝任務。為了檢驗Tomact是否在運行，將瀏覽器指向http://localhost:8080。若出現Tomcat索引屏幕，就可以繼續。如果這個閃屏沒有立即加載，等待幾分鐘后重試。如果Tomcat一直沒有加載，檢查日志文件以獲得更多疑難解答信息：
Tomcat啟動時先初始化自己，然后加載<JWSDP_HOME>/webapps中的所有Web應用程序。通過調用startup.sh運行Tomcat時，服務器消息已經登入<JWSDP_HOME>/logs/launcher.server.log。加載Web應用程序的過程可在<JWSDP_HOME>/logs/jwsdp_log.<date>.txt文件中看到。
部署錯誤
Server returned HTTP response code: 401 for URL ...
癥狀：輸入ant install時，出現如下消息：
/home/you/gs/build.xml:44:
java.io.IOException: Server returned HTTP response code: 401
for URL: http://localhost:8080/manager/install?path= ...
解決方案：確定build.properties文件中的用戶名和密碼與具有tomcat-users.xml文件里manager角色的用戶名和密碼相匹配。
不能運行客戶端應用程序
癥狀：瀏覽器報告找不到該頁面（HTTP404）。
解決方案：啟動腳本在后臺啟動任務，然后立即將用戶返回命令行提示窗口。盡管已經返回命令行，但啟動腳本可能還沒有
完全啟動Tomcat。如果Web客戶端沒有立即運行，等待幾分鐘再重試加載Web客戶端。
找不到localhost機器
癥狀：瀏覽器報告找不到該頁面（HTTP404）。
解決方案：有時候，若位于代理服務器和防火墻的后面將不能訪問localhost機器。為了解決這個問題，更改代理設置以便不再通過代理訪問localhost。
為了在Netscape Navigator 
瀏覽器中實現這一目的，選擇Edit -> Preferences -> Advanced -> Proxies ，然后選擇 No Proxy for: localhost。 在 Internet Explorer中，選擇 Tools -> Internet Options -> Connections -> LAN Settings。
應用程序沒有部署
癥狀：瀏覽器報告找不到該頁面（HTTP404）。
解決方案：部署應用程序。想了解更多的細節，參閱部署應用程序一節。
"Build Failed: Application Already Exists at Path" 錯誤
癥狀：在終端提示窗口輸入ant install時，收到如下消息：
[install] FAIL - Application already exists at path /GSApp
<JWSDP_HOME>/docs/tutorial/examples/gs/build.xml:82: FAIL -
Application already exists at path /GSApp
該應用程序已經安裝。如果由于應用程序的安裝而對它作出了改動，利用ant reload更新Tomcat中的應用程序。
HTTP 500: No Context Error
癥狀：在試圖運行部署應用程序時候收到一個No Context Error錯誤。
解決方案：這個錯誤意味Tomcat被加載，但是它不知道應用程序。如果還沒有通過運行ant remove、ant build、ant install和ant reload部署應用程序，現在做吧。
解決方案：如果Tomacat正在加載，但是還沒有加載所有已存在的上下文，將收到該錯誤。不斷點擊瀏覽器中的重載或者刷新按鈕，直到應用程序被加載或者收到另一種錯誤消息。
更多信息
· Tomcat 管理工具。閱讀Tomcat管理工具以獲得利用admintool，無需停止并重新啟動Tomcat來配置它的行為的更多信息。
· Tomcat 配置參考。想了解更多關于能用來配置Tomacat行為的元素的信息，閱讀<JWSDP_HOME>/docs/tomcat/config/index.html中的Tomcat配置參考。
· 類加載器入門。該文檔討論了應用開發者和部署者應該把類和資源文件放在哪里，以便讓Web應用能找到它們。該文檔位于<JWSDP_HOME>/docs/tomcat/class-loader-howto.html中。
· JNDI 資源入門。該文檔討論了JNDI資源配置、Tomcat標準資源工廠、JDBC數據源，和定制資源工廠。該文檔位于 <JWSDP_HOME>/docs/tomcat/jndi-resources-howto.html中。
· Manager Application入門。該文檔描述了如何利用Manager Application，無需關閉和重新啟動Tomcat，來部署新的Web應用程序，解除部署現有的應用程序，或者重載現有的應用程序。該文檔位于<JWSDP_HOME>/docs/tomcat/manager-howto.html中。
· 代理支持入門。該文檔討論了如何在代理服務器（或者配置來行使代理服務器功能的Web服務器）后面運行。特別地，該文檔討論了如何管理來自Web應用的調用返回值。其中該Web應用請求服務器名和請求將被發往的端口號。該文檔位于<JWSDP_HOME>/docs/tomcat/proxy-howto.html中。
· 成員域配置入門。該文檔討論了如何通過連接到用戶名、密碼、和用戶角色的現有數據庫，配置Tomcat以支持容器管理安全。該文檔位于<JWSDP_HOME>/docs/tomcat/realm-howto.html
· 安全管理程序入門。該文檔討論了運行Tomcat以保護服務器免受未經驗證的serlvets、JSP、JSP bean、和標簽庫侵擾時，Security Manager的用法。該文檔位于<JWSDP_HOME>/docs/tomcat/security-manager-howto.html中。
SSL 配置入門。該文檔討論了如何在Tomcat上安裝和配置SSL支持。安裝和配置SSL支持中討論了如何利用Java WSDP在Tomcat上安裝和配置SSL支持。<JWSDP_HOME>/docs/tomcat/ssl-howto.html 中的Tomcat文檔也討論了這個主題，然而，本教程中的信息對于這個與Java WSDP一起發布的Tomcat版本來說是最新的。