第 1 章 Sun GlassFish Enterprise Server v3 版本說明

Sun GlassFish^TM Enterprise Server 產品是與 Java^TM Platform, Enterprise Edition (Java EE) 6 平台相容的伺服器，適用於開發和部署 Java EE 應用程式及 Java Web 服務。此伺服器可免費用於生產。Sun GlassFish Enterprise Server 可免費用於開發、部署及重新發行。如果您是有意重新發行的客戶，請與 Sun OEM 銷售人員連絡，以取得重新發行授權。

Sun GlassFish Enterprise Server v3 版本說明中包含 Enterprise Server v3 發行版本的重要資訊，包括新增功能、硬體與軟體需求和已知問題及解決方法 (如果有的話)。

安裝及設定軟體之前，請查看本文件，開始使用 Sun GlassFish Enterprise Server v3 前，也請閱讀本文件。請定期查詢本文件以查看最新文件內容。

• 修訂歷程記錄

• Sun GlassFish Enterprise Server v3 發行版本中有何新功能？

• 硬體和軟體需求

• 已知問題

• 限制

• Enterprise Server 文件集

• 僅 Full Platform Profile 適用的功能

• Java EE 6 標準

• Java EE 6 SDK

• 如何報告問題與提供建議

• 其他資源

• 協力廠商網站參考資料

• 為殘障人士提供的無障礙功能

修訂歷程記錄

本節提供「Sun GlassFish Enterprise Server v3 版本說明」中的變更記錄。

Sun GlassFish Enterprise Server v3 發行版本中有何新功能？

Sun GlassFish Enterprise Server v3 提供可開發及部署 Java Platform Enterprise Edition (Java EE 平台) 應用程式的伺服器，以及以 Java 技術為基礎的 Web 技術。

在此說明 Enterprise Server 的以下新功能：

• Java EE 設定檔支援

• 模組化設計

• 支援延伸 Enterprise Server

• 更新工具整合

• 程序檔語言支援

• Web 服務互通功能技術 (Web Services Interoperability Technologies, WSIT) 支援

• appclient 公用程式的增強功能

• EclipseLink 整合

• HTTP 服務設定移至網路服務

• 管理員認證的相關變更

• asadmin 公用程式的相關變更

• 檔案配置的相關變更

• Ant 工作與 asant 公用程式的相關變更

• domain.xml 驗證的相關變更

• 應用程式的相關變更

Java EE 設定檔支援

Java EE 6 引入設定檔的概念。設定檔 (profile) 是針對特定開發者社群與應用程式類型的 Java EE 技術以及 API 的集合。

透過 Sun GlassFish Enterprise Server v3 的發行可執行下列設定檔：

• Full Platform Profile。此設定檔是專為需要完整 Java EE API 集以進行企業應用程式開發的開發人員所設計。安裝 Sun GlassFish Enterprise Server v3 時，將會安裝 Full Platform Profile。此設定檔也會作為 Java EE 6 SDK 安裝的一部分安裝。

• Web Profile。此設定檔包含的屬於 Full Platform 一部分的 Web 技術，它是專為不需要 Java EE API 完整集的開發人員所設計。安裝 Sun GlassFish Enterprise Server v3 Web Profile 時，將會安裝 Web Profile。此設定檔也會作為 Java EE 6 Web Profile SDK 的一部分安裝。

Java EE 6 SDK 發行軟體可以透過 Java EE 6 SDK 下載頁面取得。

如需每個設定檔中的 API 清單，請參閱Java EE 6 標準。

模組化設計

在 Sun GlassFish Enterprise Server v3 中，GlassFish 代碼分成幾個模組，以提供靈活性與改善的執行階段效能。模組化架構實作於 OSGi Alliance 標準之上，可以重複使用 Enterprise Server v3 模組及其他模組。

此項設計變更允許您僅使用在部署應用程式時所需的模組。執行階段僅用於使用它的應用程式，實作更新時不需要重新安裝系統。此變更將啟動時間、記憶體消耗及磁碟空間需求降到最低。

模組化設計提供了以下能力：

• 部署 OSGi 束

• 部署程式庫 Java 歸檔 (JAR) 檔案

• 將現有功能替代為其他實作

支援延伸 Enterprise Server

新的 Sun GlassFish Enterprise Server v3 容器系統提供者介面 (SPI) 定義了容器開發人員必須實作的介面，讓 Enterprise Server 在必要時加以呼叫。此變更讓 Enterprise Server 使用者能夠增加管理指令及圖形化附加元件，以建立自訂應用程式伺服器。

Enterprise Server 也為新模組類型 (例如 Ruby on Rails) 提供絕佳支援。

更新工具整合

更新工具現在已內嵌於 Sun GlassFish Enterprise Server v3 管理主控台中。此工具能簡化管理可用於延伸 Enterprise Server v3 功能的附加元件及相關應用程式。

管理主控台提供透過瀏覽樹存取更新工具頁面的功能。[更新工具] 頁面提供顯示以下項目的標籤：

• 所安裝的元件

• 所安裝元件可使用的更新

• 可使用及安裝的附加元件

更新工具整合於 管理主控台中使得管理員能夠輕鬆延伸 Enterprise Server 並檢視可用更新。也可以使用 updatetool 指令取得「更新工具」的獨立版本。如需更多有關「更新工具」的資訊，請參閱「Sun GlassFish Enterprise Server v3 Administration Guide 」中的「Update Tool」。

不能使用管理主控台中的「更新工具」介面更新現有元件。若要更新或移除已安裝的元件，您必須使用獨立指令行版本或 pkg 指令。

「更新工具」是透過更新中心專案來開發。管理主控台使用 Update Center 2.3 API 來顯示可用元件、版本及日期的清單。如需有關 Update Center 2.3 的資訊，請參閱 Update Center 2.3 版本說明。

「更新工具」與「升級工具」不同，後者用於將配置及部署的應用程式從較早的 Enterprise Server 版本遷移至目前版本。如需有關「升級工具」的更多資訊，請參閱「Sun GlassFish Enterprise Server v3 Upgrade Guide 」。

程序檔語言支援

為了便於快速開發及部署應用程式，Sun GlassFish Enterprise Server v3 支援各種程序檔語言。程序檔語言讓您在其他不以 Java 技術為主的開發專案中也能應用 Enterprise Server。支援的程序檔語言包括以下項目：

• JRuby 和 Rails：程序檔語言和開發 Web 應用程式的架構

• Grails：運用 Groovy 程式語言功能且能補足 Java Web 開發機制的 Web 應用程式架構

• Jython 和 Django：Python 語言的 Java 實作、Python 以及 Python 實作 (例如 Jython) 的 Web 架構

• jMaki：建立 Ajax web 應用程式的架構

「更新工具」中的元件支援這些程序檔語言。

Web 服務互通功能技術 (Web Services Interoperability Technologies, WSIT) 支援

Sun 與 Microsoft 密切合作，以確保訊息最佳化、可靠訊息傳送和安全性等 Web 服務企業技術具有互通性。WSIT 即是這項合作所開發的產品。WSIT 屬於 Metro 2.0 的一部分，Metro 2.0 是具有高效能的可延伸 Web 服務套裝軟體，提供與 Microsoft .NET 3.5 的互通性。Metro 2.0 包括在 Enterprise Server v3 的完整發行軟體中。

