測試和部署工具 - 版本注意事項

1.0 簡介
2.0 支援的軟體和規格
3.0 前一版的變更
4.0 限制
   4.1 WebSphere 伺服器必須有相符的字碼頁
5.0 已知的問題
   5.1 配置 WebSphere 第 5 版的 J2C 資源配接器
   5.2 因無效字元而無法建立或啟動 WebSphere Application Server
   5.3 長目錄名稱在 JSP 測試時可能會造成錯誤
   5.4 Internet Explorer:使用本端位址時停用 Proxy 或 Socks 伺服器
   5.5 切斷網際網路連線時使用 Apache Tomcat 的問題
   5.6 WebSphere 伺服器安全
   5.7 執行連接至 WebSphere Application Server 的 Java 應用程式
   5.8 在啟用安全的情況下執行 WebSphere 4.0 版管理用戶端
   5.9 WebSphere 測試環境版本
   5.10 在 Universal Test Client 中使用建構子
   5.11 在 Windows 中發佈遠端第 5 版伺服器時,發生區分大小寫的問題
   5.12 在 Universal Test Client 中的預設 JNDI 提供者 URL
   5.13 J2EE 用戶端無法存取遠端機器中的測試環境伺服器
   5.14 WebSphere 4.0 版的追蹤
   5.15 在解除安裝 WebSphere 第 4 版執行時期之後會留下部分檔案
   5.16 套用 WebSphere 第 4 版 PTF 時的訊息
   5.17 在 WebSphere 第 5 版管理主控台中建立資料來源和伺服器
   5.18 移動伺服器配置和更名伺服器專案
   5.19 WebSphere 伺服器的路徑選項
   5.20 設定遠端伺服器使用內嵌傳訊
   5.21 忽略「主控台」視圖中「只安裝 Embedded Messaging Client」的訊息
   5.22 配置 Cloudscape 5.1
   5.23 將 WebSphere 伺服器重新發佈至 AIX 機器會造成警告訊息
   5.24 全速除錯和快速取代方法支援
   5.25 WebSphere MQ 移轉
   5.26 從 WebSphere Studio 5.0 版移轉已部署的連接器專案
   5.27 WebSphere 伺服器因工作區路徑開頭是反斜線而沒有啟動
   5.28 當儲存新的 JAAS 鑑別項目時,伺服器可能會毀損

1.0 簡介

「伺服器工具」特性可讓您在不同的本端和遠端執行時期環境下測試及發佈 J2EE 應用程式。這個 Readme 檔會說明和下列「伺服器工具」功能相關聯的限制、已知問題以及解決方案。

測試和發佈的線上說明包含了「伺服器工具」限制以及解決「伺服器工具」問題的其餘資訊。

如需受支援之執行時期環境的資訊,請參閱產品的 Readme 檔。

2.0 支援的軟體和規格

Universal Test Client 需要使用 Netscape 第 6.0 版或更新的版本,或使用 Microsoft Internet Explorer 5.0 或更新的版本

3.0 前一版的變更

伺服器工具支援在 Windows、Linux 和 AIX 機器的 WebSphere 伺服器測試和發佈專案。

4.0 限制

4.1 WebSphere 伺服器必須有相符的字碼頁

當利用遠端 WebSphere 伺服器來測試時,遠端機器的字碼頁必須和本端機器相同。 不支援以不同的字碼頁來執行本端和遠端伺服器,這可能會造成主控台毀損。

5.0 已知的問題

5.1 配置 WebSphere 第 5 版的 J2C 資源配接器

當您按一下 WebSphere 第 5 版伺服器配置編輯器 J2C 頁面的「新增」按鈕時,可能會出現錯誤。 如果要暫時解決這個問題,請改為配置 EAR 內的連接器模組或採取下列步驟:

1. 啟用 WebSphere 管理主控台,再啟動伺服器。

2. 開啟和登入管理主控台。請從左側選取資源 > 資源配接器

3. 按一下新建。 請輸入連接器模組的名稱,再指定專案內之 connectorModule 資料夾的完整路徑。 比方說,C:\workspace\myConnector\connectorModule。

4. 按一下套用,再重新整理 IDE 內的伺服器專案。現在,您可以繼續利用伺服器配置編輯器來進行任何進一步的變更。

