GlassFish 專案 - 入門

GlassFish Community

建立 GlassFish V2.1.1 專案
若為 GlassFish V3，請參閱此處的建立網頁
建立 GlassFish 的必要條件
快速入門指南
完整的建立指示
使用 NetBeans IDE 建立的 GlassFish
從分支建立
GlassFish Maven 目標簡介

此頁面說明如何建立 GlassFish V2。如果要提交錯誤或請求新增功能，此處提供一些實用的連結。可在此處找到管理策略。

如何建立 GlassFish V2 的完整指示

使用 NetBeans 或指令行選項建立 GlassFish。下列文章含有使用 NetBeans 建立與開發 GlassFish 專案的詳細資訊。以下為建立 GlassFish 的指令行選項。

建立 GlassFish 的必要條件。

使用者必須已安裝 Maven (1.0.2)：這會建立 Maven 儲存 GlassFish 相依性所需的本機儲存庫。
使用者必須登入 java.net，且必須有權存取 GlassFish 專案的 CVS 儲存庫。
使用者必須登入 GlassFish CVS 儲存庫一次 (如此 CVS 會將密碼儲存在使用者主目錄的 .cvspass 檔案中)
必須安裝 J2SE 5.0 (1.5.0_12)，然後將其配置成 JAVA_HOME 環境變數並儲存在二進位路徑中。建議使用最新的可用版本。
依照 java.net 指示設定 cvs 用戶端。

GlassFish 建立步驟：

第一個步驟是簽出建立系統中使用的模組相依性與共同檔案，以及編輯特性檔案。

% mkdir workspace
% cd workspace
% cvs -d :pserver:<userid>@cvs.dev.java.net:/cvs checkout -r SJSAS91_FCS_BRANCH glassfish/bootstrap

這樣會簽出 project.xml、maven.xml、project.properties 與從 project.xml 參考的共同檔案。

建立 workspace/glassfish/bootstrap/build.properties，或者針對可重複使用的 GlassFish 工作區，使用一次性程序建立 ${HOME}/build.properties (Unix) 或 %HOMEPATH%\build.properties (Windows)，並設定下列變數：(您可以執行指令 echo %HOMEPATH% 取得 %HOMEPATH% 值，或執行「set」並尋找 HOMEPATH 變數 (Windows))
如上所述定義兩個 glassfish 變數：glassfish.os.name、glassfish.cvs.username。
glassfish.os.name= <OS 名稱 - 可能的值為 WINNT、SunOS、Linux、SunOS_X86、Darwin>
glassfish.cvs.username= <java.net id>

例如，在 Windows XP Professional 上

glassfish.os.name=WINNT

glassfish.cvs.username=carlavmott

接下來簽出來源。

% cd glassfish/bootstrap
% maven checkout

已知限制：java.net 可能無法立即提供某些建立 GlassFish 所需的來源 (例如 MQ、ORB、JWSDP 2.0 等)。這些來源暫時視為二進位相依性 (有關如何使用二進位相依性，請參閱下一個步驟)。也可以透過下列呼叫簽出模組的子集：

% maven checkout -Dmodules=[以逗號分隔的模組名稱清單]

模組名稱顯示在此頁面上。

啟動載入伺服器影像 (用於執行 glassfish 的程序檔和 jar 檔案的集合)。開發人員可以選取「bootstrap」選項，此選項可下載預先建立的伺服器，並僅建立模組的子集。另一個選項「bootstrap-all」會從頭開始建立伺服器，並建立所有模組來驗證模組間或二進位相依性版本的變更。

bootstrap-all 選項：從來源建立所有模組。

% maven bootstrap-all

bootstrap 選項：使用預先建立的伺服器建立自己的模組

% maven bootstrap

如果已安裝升級的 GlassFish 版本，則可選擇性地執行此步驟。不過需要在 glassfish/project.properties 中設定特性後才能使用已升級的版本。

glassfish.image.version=<<建立版本>>

這會造成建立系統「指向」該安裝。此特性也會增加到 ${HOME}/build.properties

建立已簽出原始碼。編譯順序由上述的步驟 2 中簽出的共同配置檔所驅動。此步驟會在每個模組編譯結束時更新已安裝的影像。

% maven build

永遠都可以透過呼叫建立模組的子集：

% maven build -Dmodules=[以逗號分隔的模組名稱清單]

或移至 ../[模組名稱] 並呼叫：

% maven build

配置 GlassFish 伺服器執行階段。這個步驟將建立 asadmin 程序檔、執行 create-domain 等，這些皆為執行 GlassFish 伺服器所需的。

% maven configure-runtime (預設為無訊息安裝)

如果要指定共同配置資訊 (例如連接埠號碼等)，請在詳細模式中使用 configure-runtime。

% maven configure-runtime -Dinteractive

一般而言，此指令只需執行一次。如果要變更網域環境，則需要重新配置，詳細資訊請參閱「常見問題集」。執行階段配置的預設值位於 glassfish/bootstrap/project.properties 中：

domain.name="domain1"
instance.name="server"
admin.user="admin"
admin.password="adminadmin"
admin.port="4848"
instance.port"="8080"
orb.port="3700"
imq.port="7676"
https.port="8181"

Maven 目標「configure-runtime」將建立與 GlassFish V1 類似的單一實例網域。如果要建立 GlassFish V2 的叢集模組網域，請執行下列指令：
% maven configure-cluster