WSIT 實作多種開放式 Web 服務規格，用於支援企業功能。除了訊息最佳化、可靠訊息傳送和安全性之外，WSIT 還包含啟動和配置技術。從 Java 平台目前內建的核心 XML 支援功能開始，WSIT 使用或延伸了現有功能，同時新增了可互通 Web 服務的支援功能，其中包括︰

• 啟動和配置

• 訊息最佳化技術

• 可靠訊息傳送技術

• 安全性技術

appclient 公用程式的增強功能

在此發行版本中，appclient 公用程式的增強功能如下：

• appclient 公用程式接受替代的指令行語法，該語法與 Java 應用程式啟動程式 (java) 的語法類似。

• 增加 -targetserver 選項，以便指定目標伺服器與連接埠號碼。

• 支援應用程式用戶端中的軟體資訊畫面。

如需更多資訊，請參閱 appclient(1M) 線上手冊。

EclipseLink 整合

Sun GlassFish Enterprise Server v3 使用 EclipseLink 作為其 Java Persistence API (JPA) 2.0 提供者。EclipseLink 同時也是 JSR 317 的參照實作。如需有關 EclipseLink 功能的最新資訊，請參閱 EclipseLink 2.0 版本說明。

HTTP 服務設定移至網路服務

在 Sun GlassFish Enterprise Server v3 中，多數的 HTTP 服務設定已經移至新的「網路服務」配置中。如需更多資訊，請參閱「Sun GlassFish Enterprise Server v3 Upgrade Guide 」。

管理員認證的相關變更

根據預設，在 Sun GlassFish Enterprise Server v3 中，系統不會提示輸入管理員憑證。這點與先前版本有所不同。

如果使用 ZIP 檔案安裝 Enterprise Server，當啟動管理主控台或使用 asadmin 公用程式與遠端子指令執行管理工作時，系統不會提示輸入管理憑證。

如果使用自行解壓縮檔案與圖形安裝程式安裝 Enterprise Server v3，除非在安裝期間有在 [Administration Settings] 頁中指定使用者名稱與密碼，否則系統不會提示輸入管理憑證。如果您在該頁接受預設值，則預設的管理使用者會是 admin，而密碼欄位將會留空。

如果只有一位沒有密碼的管理員使用者，則允許未經驗證的登入。如需更多有關管理員認證的資訊，請參閱「Sun GlassFish Enterprise Server v3 Administration Guide」中的「To Log In to a Domain」。

在安裝 Enterprise Server 之後，可以變更管理員認證需求。如需有關使用管理主控台執行此工作與相關工作的資訊，請參閱管理主控台線上說明。如需有關使用指令行介面的資訊，請參閱「Sun GlassFish Enterprise Server v3 Administration Guide」中的「Administering Passwords」。

asadmin 公用程式的相關變更

已修改 asadmin 公用程式的運作方式，以強調 asadmin 公用程式本身的選項與其子指令選項之間的區別。現在允許將 asadmin 公用程式本身的選項放置在子指令之前。然而考慮到與其他發行版本的相容性，仍然允許將 asadmin 公用程式本身的選項放置在子指令之後，但是此類語法已過時。

如需更多資訊，請參閱「Sun GlassFish Enterprise Server v3 Administration Guide」中的「Using the asadmin Utility」。

檔案配置的相關變更

與先前的發行版本相比，Sun GlassFish Enterprise Server v3 中包括如下檔案配置變更：

• 預設的安裝目錄如下：

  Solaris、Linux 和 Mac OS X 系統： user's-home-directory /glassfishv3

  Windows 系統： SystemDrive :\glassfishv3

• 已增加 glassfish 子目錄，在其下面含有其他子目錄。

• 產品程式庫已經從 glassfish/lib 移至 glassfish/modules。

• 已增加 osgi 目錄。

• 已增加放置法律檔案的指定目錄。授權與版權檔案現在位於 glassfish/legal。

• Sun GlassFish Message Queue 安裝於頂層目錄而非子目錄中。

• Java DB 安裝於頂層目錄而非子目錄中。

Ant 工作與 asant 公用程式的相關變更

Sun GlassFish Enterprise Server v3 提供伺服器特定的 Ant 工作 (為此必須安裝 Ant)。發行版本中未包括 asant 公用程式。

Enterprise Server 與 Apache Ant 1.6.5 版或更高版本相容。如果未安裝 Ant，可以使用「更新工具」安裝。

如需更多有關「更新工具」的資訊，請參閱「Sun GlassFish Enterprise Server v3 Administration Guide 」中的「Update Tool」。如需更多有關 Ant 工作的資訊，請參閱「Sun GlassFish Enterprise Server v3 Application Development Guide 」中的第 3 章「Using Ant with Enterprise Server」。

domain.xml 驗證的相關變更

由於 Sun GlassFish Enterprise Server v3 具有模組性和延伸性，因此無法對照靜態 DTD 檔案來驗證 domain.xml 檔案。而是改為對照原始碼中的 @Configured 附註來驗證 domain.xml 檔案。如需更多有關 domain.xml 檔案結構的資訊，請參閱「Sun GlassFish Enterprise Server v3 Domain File Format Reference 」。

應用程式的相關變更

Enterprise Server v3 和 Enterprise Server v2 之間存有與應用程式相關的差異。本節將描述部分差異。

force 選項

Enterprise Server v3 中，部署的 force 選項的預設值為 false。Enterprise Server v2 中的預設值為 true。在 Enterprise Server v3 中，必須在重新部署時明確將選項設定為 true。在升級過程中不會自動設定此選項。這項變更的目的是為了避免意外覆寫現有應用程式的內容。此變更會套用至管理控制台和指令行公用程式。

asadmin redeploy 指令在 Enterprise Server v3 中也是新的指令，功能與 --force=true 相同。force 選項僅適用於 deploy 指令 (指令行介面) 以及 deploy 畫面 (主控台)，而不適用於 redeploy 指令和 redeploy 畫面。

應用程式和產生的目錄配置

Enterprise Server v2 包含兩個應用程式儲存庫的子目錄：applications/j2ee-apps 和 applications/j2ee-modules。Enterprise Server v3 中並沒有這些子目錄 (沒有 j2ee-apps 或 j2ee-modules 層級)。獨立模組 (例如 foo.war) 的部署在 Enterprise Server v2 中位於 applications/j2ee-modules/foo，現在在 Enterprise Server v3 中則位於 applications/foo。企業應用程式和獨立模組實質上是共用相同的名稱空間，因此不需要中間目錄層。

domain.xml application 元素

如 web-module、ejb-module 等先前的元素在 Enterprise Server v3 中已經棄用，以新的 application 元素取代。如需更多有關 application 元素的資訊，請參閱「Sun GlassFish Enterprise Server v3 Domain File Format Reference 」中的「application」。

在升級期間，會以 domain.xml 中的新 application 元素，在新的 applications/ 位置重新部署 Enterprise Server v2 應用程式。在 Enterprise Server v3 部署的任何新應用程式都會以新的目錄結構和元素部署。

更嚴格的 JAR 可視性規則

Java EE 6 制定了比 Java EE 5 更嚴格的 JAR 可視性規則。因此，有些較舊的應用程式可能會失敗。