5.2 因無效字元而無法建立或啟動 WebSphere Application Server

如果您將 WebSphere Studio 安裝在名稱含有錢號 ($) 或任何 #、%、+ 或 * 之類特殊字元的目錄中,WebSphere 伺服器可能會無法建立或無法順利啟動。 如果要避免這種情況,請不要將 WebSphere Studio 安裝在包含任何這些字元的目錄中。

當建立 WebSphere 伺服器或將包含 WebSphere 伺服器的伺服器專案時,請勿在名稱中併入 #、%、& 或 * 字元。 WebSphere Application Server 不支援這些字元。

5.3 長目錄名稱在 JSP 測試時可能會造成錯誤

如果您使用的工作區位在路徑很長的目錄中,或您為企業應用程式專案或 Web 專案選擇了很長的名稱,當您嘗試執行 JSP 頁面時,可能會收到下列錯誤訊息:

錯誤訊息:JSPG0113E: 找不到 JSP 檔 
"Xxx/Yyy_jsp_0.java(檔案名稱過長)"

如果您收到這個錯誤,您可以採取下列任一動作:

5.4 Internet Explorer:使用本端位址時停用 Proxy 或 Socks 伺服器

如果您在 Internet Explorer 中使用的是 Proxy 或 Socks 伺服器,它在本端位址上應該停用。 否則,當您嘗試利用內部 Web 瀏覽器或您安裝的 Microsoft Internet Explorer 版本檢視 Universal Test Client 或任何其他 Web 應用程式時,這可能會造成問題。

5.5 切斷網際網路連線時使用 Apache Tomcat 的問題

Apache Tomcat 隨附的預設 web.xml 檔包含了網際網路上 DTD 檔的參照。因此,當您切斷網際網路的連線時,Tomcat 伺服器將無法啟動。在 WebSphere Studio 中,這些參照已從 Tomcat 3.2 版的配置中移除,因此獨立執行時仍然可以運作。如果您從 WebSphere Studio 之外匯入了 Tomcat 伺服器配置, 或使用的是 Tomcat 4.0 版,當您在切斷網際網路連線的情況下運作時,可能會有問題。如果發生這個狀況,請採取下列步驟來移除這個參照。

  1. 備份 Tomcat 伺服器配置中的 web.xml 檔。
  2. 利用文字編輯器編輯 Tomcat 伺服器配置中的 web.xml 檔。
  3. 從檔案中移除整個 DOCTYPE 元素。
  4. 儲存並關閉編輯器。
如果您在啟動伺服器時發生問題,您可能需要連接到網際網路,並利用備份的 web.xml 檔重新加入 DOCTYPE 元素。

5.6 WebSphere 伺服器安全

在啟用伺服器安全時,請勿提供名稱與安裝 WebSphere Application Server 的機器相同的伺服器 ID。 否則,WebSphere Application Server 可能會無法啟動。

伺服器使用者 ID 的使用者權利原則也必須授予使用者作為部分作業系統的專用權。

5.7 執行連接至 WebSphere Application Server 的 Java 應用程式

WebSphere Application Server 會限制所有利用 WebSphere 用戶端來連接在 WebSphere 伺服器中執行的 Enterprise Bean 之 Java 應用程式,都必須使用建置 WebSphere 用戶端時所用的相同 IBM Java ORB 層次。 如果您沒有使用相同的 ORB 層次,當您執行用戶端應用程式時,您可能會收到如下的錯誤:

java.lang.NoClassDefFoundError: com/ibm/rmi/iiop/GIOPVersionException

如果要確定所用的 ORB 層次正確,您可以利用 WebSphere JRE 來執行用戶端應用程式。 如果要做到這一點,請遵循下列步驟:

  1. 在「除錯」視景中,利用「執行 > 執行」或「執行 > 除錯」功能表項目來開啟「啟動配置」對話框。
  2. 選取您要編輯的「Java 應用程式啟動配置」。
  3. 進入 JRE 頁面,從組合框中選取適當的 WebSphere JRE。
  4. 套用變更。

