GlassFish部署及應(yīng)用入門(mén)
Sun 啟動(dòng)了 GlassFish 項(xiàng)目 —— 開(kāi)發(fā)一個(gè)與 Java Platform, Enterprise Edition 5 (Java EE 5) 兼容的應(yīng)用服務(wù)器，并向 Java 社區(qū)公開(kāi)。此后，一個(gè)名為 GlassFish 社區(qū) 的活躍的開(kāi)發(fā)人員社區(qū)參與了此項(xiàng)目。他們努力的最初結(jié)果是 GlassFish v1（第一個(gè)開(kāi)源的、與 Java EE 5 兼容的應(yīng)用服務(wù)器），以及 Java EE 5. 的參考實(shí)現(xiàn)。另外，GlassFish 社區(qū)還發(fā)布了 Toplink Essentials，即 Java Persistence API 的參考實(shí)現(xiàn)。此社區(qū)還培養(yǎng)了許多不同的子項(xiàng)目，比如 Metro、jMaki、Open Message Queue (Open MQ)、Hudson 和 Grizzly。
GlassFish v1 的重點(diǎn)是開(kāi)發(fā)人員。目的是提供一個(gè)開(kāi)源并與 Java EE 5 完全兼容的應(yīng)用服務(wù)器，開(kāi)發(fā)人員可以使用此服務(wù)器部署并測(cè)試其 Java EE 5 應(yīng)用程序。遠(yuǎn)景是簡(jiǎn)單部署，也就是對(duì)單個(gè) GlassFish 實(shí)例的應(yīng)用程序部署。在 Common Development and Distribution License (CDDL) 下可用的 GlassFish v1 已經(jīng)非常流行，每年的下載量都超過(guò) 3 百萬(wàn)。它已被全世界采納并在多個(gè)發(fā)行版中可用，其中包括支持 Sun 的商業(yè)發(fā)行版 Sun Java System Application Server Platform Edition 9.0。
2007 年 9 月，GlassFish 社區(qū)發(fā)布 GlassFish v2，其中包括 GlassFish v1 的所有功能，并添加了其他功能，使得應(yīng)用服務(wù)器能夠接受重型生產(chǎn)環(huán)境的挑戰(zhàn)。本文概述了這些功能。
本指南將闡述啟動(dòng) GlassFish 服務(wù)器軟件，封裝和部署應(yīng)用程序的基本步驟。同時(shí)還包括 Admin Console 和命令行工作的相關(guān)信息。要使用此快速入門(mén)指南，您必須首先安裝 GlassFish 產(chǎn)品。有關(guān)下載及安裝說(shuō)明，請(qǐng)參見(jiàn) GlassFish 下載頁(yè)面。
此文檔包含以下幾個(gè)主題：
◆啟動(dòng)和驗(yàn)證服務(wù)器
◆封裝和部署應(yīng)用程序
◆使用命令行工具
有關(guān)此文檔所使用的規(guī)范信息，請(qǐng)參閱 文檔規(guī)范。
啟動(dòng)和驗(yàn)證服務(wù)器
本節(jié)提供的步驟適用于想啟動(dòng)和驗(yàn)證 GlassFish 服務(wù)器軟件的管理員：
◆啟動(dòng) GlassFish 服務(wù)器
◆確認(rèn)服務(wù)器正在運(yùn)行
◆使用 Autodeploy 部署 Hello 應(yīng)用程序
◆登錄 Admin Console
針對(duì)管理任務(wù)，GlassFish 服務(wù)器軟件提供了能管理服務(wù)器實(shí)例的工具：
◆Admin Console，基于瀏覽器的圖形用戶界面
◆asadmin 實(shí)用工具，命令行工具
默認(rèn)的管理值如下：
◆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
◆master.password=changeit (only in setup-cluster.xml)
在安裝時(shí)運(yùn)行 setup.xml 和 setup-cluster.xml 命令會(huì)用到這些值。在安裝過(guò)程中，如有端口沖突，請(qǐng)用適當(dāng)?shù)亩丝谥稻庉?setup.xml 和 setup-cluster.xml 文件，并重新運(yùn)行命令。
啟動(dòng) GlassFish 服務(wù)器
單一實(shí)例模式
使用 ant -f setup.xml 執(zhí)行安裝時(shí)，通過(guò)啟動(dòng)域，您也啟動(dòng)了該服務(wù)。域會(huì)對(duì)屬于它的服務(wù)實(shí)例提供授權(quán)和管理。啟動(dòng)域也就啟動(dòng)了該域中的服務(wù)。安裝 GlassFish 服務(wù)時(shí)將創(chuàng)建默認(rèn)的 domain1 域。
步驟
1.將 install-dir/bin/ 目錄添加到PATH 環(huán)境變量中。
2.鍵入以下命令啟動(dòng)服務(wù)器：asadmin start-domain domain1.
服務(wù)啟動(dòng)后會(huì)出現(xiàn)以下信息：Domain domain1 is ready to receive client requests. Additional services are being started in the background.
集群模式
GlassFish 支持集群模式的服務(wù)器實(shí)例，在集群中，每個(gè)實(shí)例的程序和配置均相同。與集群相關(guān)的術(shù)語(yǔ)，請(qǐng)參閱參閱 Cluster support in GlassFish V2。
使用 ant -f setup-cluster.xml 執(zhí)行安裝時(shí)，通過(guò)啟動(dòng)域，您也啟動(dòng)了該服務(wù)。啟動(dòng)域會(huì)啟動(dòng) DAS ，DAS 會(huì)依次啟動(dòng)該域中的實(shí)例，DAS是一個(gè)特殊委派的應(yīng)用服務(wù)實(shí)例，它會(huì)在所有管理任務(wù)中進(jìn)行協(xié)調(diào)。安裝 GlassFish 時(shí)將創(chuàng)建默認(rèn)的 domain1 域。
步驟
1.將 install-dir/bin/ 目錄添加到 PATH 環(huán)境變量中。
2.鍵入以下命令啟動(dòng)服務(wù)器：asadmin start-domain domain1.
提示鍵入管理用戶名和管理密碼時(shí)，輸入 setup-cluster.xml 中提供的用戶名和密碼。默認(rèn)的用戶名和密碼分別是： admin 和 adminadmin。服務(wù)啟動(dòng)后會(huì)出現(xiàn)以下信息：Domain domain1 started
3. 創(chuàng)建集群、節(jié)點(diǎn)代理，請(qǐng)遵循此 快速入門(mén)指南。
4. 在 GlassFish V2 上創(chuàng)建集群后，如何加載平衡的快速方法，請(qǐng)參閱 Configuring the Cluster/Load Balancer with GlassFish V2
確認(rèn)服務(wù)在運(yùn)行
◆要確認(rèn)該服務(wù)正在您的系統(tǒng)上運(yùn)行，請(qǐng)單擊此 URL：http://localhost:8080。
該 URL 包括兩部分：
o如果瀏覽器和 GlassFish 服務(wù)器運(yùn)行同相的系統(tǒng)上，則使用 localhost 。如果 GlassFish 服務(wù)器運(yùn)行在另一個(gè)系統(tǒng)上，則將 URL 中的系統(tǒng)名稱替換為localhost。
o默認(rèn)端口號(hào)是8080.如果在安裝過(guò)程中，修改了端口號(hào)，在瀏覽器地址欄里也應(yīng)作相應(yīng)替換。
你會(huì)看到服務(wù)歡迎頁(yè)面出現(xiàn)在下面。
該頁(yè)面可能需要幾分鐘才能顯示。
當(dāng)您看到這個(gè)頁(yè)面時(shí)，表明服務(wù)器正在運(yùn)行。如果服務(wù)器未運(yùn)行，但系統(tǒng)運(yùn)行正常，你會(huì)看到 server not found 錯(cuò)誤。（在某些瀏覽器中，該錯(cuò)誤會(huì)自動(dòng)運(yùn)行收索引擎。）
使用 Autodeploy 部署 Hello 應(yīng)用程序
預(yù)先封裝好的 Hello 程序，可以從 Java EE 5 教程上獲得，也可從 http://glassfish.dev.java.net/downloads/quickstart/hello.war. 上下載。Hello 程序包含在 Web ARchive 文件中。封裝好的程序可以是 Java™ ARchive 或者企業(yè)版 ARchive 文件。
拖拽或者復(fù)制 Hello 程序給域的 autodeploy 目錄，能讓你花費(fèi)最小的力氣立即運(yùn)行預(yù)先封裝好的程序。
步驟
1.從 http://glassfish.dev.java.net/downloads/quickstart/hello.war 下載 hello.war。
2.將 hello.war 復(fù)制到 install-dir/domains/domain1/autodeploy/。
提示 - 在 Windows 操作系統(tǒng)中，你可以在桌面上為 autodeploy 目錄創(chuàng)建一個(gè)快捷方式，然后將 hello.war 文件拖拽到快捷方式上。
當(dāng)系統(tǒng)完成應(yīng)用程序的部署時(shí)，會(huì)在 autodeploy 目錄下創(chuàng)建一個(gè) hello.war_deployed 文件。根據(jù)你的系統(tǒng)配置，此過(guò)程可能需要幾分鐘。當(dāng)你試圖訪問(wèn)程序頁(yè)面時(shí)，會(huì)出現(xiàn)錯(cuò)誤： 404-File Not Found
3.要訪問(wèn)應(yīng)用程序頁(yè)面，請(qǐng)?jiān)L問(wèn)此 URL：http://localhost:8080/hello.
應(yīng)用程序首頁(yè)會(huì)提示您鍵入名稱：
4.鍵入名稱并單擊提交。
應(yīng)用程序會(huì)顯示：Hello。
deploy。若要獲得等多信息，在命令提示后鍵入： asadmin deploy --help
登錄 Admin Console
Admin Console 是一個(gè)基于 Web 的界面，它能使各種管理和配置任務(wù)更加簡(jiǎn)單。通常用于：
◆部署和取消部署應(yīng)用程序
◆啟用和禁用應(yīng)用程序
◆確認(rèn)當(dāng)前正在運(yùn)行的應(yīng)用程序
◆配置 Java Database Connectivity (JDBC™) 資源和其他服務(wù)器設(shè)置
◆在日志文件中選擇和查看最近條目
有關(guān)使用 Admin Console 的更多信息，請(qǐng)獲取在線幫助文檔。
步驟
1.以單一實(shí)例模式訪問(wèn) http://localhost:4848/，并以集群模式訪問(wèn) https://localhost:4848
◆如果 GlassFish 服務(wù)器和瀏覽器運(yùn)行在相同的系統(tǒng)上，則使用 localhost。如果 GlassFish 服務(wù)器運(yùn)行在另一臺(tái)系統(tǒng)上，請(qǐng)?zhí)鎿Q URL 中的系統(tǒng)名稱。
◆4848 是 Admin Console 的默認(rèn)端口號(hào)。如果在安裝過(guò)程中修改了端口號(hào)，請(qǐng)使用修改后的端口號(hào)。
2.輸入用戶名和密碼。
默認(rèn)用戶名是 admin，默認(rèn)密碼是 adminadmin。
3.單擊登錄。
Admin Console 應(yīng)如下所示：
用服務(wù)器樹(shù)形結(jié)構(gòu)中的項(xiàng)目配置 GlassFish 服務(wù)器軟件的操作設(shè)置。通過(guò)右上角的按鈕，獲得在線幫助。
要查看服務(wù)器的日志文件，在右邊面板的普通任務(wù)標(biāo)題下單擊“搜索 Log 文件”，當(dāng) Log 檔查看窗口出現(xiàn)時(shí)，設(shè)定搜素規(guī)則，單擊搜索會(huì)顯示狀態(tài)信息，這些信息來(lái)自服務(wù)器和 JavaEE 程序的輸出。
啟動(dòng)綁定的 Derby 數(shù)據(jù)庫(kù)服務(wù)器
GlassFish 包括一個(gè)綁定的 Derby 數(shù)據(jù)庫(kù)服務(wù)器，可以用命令 asadmin start-database 啟動(dòng)它。過(guò)程如下：
步驟
1.確保使用數(shù)據(jù)庫(kù)用戶登錄。
2. 運(yùn)行 asadmin start-database.
有關(guān) start-database 命令的更多信息，請(qǐng)參閱該命令的幫助。
封裝和部署應(yīng)用程序
在部署應(yīng)用程序之前，確保將它們壓縮成 Java ARchive、Web ARchive 或者 Enterprise ARchive 文件。封裝的應(yīng)用 程序包含部署描述符，其中包含 GlassFish 加載程序所需要的信息，并建立了一個(gè) URL指向這些信息和其他需要的資源。這部分描述了如下的封裝和部署應(yīng)用程序的技術(shù)：
◆使用 NetBeans IDE 開(kāi)發(fā)和部署應(yīng)用程序
◆使用 asant 封裝 Hello 應(yīng)用程序
◆通過(guò) Admin Console 部署
◆通過(guò)部署描述符部署
有關(guān)更多信息，請(qǐng)參見(jiàn) The Java EE 5 Tutorial 的 "Getting Started With Web Applications" 部分。
使用 IDE 開(kāi)發(fā)和部署應(yīng)用程序
NetBeans™ IDE 是一個(gè)集成的開(kāi)發(fā)環(huán)境，你可以用它創(chuàng)建、封裝和部署復(fù)雜的 Java EE 程序。NetBeans 可以從 http://www.netbeans.org. 下載，NetBeans IDE 運(yùn)用集成了開(kāi)發(fā)環(huán)境和部署環(huán)境，并且能讓很多生成 Java EE 的步驟自動(dòng)化。一旦你用 NetBeans IDE 注冊(cè)了 GlassFish 服務(wù)，就可以很容易地封裝、修改和部署它們。
有關(guān) GlassFish 和 NetBeans IDE 的更多信息，請(qǐng)參見(jiàn)：https://glassfish.dev.java.net/public/netbeans/index.html.
流行的 Eclipse IDE 還可用于開(kāi)發(fā)和部署 GlassFish 上的 Java EE 程序。參考 https://glassfishplugins.dev.java.net/ 上的插件項(xiàng)目，可以提供 Eclipse version 3.1 的下載信息和 快速入門(mén)指南。
使用 asant 封裝 Hello 應(yīng)用程序
如果程序沒(méi)有用類似 NetBeans IDE 的工具封裝，可以用該產(chǎn)品的附帶工具 asant 該工具能使重復(fù)性的部署任務(wù)自動(dòng)化，它也是一個(gè)可以初始化 GlassFish 服務(wù)環(huán)境和條用 akarta Ant 工具的 shell 腳本。 有關(guān) asant 工具的信息，請(qǐng)參見(jiàn)： Sun Java System Application Server Platform Edition 9 Reference Manual and Chapter 3, "The asant Utility," in Sun Java System Application Server Platform Edition 9.0 Developer's Guide.
該部分包括封裝應(yīng)用程序的組件到另一個(gè) WAR 文件。 包含 Hello 程序的build.xml 文件包含了創(chuàng)建目標(biāo)。
步驟
1.如果你已經(jīng)把 install-dir/bin 加到了 PATH 環(huán)境變量中，你現(xiàn)在就可以這樣做。
2.進(jìn)入存放 Hello 應(yīng)用程序的目錄。
3.鍵入 asant war.
此命令將匯編應(yīng)用程序的 WAR 文件。
通過(guò) Admin Console 部署
封裝 Hello 程序之后，下面將部署它。以下部分討論用 Admin Console 部署應(yīng)用程序，你也可以使用 asant。
步驟
1.以單一實(shí)例模式單擊 http://localhost:4848/asadmin，并以集群模式單擊 https://localhost:4848/asadmin
◆如果 GlassFish 服務(wù)器和瀏覽器運(yùn)行在相同的系統(tǒng)上，則使用 localhost。如果 GlassFish 服務(wù)器運(yùn)行在另一臺(tái)系統(tǒng)上，請(qǐng)?zhí)鎿Q URL 中的系統(tǒng)名稱。
◆4848 是 Admin Console 的默認(rèn)端口號(hào)。如果在安裝過(guò)程中修改了端口號(hào)，請(qǐng)使用修改后的端口號(hào)。
2.輸入管理用戶名和密碼。
3. 在左側(cè)窗格中，單擊 Application 節(jié)點(diǎn)并展開(kāi)它。
4.單擊 Web Applications。
5.如果您已經(jīng)部署了 Hello 程序，選擇靠近它的復(fù)選框并單擊 Undeploy。
6.要部署最近匯編的 Hello 應(yīng)用程序，請(qǐng)單擊 Web Applications 頁(yè)上的 Deploy。
7.選擇 Package file to upload to the Application Server 選項(xiàng)并單擊 Browse。
8.導(dǎo)航到存放 Hello 應(yīng)用程序的目錄并選擇 hello.war。
9.單擊 Next。
10.在 Deploy Web Module 頁(yè)面上，單擊 OK。
應(yīng)用程序?qū)⒊霈F(xiàn)在 Web Applications 列表中
要驗(yàn)證應(yīng)用程序已正確部署，請(qǐng)單擊 Launch。
通過(guò)部署目錄部署
如果合適的目錄層次結(jié)構(gòu)和部署配置已經(jīng)建立，你就可以從發(fā)展目錄部署程序。由于對(duì)于簡(jiǎn)單的程序這個(gè)過(guò)程是復(fù)雜的，因此只最推薦高級(jí)用戶和簡(jiǎn)單程序使用。但是一旦這樣做是可行時(shí)，直接從目錄部署可以加速開(kāi)發(fā)循環(huán)。
這個(gè)過(guò)程可以用 Admin Console 和或則命令行和腳本里的 asadmin deploydir 執(zhí)行。由于大多數(shù)的開(kāi)發(fā)者想在命令腳本里自動(dòng)化這些步驟，現(xiàn)將使用命令行的步驟呈現(xiàn)于此，
注意 - 在 Windows 中使用 asadmin 之前，請(qǐng)參閱 To Configure the Windows Environment to Use the Command-Line Tools。
步驟
1.在存放 Hello 應(yīng)用程序的目錄中，創(chuàng)建一個(gè)名稱為 hello2/ 的新目錄。
2.將 hello.war 文件的內(nèi)容解壓到 hello2/ 目錄。
當(dāng)你解壓 hello.war時(shí)，維持目錄結(jié)構(gòu)不變。它也是你需要直接從目錄部署的這類文件的一個(gè)模板。
3.如果你已經(jīng)部署了 Hello 程序，在命令行中用 asadmin undeploy hello 封裝它。
4.使用以下命令部署應(yīng)用程序：
asadmin deploydir hello-download-dir/hello2
注意 - 指定 hello2/ 目錄的完整路徑。
如果你沒(méi)有安裝帶有"Don't prompt"的 GlassFish 服務(wù)，請(qǐng)指定 --user username, 選項(xiàng)， username 是管理者的名字。你可能會(huì)提示輸入密碼。
會(huì)出現(xiàn)下面的信息： Command deploydir executed successfully.
5.驗(yàn)證應(yīng)用程序正在運(yùn)行，請(qǐng)?jiān)L問(wèn) URL：http://localhost:8080/hello。
使用命令行工具
除了 Admin Console 外，GlassFish 服務(wù)器軟件還提供了各種各樣的命令行工具來(lái)執(zhí)行管理功能。這部分解釋命令行工具。
要運(yùn)行工具，請(qǐng)?jiān)诿畲翱谥休斎朊蠲Ｏ卤淼牡谝涣惺敲畹拿郑诙惺窍嚓P(guān)的描述。
使用命令行工具配置 Windows 環(huán)境
步驟
1.在瀏覽器窗口或桌面右擊我的電腦。
2.選擇屬性顯示系統(tǒng)屬性對(duì)話框。
3.單擊高級(jí)選項(xiàng)卡。
4.單擊環(huán)境標(biāo)簽。
在用戶標(biāo)簽部分，添加或修改 PATH 變量。
如果 PATH 變量存在：
1.單擊編輯。
2. 在變量值中，輸入路徑給 bin 目錄，要區(qū)別于其他的輸入，可以使用分號(hào)間隔。例如：
如果PATH變量不存在 ：
1.單擊新建。
2.在變量名中輸入 PATH。
3.在變量值中，輸入服務(wù)器的 bin 目錄：
6.
在用戶選項(xiàng)卡部分，添加環(huán)境變量AS_ADMIN_USER 并且把它設(shè)置成你在安裝中用的管理者名字。
如果你設(shè)定了這個(gè)變量，你在運(yùn)行 the administrative user name when you run asadmin 命令時(shí)，不需要輸入管理者名.
7.
單擊 OK 提交并關(guān)閉剩余的窗口。
【編輯推薦】