Java EE 6 規格 制定了嚴格的規則，規定企業歸檔 (Enterprise Archive, EAR) 檔案中有哪些 JAR 檔案可見。請特別參閱 EE.8.3.3 節。具體而言，除非應用程式用戶端 JAR 檔案的清單 Class-Path 有明確參照 EJB JAR 檔案，否則應用程式用戶端模組應無法存取任何 EJB JAR 檔案。

這與 Enterprise Server v2 中不同，在 Enterprise Server v2 中，應用程式用戶端會自動擁有 EAR 檔案中的所有 EJB JAR 檔案以及 EAR 檔案頂層的所有 JAR 檔案之存取權限。為了符合更嚴格的規格語言，Enterprise Server v3 無法自動為應用程式用戶端提供這些 JAR 檔案的存取權限。

Java EE 6 所制定的更為嚴格的新運作方式可以透過下列方式實現：

• 如果應用程式已部署至 Enterprise Server v2 網域，「升級工具」將會保留該應用程式在該網域的 Enterprise Server v2 運作方式。如需有關升級的更多資訊，請參閱「Sun GlassFish Enterprise Server v3 Upgrade Guide」。

• 變更用戶端的清單 Class-Path，使其明確參照它所依據的 JAR 檔案。Class-Path 不得列出 EAR 檔案的程式庫目錄中的 JAR 檔案。依照規格的要求，EAR 檔案中的所有模組都可使用該目錄中的所有 JAR 檔案。根據預設，此目錄為 /lib，或者可以使用 application.xml 描述元中的 library-directory 將其設定為其他目錄。

• 使用選擇性的 --property compatibility=v2 設定部署 EAR 檔案。如此便可在將應用程式部署至 Enterprise Server v3 時，保留該應用程式的 Enterprise Server v2 運作方式。

對運作方式的這項變更也會在「Sun GlassFish Enterprise Server v3 Upgrade Guide」中的第 1 章「Application Server Compatibility Issues」中討論。

應用程式用戶端 deploy --retrieve 和 get-client-stubs 指令

在 Sun GlassFish Enterprise Server v3 中，執行 deploy --retrieve 和 get-client-stubs 指令不再與 Enterprise Server v2 中一樣僅下載一個 JAR 檔案到本機目錄中。雖然在 Enterprise Server v3 中仍然會建立 localdir/myAppClient.jar ，而且可以用作 appclient 指令的目標，但是同時也會建立另一個目錄 localdir/myAppClient，進而包含其他檔案。

如果一般是複製一個 Enterprise Server v2 下載的 JAR 檔案，以這種方式來將應用程式用戶端元件移動到其他位置，則此方法在 Enterprise Server v3 中無效。支援的方法是使用 asadmin get-client-stubs 指令實現這一目的。如需有關此指令的資訊，請參閱 get-client-stubs(1)。

但是如果仍然選擇複製，則除了複製 localdir/myAppClient.jar 檔案 (如同 Enterprise Server v2 中一樣) 以外，您還必須複製 localdir/myAppClient 目錄中的所有內容。

硬體和軟體需求

本節列出安裝 Sun GlassFish Enterprise Server v3 產品之前必須達到的需求。

• 支援的平台

• 系統虛擬支援

• 所需磁碟空間

• 所需可用連接埠

• 重要修補程式資訊

• 所需的 JDK 版本

• JDK 軟體的路徑設定

• 支援的 JDBC 驅動程式與資料庫

• 支援的瀏覽器

• mod_jk 支援

支援的平台

Sun GlassFish Enterprise Server v3 需要至少 200 MB 的可用磁碟空間才能安裝，需要 100 MB 的可用記憶體才能執行。

下表列出支援的作業系統，並提供各作業系統的最小記憶體、建議的記憶體、最小磁碟空間、建議的磁碟空間及 Java 虛擬機器。

如下所列，Enterprise Server 需要 JDK^TM 發行版本 6。所需的最低 (與認可) 的 JDK 6 軟體版本視作業系統而定。如需平台特定的需求，請參閱所需的 JDK 版本。

在 UNIX® 平台上，您可以使用 uname 指令檢查作業系統版本。可以使用 df 指令檢查磁碟空間。

在任何 Microsoft Windows 平台上執行 Enterprise Server 時，請使用 NTFS 檔案系統，而非 FAT 或 FAT32。

系統虛擬支援

系統虛擬是一種可讓多重作業系統 (OS) 實例在共用硬體上各自獨立執行的技術。在功能上，部署到位於虛擬環境中作業系統的軟體，一般不會察覺其基礎平台已虛擬化。Sun 已在所選系統虛擬和作業系統組合上測試其 Sun Java System 產品，以協助驗證 Sun Java System 產品是否可以繼續在適當大小且已配置虛擬化的環境中運作，如同在非虛擬化系統上一般執行作業。如需有關 Sun 對於虛擬化環境中 Sun Java System 產品支援的資訊，請參閱「System Virtualization Support in Sun Java System Products 」。

所需磁碟空間

暫存目錄必須有足夠的可用空間以供安裝下列軟體：

• Sun GlassFish Enterprise Server：最少 35 MB

• SDK：最少 250 MB

所需可用連接埠

您必須擁有七個未使用的連接埠可用。

安裝程式會自動偵測使用中的連接埠，並會針對預設設定建議未使用的連接埠。

下表列出指定的初始預設連接埠。如果這些預設連接埠號碼已在使用中，安裝程式會從動態連接埠範圍中指定隨機選取的連接埠號碼。選取的連接埠號碼可能並不是下一個可用的連接埠號碼。

重要修補程式資訊

Solaris 修補程式需求

如果您使用 Solaris 10 作業系統，必須依照下表所列內容，為您的平台套用適當的修補程式。

同時您必須確定已套用 Sun 建議的修補程式叢集。

這些修補程式與修補程式叢集可從 SunSolve^SM 程式網站 取得。

• 若要獲得修補程式，請按一下 [PatchFinder] (修補程式尋找) 連結，然後使用 [Patch ID] (修補程式 ID) 欄位尋找修補程式。

• 若要獲得修補程式叢集，請按一下 [Downloads] (下載) 區段中的 [Patch Cluster and Patch Bundle Downloads] (修補程式叢集和修補程式束下載) 連結，然後按一下建議的修補程式叢集的連結。

所需的 JDK 版本

Sun GlassFish Enterprise Server v3 安裝需要 JDK 發行版本 6。

Enterprise Server 所需的最低 (與認可) 的 JDK 軟體版本視作業系統而定：

• 在 Mac OS X 以外的支援作業系統中，所需的最低版本為 1.6.0_17。

• 在 Mac OS X 作業系統中，所需的最低版本為 1.6.0_15。

JDK 軟體的路徑設定

與 Enterprise Server 搭配使用的以下二進位檔案必須來自 JDK 軟體，而不是 Java Runtime Environment (JRE^TM) 軟體：

• java

• keytool

為符合此需求，請確定在您的路徑中，JDK 軟體的 bin 目錄是在 JRE 軟體的 bin 目錄之前。

支援的 JDBC 驅動程式與資料庫