使用下列指令啟動伺服器。所有 GlassFish 伺服器指令皆位於 <glassfish.root>/publish/bin 目錄中。如需更多如何管理伺服器的文件，請參閱 Sun Java System Application Server PE 8 版系列的文件。其中的很多內容仍適用於 9 版。注意：目前 GlassFish 在所有平台上僅支援指令行選項。

% asadmin start-domain

清除伺服器。

% maven clobber

這將移除用於執行伺服器的所有程序檔與 jar 檔。而且這樣會移除 glassfish.home 下所有內容，完成該操作後必須回到步驟 2。

Clean Build/Server：開發程序期間，可使用上述三個目標中的任何一個。從而使用最喜好的 IDE 更新來源，並在已建立的工作區上使用下列任何一個指令來將工作區帶回其原始階段，以重新建立並驗證變更。

若要清除模組以刪除建立產生的檔案 (例如 .class、.properties) 並準備好重新編譯，請執行下列指令
```
% maven clean (或 maven -Dmodules=mail、activation clean)
```
若要清除在上述的步驟 5 中配置的伺服器，請使用下列指令清除伺服器，這會刪除管理伺服器 domain1，並保持該伺服器回到原始安裝的階段 (刪除在 ${glassfish.home}/bin、config 目錄中新產生的記號替代檔案)。
```
% maven clean-config
```
如果要驗證與網域相關的變更，以及與啟動相關的管理伺服器，可以使用「maven clean-config」。「clobber」目標可用於刪除伺服器以取得新的伺服器。「clean」則可用於刪除建立檔案，並準備好進行編譯。

執行 Quicklook 測試：Quicklook 測試旨在讓開發人員能夠測試應用程式伺服器中的主要功能並執行完整性檢查，以確定所有主要功能皆是完整的。

從 glassfish/appserv-tests 簽出必要的測試檔案，如下所示。

% cd glassfish/bootstrap
% maven checkout-quicklook

Set APS_HOME。這是要簽出包含工作區根目錄名稱之工作區的目錄 (例如 /workspace/appserv-tests)

Set S1AS_HOME。這是 GlassFish 伺服器的安裝目錄 (例如 /workspace/publish/glassfish)

安裝特性位於 ${APS_HOME}/config.properties 之下，以符合安裝 (例如 admin.password、 http.port 等)。如果已變更任何預設值，請編輯此 config.properties 檔案。

請先確定「並未」執行伺服器後再執行測試，如果已在執行伺服器，請先將其停止。

執行測試：

% cd $APS_HOME
% maven runtest

在瀏覽器中開啟 ${APS_HOME}/test_results.html 檔案，並檢查結果。

可在此處找到執行 Quicklook 測試的詳細指示。

如果碰到問題，請記得參閱 GlassFish 建立常見問題集 wiki。

IDE 支援

使用 NetBeans 4.1 建立與開發 GlassFish。

如需附加資訊，請檢閱工作區指南與確定程序。此外，也可使用 FishEye 調查工作區中發生的變更。

建立適用於 V2.1、SGES21_FS_BRANCH 的 Glassfish：

以下是從 GlassFish 分支進行建立的步驟：
% mkdir workspace % cd workspace % cvs -d :pserver:<userid>@cvs.dev.java.net:/cvs checkout -r SGES21_FCS_BRANCH glassfish/bootstrap

因為 SGES21_FCS_BRANCH 分支中的 glassfish/bootstrap/project.properties 將變數「glassfish.cvstag」設為「glassfish.cvstag=SGES21_FCS_BRANCH」。FCS 分支來源將相應地簽出並建立。

如上所述定義兩個 glassfish 變數：glassfish.os.name、glassfish.cvs.username。

接著執行：
% cd glassfish/bootstrap % maven checkout bootstrap-all build configure-runtime

可仔細檢閱此處的詳細資訊，以判斷上述指令中的 bootstrap 與 bootstrap-all 之間所執行的目標。

GlassFish Maven 目標簡介：

目標名稱	常用指令	說明
bootstrap	maven -Dmodules=admin bootstrap checkout build	下載 glassfish-image-SNAPSHOT.jar 檔並將該檔解壓縮至 ${glassfish.home}(伺服器影像) 之下，以建立個別模組
bootstrap-all	maven checkout bootstrap-all build	安裝只包含二進位相依性的空白 glassfish 影像，然後下載各個二進位相依性並解壓縮至 ${glassfish.home} 中，再從來源建立所有模組。
checkout	maven checkout	簽出模組
build	maven build	建立模組
configure-runtime	maven configure-runtime	使用單一實例網域配置 ${glassfish.home}
configure-cluster	maven configure-cluster	使用 GlassFish V2 的叢集功能配置網域
clean	maven clean clobber	清除模組
clobber	maven clobber	清除 GlassFish 伺服器影像 - 刪除目錄 ${glassfish.home。必須與「bootstrap-all」搭配使用，以取得新影像來清除任何毀壞的伺服器影像。
clean-config	maven clean-config	清除伺服器。刪除 domain1 與 bin、config 中的記號替代檔案
-Dmodules=	maven -Dmodules=admin bootstrap checkout build	僅清除/簽出/建立部分模組：maven -Dmodules={以逗號分隔的清單} goal name