另外,只要您確定使用相符的 ORB 層次,您也可以利用任何 JRE 來執行用戶端應用程式。 如果要做到這一點,請遵循下列步驟:

  1. 在「除錯」視景中,利用「執行 > 執行」或「執行 > 除錯」功能表項目來開啟「啟動配置」對話框。
  2. 選取您要編輯的「Java 應用程式啟動配置」。
  3. 進入「引數」頁面,新增下列項目至「VM 引數」欄位中:
    -Xbootclasspath/p:WAS_installdir\java\jre\lib\ext\ibmorb.jar
    其中 WAS_installdir 是執行時期所在的目錄,例如,c:\Program Files\IBM\WebSphere Studio\runtimes\aes_v4
  4. 套用變更。

5.8 在啟用安全的情況下執行 WebSphere 4.0 版管理用戶端

當安全設定啟用時,WebSphere 第 4 版的管理用戶端將無法直接從工作台啟動。如果要啟動管理用戶端,請遵循下列步驟:

  1. 啟動 WebSphere 伺服器。
  2. 開啟 Web 瀏覽器並輸入下列 URL:http://[localhost:8080]/admin,其中 [localhost:8080] 是您要使用的伺服器名稱和埠號。
  3. 輸入您用來配置安全設定的使用者 ID 和密碼。按一下「提交」。
  4. 在右窗格中,按一下配置 > 開啟
  5. 選取「輸入檔案在伺服器上的完整路徑」。
  6. 在文字欄位中輸入伺服器配置的完整路徑。例如:C:\studio\eclipse\workspace\Servers\was.wsc\server-cfg.xml。
  7. 按一下「確定」。

5.9 WebSphere 測試環境版本

WebSphere 第 4 版的測試環境是以 WebSphere 4.06 版為基礎。 WebSphere 第 5 版的測試環境是以 WebSphere 5.02 版為基礎。 當您從舊版的 WebSphere Studio 移轉時,WebSphere 測試環境的任何電子修訂都會被移除,因此您必須以手動方式重新安裝它們。

5.10 在 Universal Test Client 中使用建構子

當您使用 Universal Test Client 時,您將無法建構以取用介面作為「參數」頁面中的參數之物件。所有從介面類型的參數建構的物件,都必須使用類別參照區段。

首先,請載入並建構介面類型或抽象類型的物件,接著載入包含該抽象/介面類型建構子的類別。這時您可在「參數」頁面中選擇之前建立的物件。

5.11 在 Windows 中發佈遠端第 5 版伺服器時,發生區分大小寫的問題

如果已將某專案發佈在 Windows 的遠端第 5 版伺服器中,之後又將專案名稱改成同名但不同大小寫,比方說,將 "MyEarProject" 更名為 "myearproject", 在伺服器啟動期間,您可能會得到若干檔案不存在的錯誤。 這是 Windows 的限制,WebSphere Studio 無法區分兩個同名但不同大小寫的已發佈的專案。 您可以從遠端機器中手動移除已發佈的伺服器配置,再重新發佈專案,來修正這個問題。

5.12 在 Universal Test Client 中的預設 JNDI 提供者 URL

WebSphere Studio 4.0 版的 Universal Test Client 預設 JNDI 提供者 URL 已經有了改變。 新的提供者 URL 是 "iiop://2809",而不是 "iiop://900"。 如果您手動啟動測試用戶端,且需要舊的埠號(比方說,存取 WebSphere 4.0 版),您可以在測試用戶端內,利用「內容」頁面來變更提供者 URL。

5.13 J2EE 用戶端無法存取在遠端機器中的測試環境伺服器

當試圖從在遠端機器中執行的 J2EE 用戶端存取測試環境伺服器時,您可能會得到 org.omg.CORBA.COMM_FAILURE。 您必須配置遠端伺服器配置中所定義的 ORB 引導主機名稱來修正這個問題。 如果要編輯 ORB 引導主機名稱,請移至伺服器編輯器的頁面,將 ORB 引導埠區段下的主機名稱欄位設為遠端主機名稱。

變更之後,請儲存變更,再重新啟動測試環境伺服器,使變更生效。

5.14 WebSphere 4.0 版的追蹤

如果您停用 WebSphere 4.0 版的追蹤,主控台會出現 ConnectionException,您將無法正確停止伺服器。

5.15 在解除安裝 WebSphere 第 4 版執行時期之後會留下部分檔案