下表列出了此發行版本中支援的資料庫和驅動程式。Sun GlassFish Enterprise Server v3 支援的所有配置，至少必須包含此表格所列的其中一種資料庫與驅動程式組合，例如 Java DB 與驅動程式。此外，Enterprise Server 設計為能使用支援 JDBC API (JDBC 驅動程式) 的相應驅動程式，支援透過 Java 資料庫連結 (JDBC^TM) 技術連接至其他所有的資料庫管理系統 (Database Management System, DBMS)。

支援的瀏覽器

下表列出支援的瀏覽器與版本。

mod_jk 支援

Sun GlassFish Enterprise Server v3 支援 mod_jk 1.2.x，支援的最低版本為 1.2.26。

已知問題

本節描述 Sun GlassFish Enterprise Server v3 中的已知問題和解決方法 (如果有的話)。

• [JDK_Issue] 因呼叫 setSoLinger 或 setReuseAddress 造成效能降級 (問題 7109)

• [JDK_Issue] 伺服器重新啟動時出現空指標異常 (問題 8299)

• [JDK_Issue] IO 異常：在壽命測試期間出現無效引數 (問題 7529)

• [JDK_Issue] 啟動時出現 EPoll 空指標異常 (問題 9472)

• [JDK_ISSUE] Richaccess：java.io.IOException: 來自 doSelect 的引數無效 (問題 8573)

• 網域的 /applications 目錄的檔案權限可能導致 NullProcessException (問題 6545)

• Windows 安裝記錄檔無法閱讀 (問題 4881)

• 重新啟動伺服器後才可存取新虛擬伺服器的統計資料 (問題 6238 與 6422)

• [Open Installer] 在 Windows 中會忽略用來遷移記錄檔的選項 -l (問題 10693)

• 如果在 Windows Vista 上啟用 UAC，則 ZIP 發行軟體會發生問題 (問題 10755)

• com.sun.xml.wss.NonceManager.getInstance 丟出空指標異常 (問題 11138)

• [Open Installer] 在 Windows Vista 和 Windows 2008 中 [開始] 功能表未顯示，然後變成空白 (問題 5087)

• 在部署 specj 應用程式後，asadmin get --monitor=true "server.*" 會導致 I/O 錯誤 (問題 11163)

• 由於 Solaris 的分段錯誤使得獨立更新工具失敗 (問題 11222)

• 環境根目錄中部署的 Ruby 應用程式無法與管理主控台搭配使用 (問題 10854)

• Java EE 6 Managed Bean 支援在使用 Java Web Start 啟動的應用程式用戶端中不可用 (問題 11257)

• 在帶有 Apple Java 實作的 Mac OS X 中呼叫 appclient 程序檔時出現警告訊息 (問題 8644)

• 啟動應用程式用戶端可能造成用戶端的主類別產生 ClassNotFound 錯誤 (問題 11181)

• 對記錄檔位置的變更需要重新啟動伺服器才能生效 (問題 11142)

• 無法使用 Linux 和 Mac OS 中的 [Summary] 畫面上的連結開啟安裝記錄檔 (問題 6621)

• 如果重新安裝至 Windows 中的相同安裝目錄，updatetool 指令無法正常工作 (問題 8233)

• [Update Center] 非使用者目錄存取失敗 (Update Center 問題 1583)

• 內嵌說明和 CLI 線上手冊在 X-Powered-By 中列出不正確的 servlet 2.4 版 (問題 11011)

• [Embedded] 在使用 uber-jar 時，包含 activation-1.1.jar 的應用程式部署失敗 (問題 11149)

• 在 passwordfile 中沒有 AS_ADMIN_USER 的情況下，create-service 無法在 Solaris 上建立服務 (問題 11119)

• [Monitoring] connector-connection-pools 的附加監視檢視不可用 (問題 11256)

• [EclipseLink] 可內嵌部分的 ElementCollections 的問題 (EclipseLink 問題 296606)

• 虛擬伺服器啟動兩次 (問題 11195)

• 除錯 JPA 時發生問題 (問題 11274)

• 當目標 EJB 位於相同主機時，遠端 EJB 的 EJB 互通功能失敗 (問題 11152)

• 在 Windows Vista 和 Windows 7 中，安裝程式偶爾會在安裝進度為 41% 時當機 (問題 11185)

• 無法在系統間傳送 JMS 訊息 (問題 11254)

• Windows 系統功能表為空 (問題 11239)

• mysql 未列於 deploy 指令線上手冊內 --dbvendorname 中的支援資料庫清單中 (問題 11328)

• 內嵌式 ACC 對於目前執行緒環境類別載入器的限制過嚴 (問題 11427)

• MySQL 的 EJB 計時器服務配置問題 (問題 11428)

• deploy 子指令因安全伺服器而失敗 (問題 11439)

• Enterprise Server 信任清單存放區中過期的憑證 (問題 6852796)

[JDK_Issue] 因呼叫 setSoLinger 或 setReuseAddress 造成效能降級 (問題 7109)

說明

在呼叫 setSoLinger 方法或 setReuseAddess 方法時，會出現效能降低並丟出下列異常：

