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