當解除安裝 WebSphere 第 4 版執行時期時,在解除安裝之後,WS_installdir/runtimes/aes_v4 目錄可能仍然存在。 如果這個目錄仍然存在,您必須手動移除這個目錄;否則,WebSphere 第 4 版伺服器支援可能會有問題。 如果 WebSphere Studio 解除安裝之後,又安裝在相同位置上,也必須手動進行相同的檢查。

5.16 套用 WebSphere 第 4 版 PTF 時的訊息

當套用 WebSphere 第 4 版 PTF 時,可能會出現下列訊息:「請注意:請在伺服器啟動之後重新產生外掛程式配置,以更新 plugin-cfg.xml 檔」。 您可以放心忽略這個訊息。

5.17 在 WebSphere 第 5 版管理主控台中建立資料來源和伺服器

當利用 WebSphere Studio 內的 WebSphere 第 5 版管理主控台來加入資料來源或建立伺服器時,可能會出現 NullPointerException 或其他錯誤。 請使用下列其中一個暫行解決方案:

  1. 如果您要建立資料來源,請改用 WebSphere 第 5 版伺服器編輯器。 您可以在「伺服器」或「伺服器配置」視圖中,按兩下 WebSphere 第 5 版伺服器來開啟編輯器。 請移至「資料來源」頁面來新增、編輯或移除伺服器中的資料來源。
  2. 停止伺服器。
    1. 將下列目錄中的範本目錄(其中 WS_installdir 是 WebSphere Studio 的安裝目錄):
      WS_installdir\runtimes\base_v5\config\templates
      複製到下列資料夾下的現行工作區中:
      workspace_ dir\server_ project\server_ name.wsc 資料夾
    2. 重新啟動伺服器,再重試一次。

5.18 移動伺服器配置和更名伺服器專案

伺服器及其伺服器配置之間的關聯包括伺服器配置所在的專案。 當您更名伺服器專案或將伺服器配置移至不同的專案時,任何使用這個配置的伺服器的關聯都會中斷。 如果要解決這個問題,請在「伺服器」視圖中用滑鼠右鍵按一下伺服器,選取切換配置 > server_configuration_name,重新建立配置和伺服器的關聯。

5.19 WebSphere 伺服器的路徑選項

WebSphere 伺服器編輯器「環境」頁面的「路徑選項」功能無法運作。 在 Java 程式庫路徑欄位中輸入的路徑會加入現有伺服器 PATH 中。 您無法控制資料會加在哪裡,比方說,資料可能會加在開頭、結尾,或取代現有的伺服器 PATH。

5.20 設定遠端伺服器使用內嵌傳訊

設定伺服器使用內嵌傳訊主題中,測試環境一節的部分內容適用於遠端伺服器一節的指示。 您必須在本端或遠端伺服器配置中定義下列項目:WAS_PUBSUB_ROOT、MQ_INSTALL_ROOT 和伺服器端的佇列管理程式。 另外,伺服器配置的 ws.ext.dirs 區段中,必須有指向安裝 WebSphere MQ 之 java/lib 目錄的項目。

請參閱這個主題的測試環境一節,以取得設定佇列管理程式的指示。 在獨立式 WebSphere Application Server 機器中有相同的 createmq 批次檔,位於相對於 WebSphere Application Server 安裝起始目錄的相同目錄中。 如果您從 WebSphere Studio 將伺服器部署在遠端的 WebSphere Application Server 機器中,您也必須執行這個步驟。

附註:如果您是利用 WebSphere Studio 安裝程式來安裝內嵌傳訊,您不需要執行 createmq.bat,也不需要設定 variables.xml 或建立批次檔來啟動工作台,以確保 MQ 二進位檔在 WAS 伺服器路徑中。 您仍需要在伺服器的 ws.ext.dirs 中新增內容。 只有在您是利用 WebSphere Application Server 安裝程式來安裝內嵌傳訊時,這個作業才是必要的。

5.21 忽略「主控台」視圖中「只安裝 Embedded Messaging Client」的訊息

在 WebSphere 5.0 版測試環境啟動期間,「主控台」視圖可能會出現訊息,說明「只安裝 Embedded Messaging Client」,即使在 WebSphere Studio 的安裝架構中並沒有安裝內嵌傳訊這個選用元件也是如此。 您可以放心忽略這個訊息,它並不暗示已安裝了內嵌傳訊,而是定義了某些伺服器配置變數給產生這個誤導性訊息的測試伺服器。