[#|2009-01-26T00:33:56.325-0800|WARNING|sun-appserver9.1|
javax.enterprise.system.container.web|_ThreadID=17;
_ThreadName=SelectorReaderThread-8084;
_RequestID=11ae0030-c392-4217-8408-cfa7efe0a879;|setSoLinger
exception
java.net.SocketException: Invalid argument

此問題是由 JDK 軟體的問題所造成。該問題已在 JDK 7 版中解決。

如需更多資訊，請參閱問題報告。

解決方法

無。

[JDK_Issue] 伺服器重新啟動時出現空指標異常 (問題 8299)

說明

重新啟動 Enterprise Server 有時候會造成丟出空指標異常。

SEVERE: doSelect exception
java.lang.NullPointerException

此問題是由 JDK 軟體的問題所造成。該問題已在 JDK 7 版中解決。

如需更多資訊，請參閱問題報告。

解決方法

無。

[JDK_Issue] IO 異常：在壽命測試期間出現無效引數 (問題 7529)

說明

在 HTTP 壽命測試期間，執行 42 小時後會丟出下列異常：

[#|2009-04-05T17:41:26.537-0700|SEVERE|glassfish|javax.enterprise.system.core|
_ThreadID=15;_ThreadName=Thread-1;|doSelect
exception
java.io.IOException: Invalid argument

實例與應用程式在執行期間仍然可以存取。

此問題是由 JDK 軟體的問題所造成。該問題已在 JDK 7 版中解決。

如需更多資訊，請參閱問題報告。

解決方法

無。

[JDK_Issue] 啟動時出現 EPoll 空指標異常 (問題 9472)

說明

在啟動時，Enterprise Server 丟出空指標異常：

java.lang.NullPointerException
        at sun.nio.ch.Util.atBugLevel(Util.java:326)
        at sun.nio.ch.SelectorImpl.<init>(SelectorImpl.java:40)
        at sun.nio.ch.EPollSelectorImpl.<init>(EPollSelectorImpl.java:47)

此問題與 Grizzly 有關，是 JDK 6 的問題。該問題已在 JDK 7 中解決。

如需更多資訊，請參閱問題報告。

解決方法

無。Grizzly 嘗試解決這個問題但仍然可能失敗。

[JDK_ISSUE] Richaccess：java.io.IOException: 來自 doSelect 的引數無效 (問題 8573)

說明

出現下列異常：

[#|2009-06-20T06:05:57.942-0700|SEVERE|glassfish|
com.sun.grizzly.config.GrizzlyServiceListener|
_ThreadID=21;_ThreadName=Thread-2;|doSelect
IOException
java.io.IOException: Invalid argument

此為 JDK 問題，計畫將在 JDK 1.6.0_18 中解決。

如需更多資訊，請參閱問題報告。

解決方法

將檔案描述元的最大數目增加為 10000 或以上 (在 Solaris 上的預設值為 64000)。一旦 JDK 1.6.0_18 可以使用，請即安裝。

網域的 /applications 目錄的檔案權限可能導致 NullProcessException (問題 6545)

說明

如果網域的 /applications 目錄限制存取，或者您使用受限制目錄的目錄部署，伺服器將無法讀取展開目錄中的檔案。部署時發生 NullProcessException 錯誤。

如需更多資訊，請參閱問題報告。

解決方法

變更此類目錄的檔案存取設定，以授予伺服器讀取目錄內容的權限。

Windows 安裝記錄檔無法閱讀 (問題 4881)

說明

無法讀取 time-stamp-install.log 檔案，因為會將寫入檔案中的所有行鏈結成單一長字串。

如需更多資訊，請參閱問題報告。

解決方法

使用不同的編輯器，並手動開啟建立在 %TEMP% 目錄下的安裝記錄檔。

重新啟動伺服器後才可存取新虛擬伺服器的統計資料 (問題 6238 與 6422)

說明

只有在重新啟動伺服器之後，才能監視有關新增虛擬伺服器的統計資料。

如需更多資訊，請參閱問題 6238 和 問題 6422 的報告。

解決方法

新增虛擬伺服器之後，請重新啟動伺服器以檢視虛擬伺服器的監視資料。

[Open Installer] 在 Windows 中會忽略用來遷移記錄檔的選項 -l (問題 10693)

說明

在與選項 -a 和 -s 搭配使用時，用來遷移記錄檔的選項 -l 會被忽略，而記錄檔會建立在預設位置。

如需更多資訊，請參閱問題報告。

解決方法

無。

如果在 Windows Vista 上啟用 UAC，則 ZIP 發行軟體會發生問題 (問題 10755)

說明

在 Windows Vista 中啟用使用者帳戶控制 (User Account Control, UAC) 功能時，某些功能可能無法正常運作。其中一個例子便是管理主控台，它無法在上述情況下順利啟動。

如需更多資訊，請參閱問題報告。

解決方法

停用 UAC 然後重新開機。

com.sun.xml.wss.NonceManager.getInstance 丟出空指標異常 (問題 11138)

說明

在啟用 GlassFish 訊息安全提供者的情況下測試 JAX-RPC Web 服務時，將會在伺服器記錄中丟出下列異常：

[#|2009-11-23T11:16:58.375+0005|SEVERE|glassfishv3.0|
javax.enterprise.resource.webservices.rpc.server.http|_ThreadID=25;_
ThreadName=http-thread-pool-8080-(2);|caught
throwable
java.lang.RuntimeException: com.sun.enterprise.security.jauth.AuthException

nonce 屬性的預設值無法正常工作。

如需更多資訊，請參閱問題報告。

解決方法

若要在 JAX-RPC Web 服務中使用訊息安全，請停用配置中的 nonce 屬性。請參閱問題報告了解解決方法的完整步驟。

[Open Installer] 在 Windows Vista 和 Windows 2008 中 [開始] 功能表未顯示，然後變成空白 (問題 5087)

說明

在完成初次安裝之後，未顯示 Enterprise Server 的 [開始] 功能表群組。如果您登出然後重新登入，功能表群組雖然會顯示，但卻是空白。

如需更多資訊，請參閱問題報告。

解決方法

無。

在部署 specj 應用程式後，asadmin get --monitor=true "server.*" 會導致 I/O 錯誤 (問題 11163)

說明

指令 asadmin get -m "server.*" 傳回與該伺服器有關的所有監視資料。在部署許多應用程式時，資料的數量非常龐大，可能要花很長的時間才能傳回。用戶端可能逾時，並產生下列用戶端錯誤：

./asadmin get --monitor=true "server.*"
I/O Error: Read timed out
Command get failed.

如需更多資訊，請參閱問題報告。

解決方法

將要傳回至用戶端的資料數量減至最低。

1. 執行 asadmin list -m "server.*" 指令，該指令可傳回頂層元素。

2. 選取需要其詳細資料的頂層元素，並且用它作為篩選器。例如︰

   > ./asadmin list -m "server.*" ... server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-cache server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods. create-int-int-[Lorg\.spec\.jappserver\.supplier\.helper\.ComponentOrder server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods. findByPrimaryKey-java\.lang\.Integer server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.generateXml server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.getEJBLocalHome ... >./asadmin get -m "server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.*" ... server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.remove. methodstatistic-name = MethodStatistic server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.remove. methodstatistic-starttime = 1259604209775 ...

由於 Solaris 的分段錯誤使得獨立更新工具失敗 (問題 11222)

說明

在安裝附加元件時，Solaris 上發生分段錯誤，使得以 updatetool 指令啟動的獨立更新工具失敗。

如需更多資訊，請參閱問題報告。

解決方法

請確定您的系統符合 Update Center 版本說明 中定義的獨立更新工具修補程式需求。

管理主控台中的更新工具功能使用不同的以 Java 為基礎的 Update Center API，因此不受到此問題影響。

環境根目錄中部署的 Ruby 應用程式無法與管理主控台搭配使用 (問題 10854)

說明

如果在環境根目錄「/」中部署 Ruby 應用程式，隨後存取管理主控台，則存取 Ruby 應用程式時會產生 404 錯誤。

如需更多資訊，請參閱問題報告。

解決方法

無。

Java EE 6 Managed Bean 支援在使用 Java Web Start 啟動的應用程式用戶端中不可用 (問題 11257)

說明

當使用 Java Web Start 啟動應用程式用戶端時，無法識別應用程式用戶端中任何 Managed Bean。

如需更多資訊，請參閱問題報告。

解決方法

使用 appclient 程序檔啟動應用程式用戶端，便能夠正常支援應用程式用戶端中的 Managed Bean。

在帶有 Apple Java 實作的 Mac OS X 中呼叫 appclient 程序檔時出現警告訊息 (問題 8644)

說明

當您在已安裝 Apple Java 的 Mac OS X 系統中呼叫 appclient 程序檔時，下列的堆疊追蹤會出現兩次 (此處僅顯示前幾行)：

Intentionally suppressing recursive invocation exception!
java.lang.IllegalStateException: recursive invocation
    at java.lang.ClassLoader.initSystemClassLoader(ClassLoader.java:1394)
    at java.lang.ClassLoader.getSystemClassLoader(ClassLoader.java:1377)
    at sun.security.jca.ProviderConfig$1.run(ProviderConfig.java:64)
...

如需更多資訊，請參閱問題報告。

解決方法

不需要採取任何行動。

雖然有警告訊息，但是用戶端會順利啟動並正常執行。這些錯誤是由 Apple Java 實作中的問題所造成。

啟動應用程式用戶端可能造成用戶端的主類別產生 ClassNotFound 錯誤 (問題 11181)

說明

滿足下列所有情況時會發生問題：

• 應用程式為包含應用程式用戶端的 EAR。

• EAR 是已部署的目錄。

• EAR 包含應用程式用戶端模組 myAppClient.jar，而且因為它是目錄部署，已預先擴展為 myAppClient_jar。(基於此範例的目的，myApp 為 EAR 的名稱。此名稱可以是任何文字。)

嘗試啟動應用程式用戶端失敗，並出現下列錯誤，原因是在伺服器上產生的一個檔案放置在錯誤的伺服器目錄中，並且覆寫了另一個產生的檔案：

java.lang.ClassNotFoundException:(main-class-for-the-client)

如需更多資訊，請參閱問題報告。

解決方法

將應用程式用戶端的名稱變更為 myAppClient.jar 以外的名稱。具體而言是：

1. 編輯 myApp/META-INF/application.xml，使得用戶端的宣告為 <java>myClient.jar</java>。請注意，您可以使用 myAppClient.jar 以外的任何名稱。

2. 將目錄 myApp/myAppClient_jar 重新命名為 myApp/myClient_jar。請注意，用戶端的子目錄名稱必須和 application.xml 檔案中的應用程式用戶端 URI 相同，且將 .jar 取代為 _jar。

3. 部署應用程式：

   asadmin deploy --retrieve localdir myApp

4. 執行應用程式用戶端：

   appclient -client localdir/myAppClient.jar

對記錄檔位置的變更需要重新啟動伺服器才能生效 (問題 11142)

說明

在管理主控台的 [Logger Settings] 頁面的 [General] 標籤中對伺服器記錄值進行變更不會立即生效。

如需更多資訊，請參閱問題報告。

解決方法

重新啟動伺服器。對於此頁中值的所有變更均需要重新啟動伺服器才能生效。

無法使用 Linux 和 Mac OS 中的 [Summary] 畫面上的連結開啟安裝記錄檔 (問題 6621)

說明

在圖形安裝程式之安裝過程結束時會顯示 [Summary] 頁面，無法透過點選該頁面上的連結來開啟安裝記錄檔。

如需更多資訊，請參閱問題報告。

解決方法

手動存取檔案。安裝記錄和摘要檔案的名稱分別為 timestamp-install.log 和 timestamp-install-summary.html。在 Linux 和 Mac 系統中，這些檔案會在 $TMP 目錄下產生。

如果重新安裝至 Windows 中的相同安裝目錄，updatetool 指令無法正常工作 (問題 8233)

說明

如果您使用相同預設值將 Enterprise Server (帶有更新工具) 重新安裝在相同的安裝目錄，然後使用 updatetool 指令呼叫更新工具，您會收到訊息，顯示未安裝更新工具並且詢問您是否要安裝。這個問題只在 Windows 系統上發生。

如需更多資訊，請參閱問題報告。

解決方法

在解除安裝之後，先手動移除殘留的 .org* 目錄，然後再重新安裝。

[Update Center] 非使用者目錄存取失敗 (Update Center 問題 1583)

說明

在 Windows 和 Mac OS 系統中偶爾會出現此問題。在某些系統中，pkg(5) 有時候沒有作用。

如需更多資訊，請參閱 Update Center 問題報告。

解決方法

無。

內嵌說明和 CLI 線上手冊在 X-Powered-By 中列出不正確的 servlet 2.4 版 (問題 11011)

說明

內嵌說明和 CLI 線上手冊在 X-Powered-By 欄位中列出 servlet 2.4。正確的版本為 servlet 3.0。

如需更多資訊，請參閱問題報告。

解決方法

無。

[Embedded] 在使用 uber-jar 時，包含 activation-1.1.jar 的應用程式部署失敗 (問題 11149)

說明

在以 glassfish-embedded-all-3.0-b73.jar 內嵌使用時，部署失敗並出現下列錯誤：

SEVERE: WEB9051: Error trying to scan the classes at
/private/var/folders/CV/CVhj8DvqEwGK5bdJKK9TaE   TI/-Tmp-
/gfembed6991712842235699248tmp/applications/xwiki-enterprise-web-2.0/
WEB-INF/lib/activation-1.1.jar for annotations in which a 
ServletContainerInitializer has expressed interest
java.util.zip.ZipException: error in opening zip file

發生此問題是由於內嵌使用帶有加號 (+) 的資料夾，而在解碼路徑時，路徑中的加號被轉換為空格字元「 」。

如需更多資訊，請參閱問題報告。

解決方法

已增加系統屬性，讓您能夠放置暫存目錄。屬性為 glassfish.embedded.tmpdir 而且可以設定，使得暫存網域目錄不會放置在使用者目錄中。

在 passwordfile 中沒有 AS_ADMIN_USER 的情況下，create-service 無法在 Solaris 上建立服務 (問題 11119)

說明

在 passwordfile 中沒有 AS_ADMIN_USER 的情況下，create-service 無法在 Solaris 上建立服務。

如需更多資訊，請參閱問題報告。

解決方法

無。

[Monitoring] connector-connection-pools 的附加監視檢視不可用 (問題 11256)

說明

Enterprise Server 使用樹狀結構追蹤可監視物件。在該樹狀結構中，無法使用下列檢視取得連線儲存池統計資料：

server.connector-service.resource-adapter-name .connection-pool-name .* 或 server.jms-service.connection-factories. connection-factory-name.* (針對 jms-ra 相關儲存池)。

如需更多資訊，請參閱問題報告。

解決方法

使用 server.resources.* 檢視獲得統計資料。

如需更多有關監視的資訊，請參閱「Sun GlassFish Enterprise Server v3 Administration Guide」中的第 8 章「Administering the Monitoring Service」。

[EclipseLink] 可內嵌部分的 ElementCollections 的問題 (EclipseLink 問題 296606)

說明

在啟用織入 (weaving) 的情況下，更新可內嵌元素集合有可能會丟出空指標異常。

如需更多資訊，請參閱 EclipseLink 問題報告。

解決方法

解決方法有兩個：

1. 在可內嵌元素集合上加入附註 @ChangeTracking(DEFFERED) 並且將屬性 eclipselink.weaving.internal 設定為 false，或

2. 在持續性 XML 中將下列屬性設定為 false：eclipselink.weaving.changetracking 和 eclipselink.weaving.internal。

虛擬伺服器啟動兩次 (問題 11195)

說明

在啟動網域並存取 localhost:4848 之後，伺服器記錄中會出現下列訊息：

[#|2009-11-27T16:21:57.091+1100|INFO|glassfishv3.0|
javax.enterprise.system.container.web.com.sun.enterprise.web|
_ThreadID=20;_ThreadName=Thread-1;|Created
virtual server server|#]

[#|2009-11-27T16:21:57.091+1100|INFO|glassfishv3.0|
javax.enterprise.system.container.web.com.sun.enterprise.web|
_ThreadID=20;_ThreadName=Thread-20;|Created
virtual server server|#]

這些訊息讓人感覺虛擬伺服器 server 啟動了兩次。實際情況並非如此。虛擬伺服器僅啟動一次，但是記錄了多次訊息。

如需更多資訊，請參閱問題報告。

解決方法

無。

除錯 JPA 時發生問題 (問題 11274)

說明

由於伺服器的訊息有限，因此除錯 JPA 較為困難。

如需更多資訊，請參閱問題報告。

解決方法

將屬性 org.eclipse.persistence.session.level=INFO 增加至 logging.properties 檔案。接著您可以使用管理主控台來控制 EclipseLink 記錄器。

當目標 EJB 位於相同主機時，遠端 EJB 的 EJB 互通功能失敗 (問題 11152)

說明

當目標 EJB 位於相同的主機 (其他 Enterprise Server 網域或其他 Enterprise Server v3 實例) 時，遠端 EJB 的 EJB 互通功能失敗。

如需更多資訊，請參閱問題報告。

解決方法

在 jvm-options 中設定下列屬性：

-Dorg.glassfish.orb.iiop.orbserverid=:

在 Windows Vista 和 Windows 7 中，安裝程式偶爾會在安裝進度為 41% 時當機 (問題 11185)

說明

在 Windows Vista 和 Windows 7 中安裝時，Enterprise Server 圖形安裝程式會在安裝至 41% 時當機。這個情況並非每次安裝都會發生。

如需更多資訊，請參閱問題報告。

解決方法

這個問題與 Windows Vista 和 Windows 7 中預設啟用的自動調整功能有關。

如果您在最初安裝 Enterprise Server 時，或是在增加套裝軟體或套用更新時發生當機，請限制或停用自動調整功能。

無法在系統間傳送 JMS 訊息 (問題 11254)

說明

根據預設，Enterprise Server 上 JMS 服務的預設主機名稱為 localhost。然而，要從其他系統存取 JMS 服務，您必須變更主機名稱。您可以將它變更為實際的主機名稱或變更為 0.0.0.0。

如需更多資訊，請參閱問題報告。

解決方法

要進行變更，請執行下列其中一項動作：

1. 使用管理主控台：展開 [配置]、[Java Message Service] 和 [JMS Hosts] 節點，選取 default_JMS_host，然後編輯 [Host] 欄位，或

2. 使用 asadmin 子指令，如下所示：

   asadmin set server-config.jms-service.jms-host.default_JMS_host.host="0.0.0.0" ，或

   asadmin set server-config.jms-service.jms-host.default_JMS_host.host="hostname"

Windows 系統功能表為空 (問題 11239)

說明

使用圖形安裝程式安裝 Enterprise Server 時，雖然能夠成功完成安裝，但是只有頂層的 GlassFish v3 項目會增加至 Windows 系統功能表中，而且此功能表為空。在本土化和英文版的安裝程式中都會發生此問題。

如需更多資訊，請參閱問題報告。

解決方法

無。

mysql 未列於 deploy 指令線上手冊內 --dbvendorname 中的支援資料庫清單中 (問題 11328)

說明

mysql 未列於 deploy 指令線上手冊內 --dbvendorname 中的支援資料庫清單中。這不正確。MySQL 是支援的資料庫，其中應該列出。

如需更多資訊，請參閱問題報告。

解決方法

無。

內嵌式 ACC 對於目前執行緒環境類別載入器的限制過嚴 (問題 11427)

說明

ACC 期望目前執行緒的環境類別載入器是 ACCClassLoader。這一限制過嚴。雖然 appclient 程序檔與 Java Web Start 啟動符合此條件，但是內嵌式功能可能不符合此條件。ACC 內部的其他功能要求類別載入器是 URLClassLoader (或 URLClassLoader 之子類別的實例)，但載入器不需要是 ACCClassLoader。

如需更多資訊，請參閱問題報告。

解決方法

解決方法有兩個：

1. 設定 -Djava.system.class.loader=org.glassfish.appclient.client.acc.ACCClassLoader，或者

2. 在 Java 程式中，將 ACCClassLoader 實例化，並且在使用內嵌式 ACC 類別及介面之前，使用 Thread.currentThread().setContextClassLoader 將它設定為目前執行緒的環境類別載入器。

MySQL 的 EJB 計時器服務配置問題 (問題 11428)

說明

能夠以使用者身份在 MySQL 中建立和儲存 EJB 計時器，但是，在嘗試為 MySQL 配置 EJB 計時器服務時，出現下列異常 (SQLException 執行敘述)：

"CREATE TABLE EJB__TIMER__TBL (TIMERID
VARCHAR(255) NOT NULL, BLOB BLOB(64000), INITIALEXPIRATIONRAW BIGINT, SCHEDULE
VARCHAR(255), INTERVALDURATION BIGINT, OWNERID VARCHAR(255), STATE INTEGER,
LASTEXPIRATIONRAW BIGINT, PKHASHCODE INTEGER, CREATIONTIMERAW BIGINT,
CONTAINERID BIGINT, PRIMARY KEY (TIMERID))":
com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: You have an error in
your SQL syntax; check the manual that corresponds to your MySQL server version
for the right syntax to use near 'BLOB BLOB(64000), INITIALEXPIRATIONRAW BIGINT,
SCHEDULE VARCHAR(255), INTERVALDU' at line 1|#] 

如需更多資訊，請參閱問題報告。

解決方法

確定為計時器集區指定的 datasource-classname 代表 XA DataSource。

MySQL 特定步驟：

1. 解壓縮 glassfishv3/glassfish/lib/install/applications/ejb-timer-service-app.war。

2. 將下列內容增加至 WEB-INF/classes/__ejb_timer_mappings.xml 中的 <persistence-unit-metadata> 之後：

   <persistence-unit-defaults>
   <delimited-identifiers/>
   </persistence-unit-defaults>

3. 重新封裝 WEB-INF/classes/__ejb_timer_mappings.xml 檔案。

4. (只有在目前安裝已使用 EJB 計時器服務時，才需要此步驟。)使用此 create 陳述式，在資料庫中手動建立 EJB__TIMER__TBL：

   CREATE TABLE `EJB__TIMER__TBL` (`TIMERID` VARCHAR(255) NOT NULL,
   `BLOB` BLOB(64000), `INITIALEXPIRATIONRAW` BIGINT, `SCHEDULE` VARCHAR(255),
   `INTERVALDURATION` BIGINT, `OWNERID` VARCHAR(255), `STATE` INTEGER,
   `LASTEXPIRATIONRAW` BIGINT, `PKHASHCODE` INTEGER, `CREATIONTIMERAW` BIGINT,
   `CONTAINERID` BIGINT, PRIMARY KEY (`TIMERID`))

deploy 子指令因安全伺服器而失敗 (問題 11439)

說明

除非使用 --secure 選項，否則 deploy 子指令會因安全伺服器而失敗。

如需更多資訊，請參閱問題報告。

解決方法

對安全伺服器發出 deploy 子指令時，使用 --secure 選項。

Enterprise Server 信任清單存放區中過期的憑證 (問題 6852796)

說明

Enterprise Server 信任清單存放區的其中一個權限憑證於 2010 年 1 月 7 日過期。該憑證為 cacerts.jks。啟動時產生錯誤訊息，指示憑證已過期：

Version: V1
  Subject: OU=Secure Server Certification Authority, O="RSA Data Security, Inc.", C=US
  Signature Algorithm: MD2withRSA, OID = 1.2.840.113549.1.1.2

  Key:  SunPKCS11-Solaris RSA public key, 1000 bits (id 17891456, session object)
  modulus: 
  public exponent: 
  Validity: [From: Tue Nov 08 19:00:00 GMT-05:00 1994,
               To: Thu Jan 07 18:59:59 GMT-05:00 2010]
  Issuer: OU=Secure Server Certification Authority, O="RSA Data Security, Inc.", C=US
  SerialNumber: [    02ad667e 4e45fe5e 576f3c98 195eddc0]

如需更多資訊，請參閱問題報告。

解決方法

Java SE 6 的更新 18 中已移除過期的權限憑證。未來的更新也將從 Enterprise Server 信任清單存放區中移除它。

您可以忽略該錯誤訊息並使用更新，也可以清除該錯誤訊息。若要停止收到錯誤訊息，請使用金鑰工具，從 Enterprise Server 信任清單存放區中移除憑證：

=> cd domains/domainX/config
=> cp cacerts.jks cacerts.jks.save
=> keytool -delete -keystore cacerts.jks -alias verisignserverca
Enter keystore password:

若要避免在後續建立的網域中再次出現過期的憑證，也應該從範本信任清單存放區中移除該憑證：

=> cd glassfish/lib/templates
=> cp cacerts.jks cacerts.jks.save
=> keytool -delete -keystore cacerts.jks -alias verisignserverca
Enter keystore password:

如需有關金鑰庫密碼的更多資訊，請參閱「Sun GlassFish Enterprise Server v3 Administration Guide」中的「Authentication」中關於主要密碼及金鑰庫的資訊。

限制

本節說明下列 Sun GlassFish Enterprise Server v3 限制：

• 在 asadmin 指令中不支援的選項

• Windows AMD64 不支援用戶端 VM

在 asadmin 指令中不支援的選項

asadmin 指令的說明描述 Sun GlassFish Enterprise Server v3 不支援的某些選項。例如︰

• 與叢集和多個伺服器實例相關的選項，例如 --target 選項

• 與設定檔相關的選項，例如 --profile 選項

如果您指定不支援的選項，並不會發生語法錯誤。指令反而會成功執行，而不支援的選項會遭到忽略，不產生任何通知。

Windows AMD64 不支援用戶端 VM

依照預設，Enterprise Server 會使用用戶端 VM 來達到最佳啟動與部署效能。如果您使用的是 Windows AMD64，編輯 domain.xml 檔案以移除 <jvm-options>–client<jvm-options> 行。在此情況下，JVM 的自我調整功能將會為特定平台選擇適當種類的 VM。

如需更多有關平台支援的資訊，請參閱 「Ergonomics in the 5.0 Java Virtual Machine」(「5.0 版 Java 虛擬機器中的自我調整功能」)。

Enterprise Server 文件集

下表提供 Enterprise Server 文件集中的書名與簡短說明。

僅 Full Platform Profile 適用的功能

以下 Sun GlassFish Enterprise Server v3 功能是僅適用於 Full Platform Profile 的功能：

• 構成完整 EJB 3.1 API 的 EJB 功能，如遠端 EJB 元件、訊息驅動 Bean、Web 服務 EJB 端點和 EJB 計時器服務

  Web Profile 中支援 EJB 3.1 Lite 規格。此規格允許 Web 應用程式中的企業 Bean，並且包括對本機無狀態階段作業 Bean、狀態階段作業 Bean 和單例階段作業 Bean 的支援。

• 應用程式用戶端容器

• JMS 資源

• Web 服務

  在 Web Profile 中，Servlet 或 EJB 元件不可以是 Web 服務端點。與 Web 服務有關的 sun-web.xml 和 sun-ejb-jar.xml 元素會被忽略。

• 訊息安全性

• JavaMail 資源

Web Profile 中支援僅使用外送通訊功能的連接器模組，以及不涉及內送通訊功能的工作管理。其他連接器功能僅在 Full Platform Profile 中才支援。

Java EE 6 標準

Sun GlassFish Enterprise Server v3 實作下表中所列出的 Java EE 標準。此表也指出各發行軟體中是否實作了某個標準。

X 表示發行軟體中可以使用實作。

- 表示發行軟體中不可以使用實作。

以這些標準為基礎，Enterprise Server v3 提供了多項延伸，包括以下項目：

• Ajax (非同步 JavaScript 與 XML)：可擷取及顯示一部分網頁的新資料，而不影響其餘頁面。

• Metro：可實作 Java Architecture for XML Binding (JAXB) 與 Java APIs for XML Web Services 2.1 (JAX-WS 2.1) 的服務套裝軟體。

• Grizzly：用於建立可延伸及牢固伺服器的架構，使用了全新的 I/O (NIO) API，能將系統規模延伸到數千名使用者。提供了內嵌元件的能力，可支援 HTTP、Bayeux Protocol、Java Servlet API 與 Comet。

Java EE 6 SDK

Enterprise Server v3 隨附於 Java EE 6 SDK。可以使用下列 Java EE 6 SDK 版本：

• Java EE 6 SDK。此版本包含 Sun GlassFish Enterprise Server v3。此版本是專為需要完整 Java EE API 集以進行企業應用程式開發的開發人員所設計。

• Java EE 6 Web Profile SDK。此版本包含 Sun GlassFish Enterprise Server v3 Web Profile。此版本包含屬於 Full Platform Profile 一部分的 Web 技術，專為不需要 Java EE API 完整集的開發人員所設計。

Java EE 6 SDK 發行軟體可以透過 Java EE 6 SDK 下載頁面取得。

如何報告問題與提供建議

如果您有 Sun GlassFish Enterprise Server v3 方面的問題，請透過以下其中一種機制來提供意見：

• GlassFish 郵件收信人清單：針對不同主題與意見設立的各種 GlassFish 社群郵件收信人清單

• GlassFish 論壇：討論 GlassFish 專案的論壇

其他資源

可在下列位置找到有用的資訊：

• GlassFish 社群

• Glassfish Wiki：GlassFish v3

• Sun 開發人員資訊

• Sun 開發人員支援服務

• Sun Microsystems 產品文件

協力廠商網站參考資料

本文件中提供了協力廠商 URL 以供參考，另亦提供其他相關的資訊。

Sun 對本文件中提到的協力廠商網站的可用性不承擔任何責任。對於此類網站或資源中的 (或透過它們所取得的) 任何內容、廣告、產品或其他材料，Sun 並不表示認可，也不承擔任何責任。Sun 對於因使用或依靠此類網站或資源中的 (或透過它們所取得的) 任何內容、產品或服務而造成的或連帶產生的任何實際或名義上之損壞或損失，Sun 概不負責，也不承擔任何責任。

為殘障人士提供的無障礙功能

欲獲得這些媒體發佈以來已發行的無障礙功能，請向 Sun 索取依據美國「Section 508」法規進行產品評估所得之結果文件，以便決定最適合佈署無障礙功能解決方案的版本。以下網址將提供應用程式的更新版本：http://sun.com/software/javaenterprisesystem/get.html。

如需有關 Sun 在無障礙功能方面之成果的資訊，請至 http://sun.com/access。