5.22 配置 Cloudscape 5.1

如果要安裝 Cloudscape 5.1,請在 Windows 中執行 installCloudscape51.bat 檔,或在 Linux 平台中執行 Cloudscape51.sh 檔。 這個檔案在 WS_installdir/runtimes/base_v5/cloudscape51 目錄中(其中 WSinstalldir 是 WebSphere Studio 的安裝目錄。 安裝程式會啟動 WebSphere 專用的 Cloudscape 安裝程式。 當系統提示您輸入目錄名稱時,請瀏覽或輸入您的 WS_installdir/runtimes/base_v5 目錄。

附註:安裝 Cloudscape 5.1 之後,就不能執行或擁有任何 Cloudscape 5.0 定義的資料來源。 如果您要執行 Cloudscape 5.0,您必須先解除安裝 Cloudscape 5.1,再移除 Cloudscape 5.1 資料來源或將它們改成 Cloudscape 5.0 資料來源。

5.23 將 WebSphere 伺服器重新發佈至 AIX 機器會造成警告訊息

將 WebSphere 伺服器重新發佈在 AIX 機器時,發佈對話框可能會出現若干無法刪除某些檔案的警告訊息。 您可以放心忽略這些警告訊息。

5.24 全速除錯和快速取代方法支援

只有在 WebSphere 第 5 版測試環境中進行除錯時,才支援全速除錯和快速取代方法。 不支援在 WebSphere 第 5 版測試環境之外進行應用程式除錯。

5.25 WebSphere MQ 移轉

WebSphere MQ 元件不支援跨版本的相容性。 您應該確定您在使用的 WebSphere MQ 版本的修正程式層次與您部署其中的 WebSphere 測試環境或 WebSphere 伺服器相同。

比方說,您不應搭配 WebSphere 5.0.2 版測試環境來使用 WebSphere Studio 5.0 版所安裝的 WebSphere MQ。 相反地,您應該解除安裝 WebSphere MQ,再安裝 WebSphere Studio 5.1 版所檢附的版本。

5.26 從 WebSphere Studio 5.0 版移轉已部署的連接器專案

當移至較高版本時,不會自動移轉在部署於 WebSphere 測試環境或 WebSphere 伺服器的連接器專案所在的 WebSphere Studio 5.0 版中建立的工作區。 當您試圖將連接器專案發佈在伺服器時,可能會出現錯誤。

如果要暫時解決這個問題,請在「伺服器」視圖中,用滑鼠右鍵按一下伺服器,選取新增和移除專案。 請從伺服器中移除 EAR 專案,再重新將它新增至伺服器中。 這會修正 WebSphere 伺服器配置,因而能夠正確部署連接器專案。

5.27 WebSphere 伺服器因工作區路徑開頭是反斜線而沒有啟動

當使用開頭是反斜線的工作區路徑時,無法啟動 WebSphere 伺服器。 若干工作區路徑範例會造成這個問題:

 \workspaceA
 \my_workspaces\work1

開頭是磁碟機字母或開頭不是反斜線的工作區路徑不會造成這個問題。 如果您已利用開頭是反斜線的工區來啟動 WebSphere Studio,請遵循這些步驟,使 WebSphere 伺服器能夠啟動:

  1. 關機 WebSphere Studio。
  2. 重新啟動 WebSphere Studio(如果您先前選擇在啟動時隱藏選取工作區的對話框,請使用 -setworkspace 旗標)。
  3. 當提示您輸入工作區位置時,請在工作區路徑開頭加上磁碟機字母。 比方說, \workspace1 would become c:\workspace1
  4. 現在,您可以啟動現有的 WebSphere 伺服器。

5.28 當儲存新的 JAAS 鑑別項目時,伺服器可能會毀損

如果您開啟第 5 版伺服器編輯器,請在不結束編輯器的情況下建立和儲存新的 JAAS 鑑別項目,再移至「資料來源」標籤,新增第 5 版資料來源,這時會出現檔案已變更對話框。 您必須按一下,以避免伺服器配置毀損。

返回主 Readme 檔