![]() | |
Sun Java System Application Server Enterprise Edition 8.1 2005Q1 |
快速入門指南
歡迎使用「Sun Java System Application Server Enterprise Edition 8.1 2005Q1 快速入門指南」。本指南適用於有興趣瞭解 Sun Java System Application Server Enterprise Edition 8.1 2005Q1 軟體功能的開發人員、系統管理員以及 Application Server 管理員。
如需此文件的最新版本,請參閱 docs.sun.com 上的線上版本,其位於:
http://docs.sun.com/app/docs/prod/sjs.asse
本指南說明了使用 Application Server 的基本步驟和進階步驟。這些步驟以您應遵照完成的順序列出。完成基本步驟需要的時間通常不超過 45 分鐘,基本步驟詳如以下各節所述:
完成進階步驟的通常需要約 45 分鐘的時間,進階步驟在以下各節中使用:
本指南最後幾節包含有關「清除」的說明和「其他可用資源」的資訊。
下表說明本指南中所使用的目錄之變數名稱和預設路徑。變數名稱位於第一欄,預設路徑位於第二欄。
變數名稱
說明與路徑
install_dir
依預設,Application Server 的安裝目錄位於︰
domain_root_dir
依預設,包含所有網域的目錄位於︰
domain_dir
依預設,網域目錄位於︰
domain_root_dir/domain_dir
關於 Application Server 的管理為使管理員能夠管理在多個主機上執行的伺服器實例和叢集,Application Server 提供以下工具:
這些工具連線至名為 Domain Administration Server 的伺服器,該伺服器是一個為協調所有管理作業而特別指定的 Application Server 實例。無論使用何種介面,Domain Administration Server 均提供用於驗證和執行管理指令的單一安全介面。
網域是配置資料、部署的應用程式以及具有指定管理員之機器的集合。網域定義描述並控制了數個可能分布於多台機器上的應用程式、獨立 Application Server 實例和叢集的作業。如果安裝了 Domain Administration Server,則一定會安裝名為 domain1 的預設網域。在本指南中,您將使用該預設網域。
若要完成本指南中所述的大多數步驟,您將使用 Admin Console。
啟動 Domain Administration Server本主題是三個基本主題中的第一個,為您提供以下步驟:
啟動管理伺服器
若要啟動管理伺服器,請按照下面的程序執行。
- 將 install_dir/bin/ 目錄增加至 PATH 環境變數中:
C Shell:
setenv PATH install_dir/bin:$PATH
Bourne Shell:
PATH=install_dir/bin:$PATH
export PATH- 設定管理使用者環境變數,您即可不需為每個指令鍵入該變數:
C Shell:
setenv AS_ADMIN_USER admin_user
Bourne Shell:
AS_ADMIN_USER=admin_user
export AS_ADMIN_USER- 透過在 install_dir 中輸入以下指令啟動伺服器:
asadmin start-domain domain1
當提示您輸入管理密碼和主密碼時,請輸入您在安裝期間提供的密碼。
- 螢幕會顯示訊息告知您 Domain Administration Server 正在啟動:
Starting Domain domain1, please wait.Log redirected to domain_dir/domain1/logs/server.log...- 啟動程序完成後,您會看到一條附加訊息:
Domain domain1 started
登入 Admin Console
Admin Console 是一種瀏覽器介面,可簡化各種管理和配置工作。Admin Console 通常用於:
如需有關使用 Admin Console 的更多資訊,請查閱線上說明或「Sun Java System Application Server Enterprise Edition 8.1 2005Q1 管理指南」。
若要登入 Admin Console,請:
- 在瀏覽器中鍵入以下 URL:
https://localhost:4849/asadmin
由於 Admin Console 是一種安全的 Web 應用程式,因此您必須使用 https 而不是 http。
使用執行 Domain Admin Server 之系統的名稱替換 localhost 變數。
4849 為 Admin Console 的預設連接埠號。如果您在安裝期間已變更連接埠號,請使用該號碼替代預設連接埠號。
備註
如果快顯式視窗中顯示諸如 Website Certified by an Unknown Authority 的訊息,請按一下 [確定]。
顯示此訊息是因為,您的瀏覽器無法識別 Domain Administration Server 透過安全傳輸協定用於服務 Admin Console 的自行簽署憑證。
- 當顯示登入視窗時,請輸入管理使用者名稱和密碼。
- 按一下 [登入]。
當顯示 [Admin Console] 時,其外觀如下所示:
在左窗格中,您可以從提供的樹中選取您要管理的內容。在右窗格中,[常用工作] 標題下面列示了各種管理作業。
檢查記錄檔
Application Server 實例和 Domain Admin Server 產生有關檔案系統的帶註解記錄。依預設,將記錄所有的錯誤、警告或有用的資訊訊息。若要查看管理伺服器記錄檔,請:
如需有關記錄檔的更多資訊,請參閱「Sun Java System Application Server Enterprise Edition 8.1 2005Q1 管理指南」。
在本節中,您已啟動 Domain Administration Server,並確認其在執行。您還登入了 Admin Console 並使用了記錄檢視器。如果您不想繼續,可以在此處停止參閱快速入門。
建立叢集本節是三個基本主題中的第二個,解釋如何建立包含兩個 Application Server 實例的叢集。為簡單起見,叢集完全在一台機器中執行。本主題提供以下步驟:
啟動節點代理程式
節點代理程式是在每台參與 Application Server 管理網域的機器上執行的輕型程序。節點代理程式負責啟動和停止主機上的伺服器實例。它還與 Domain Administration Server 協同工作建立新的 Application Server 實例。
對於機器所屬的每個 Application Server 管理網域,每台機器需要一個節點代理程式。如果您在安裝時選擇了節點代理程式元件,則會建立名為 hostname 的預設節點代理程式。
若要啟動預設節點代理程式,請:
定義叢集
叢集是一組共用相同配置、資源和應用程式的伺服器實例 (通常在多台主機上)。叢集可透過防故障備用促進伺服器實例間的負載平衡與高可用性。你可以跨多台機器建立叢集,並在每台機器上節點代理程式程序的協助下對其進行管理。在本指南中,為簡單起見,我們的範例叢集將位於一台主機上,該主機即為執行 Domain Administration Server 的主機。
如前面小節所述,您必定已經啟動了每台主機上的節點代理程式程序。在叢集建立期間指定實例時,您必須將實例與您要執行實例之機器上的執行中節點代理程式相關聯。在網域中所建立的叢集中,節點代理程式和實例名稱必須是唯一的。
若要建立叢集,請:
- 如果您尚未登入 Administration Console,請登入 https://localhost:4849 處的 Administration Console。
使用執行 Domain Admin Server 之系統的名稱替換 localhost 變數。
4849 為 Admin Console 的預設連接埠號。如果您在安裝期間已變更連接埠號,請使用該號碼替代預設連接埠號。
- 在右窗格的 [常用工作] 下,按一下 [建立新的叢集] 以顯示 [建立叢集] 輸入頁面。
- 鍵入 FirstCluster 做為新叢集的名稱。
- 從可用的配置範本的下拉式清單中,選取 default-config 配置並選擇 [複製選取的配置]。
- 按兩下 [加入] 按鈕建立兩個項目,以便為叢集指定兩個實例。
- 鍵入叢集名稱 i1 和 i2。節點代理程式名稱會自動加入本地機器的名稱。
您將看到類似下圖的螢幕:
- 按一下 [確定]。建立過程可能需要幾分鐘時間。
建立過程完成後,會顯示 [已成功建立叢集] 頁面,[FirstCluster] 將會出現在左窗格的樹中。系統為此叢集製作了配置範本 default-config 的副本,並為該範本指定了名稱 FirstCluster-config。
- 在左窗格中展開 [叢集],然後按一下 [FirstCluster],以顯示叢集的 [一般資訊] 頁面。
- 按一下 [實例] 標籤,以顯示您建立的實例 i1 和 i2。
在本節中,您已在一台機器上建立了一個簡單的叢集。您也可以使用相同的基本步驟跨多個機器建立叢集 (只要您安裝了該軟體且每台機器上的節點代理程式均在執行)。
如果您不想繼續,可以在此處停止參閱快速入門。
部署應用程式本節是三個基本主題中的第三個,為您提供以下步驟:
部署應用程式範例
本指南使用 clusterjsp 應用程式範例來說明 Web 路徑負載平衡功能。
- 如果您尚未位於 [常用工作] 頁面,請按一下 [首頁] 按鈕,以移至該頁面。
- 在右窗格的 [常用工作] 下,按一下 [部署企業應用程式]。
- 在 [要上傳的檔案] 文字方塊中,按一下 [瀏覽],並導覽至 install_dir/samples/ee-samples/highavailability/apps/clusterjsp/clusterjsp.ear。
- 按 [下一步],以顯示 [部署企業應用程式] 頁面。
- 向下捲動至該頁面的 [目標] 區段。
- 從 [可用項目] 清單中選取 [FirstCluster],然後按一下 [增加],以將其移至 [選取] 清單。
- 按一下 [確定]。
clusterjsp 應用程式現在已部署至 FirstCluster。
此螢幕確認 clusterjsp 應用程式現在已部署至 FirstCluster。
驗證叢集應用程式
在此步驟中啟動叢集並檢查應用程式是否在兩個實例上均可存取。
若要啟動叢集,請:
若要存取每個實例上的應用程式,請:
- 在瀏覽器中鍵入以下 URL:
http://localhost:port/clusterjsp
使用執行 Domain Admin Server 之系統的名稱替換 localhost 變數。
使用 i1 的 HTTP-LISTENER-PORT 的值替代 port 變數。此範例使用 http://localhost:38081/clusterjsp。
- 增加一些階段作業屬性資料。
- 檢查顯示的階段作業和主機資訊。例如︰
- 增加一些階段作業資料,然後按一下 [增加至階段作業] 按鈕。
- 透過在瀏覽器中鍵入以下 URL,對實例 i2 重複此步驟:
http://localhost:38080/clusterjsp
在本節中,您已將應用程式部署至叢集,並測試了應用程式在叢集的所有實例上均可用。
恭喜!您已完成了本「快速入門指南」中的基本步驟。如果您不想繼續進行進階步驟,可以在此處停止參閱快速入門。
設置負載平衡一般在部署叢集之前部署負載平衡程式。負載平衡程式:
Application Server 包含常見的 Web 伺服器 (如 Apache 和 Sun Java System Web Server) 的負載平衡外掛程式。
本節提供有關如何下載和設置 Sun Java System Web Server 軟體以充當 Application Server 叢集的負載平衡程式的說明。若要完成本節所述操作,您必須擁有足夠的記憶體,以在系統上執行 Web Server、Domain Administration Server 以及您在本指南中到目前為止建立的兩個 Application Server 實例。建議使用具有 512 MB 至 1024 MB 記憶體的系統,以便完成本節所述操作。
本主題提供以下步驟:
安裝 Web Server 軟體
如果您已安裝 Web Server 軟體,並且可以識別用做負載平衡程式的 Web Server 實例,則請記錄此實例在檔案系統中的位置,然後跳至安裝負載平衡外掛程式。
如果您使用的是 Sun Java Enterprise System 軟體,則當您選擇安裝負載平衡外掛程式時,將自動選取 Web Server 以進行安裝。但是,您也可以執行以下步驟來安裝 Web Server 軟體:
如果您使用的是獨立的 Sun Java System Application Server,或者您沒有對 Sun Java Enterprise System 安裝程式的存取權限,則請執行以下步驟來安裝 Web Server 軟體︰
- 請移至 http://www.sun.com/downloads。向下捲動至 [Web Server 與代理伺服器] 標題,然後按一下 [Web Server]。
- 下載適用於您選擇的語言環境和平台的 Web Server 6.1 Service Pack 2 或更高版本。
若要下載,您必須使用透過 MySunSM、Sun StoreSM、SunSolveSM 或線上支援中心註冊的使用者名稱和密碼登入。如果您沒有登入帳號,可以在線上註冊。
- 遵循說明安裝 Web Server 軟體。您必須︰
- 從壓縮的歸檔檔案中擷取該軟體。
- 執行安裝程式。如果您需要其他資訊,請參閱 http://docs.sun.com/doc/819-0131-10 上的 Web Server 安裝說明。
- Web Server 安裝程序為 Web Server 配置管理伺服器,還提示您定義預設 Web Server 實例。
安裝負載平衡外掛程式
若要安裝負載平衡外掛程式,請︰
建立負載平衡程式配置
現在返回至與 Application Server 的 Domain Admin Server 互動的操作。此節中您將需要 shell 執行環境。
- 建立名為 MyLbConfig 的負載平衡程式配置,其目標為叢集 FirstCluster:
asadmin create-http-lb-config --target FirstCluster MyLbConfig
- 為 HTTP 負載平衡啟用 FirstCluster 叢集及已部署在該叢集中的 clusterjsp 應用程式:
asadmin enable-http-lb-server FirstCluster
asadmin enable-http-lb-application --name clusterjsp FirstCluster
- 為負載平衡程式建立運作狀態檢查程式。該運作狀態檢查程式用於在出現故障的實例回復時發出訊號。
asadmin create-http-health-checker --interval 10 --config MyLbConfig FirstCluster
其中,interval 是指運作狀態檢查程式在檢查異常實例之前等待的秒數。
- 將配置匯出至檔案 loadbalancer.xml
asadmin export-http-lb-config --config MyLbConfig loadbalancer.xml
- 將 loadbalancer.xml 複製到 web_server_install_dir/https-hostname/config/loadbalancer.xml 中
啟動負載平衡程式
如果用做負載平衡程式的 Web Server 實例尚未執行,請透過執行以下指令來啟動 Web Server 軟體:
如果用做負載平衡程式的 Web Server 實例尚未執行,請透過執行以下指令來重新啟動 Web Server 軟體:
驗證負載平衡
- 若要顯示 clusterjsp 應用程式的首頁,請在瀏覽器中鍵入以下 URL:
http://localhost:web_server_port/clusterjsp
使用執行 Web Server 之系統的名稱替換 localhost 變數。
使用 web_server_install_dir/https-hostname/config/server.xml 中的 LS 元素之連接埠屬性值替換 web_server_port 變數。在此範例中使用連接埠 38000。
螢幕會顯示一個類似您在「驗證叢集應用程式」一節看到的頁面。
- 檢查顯示的階段作業和主機資訊。例如︰
- 伺服器連接埠號為 38000,是 Web Server 的連接埠。負載平衡程式已在叢集中的兩個實例上轉寄了請求。
- 使用其他瀏覽器軟體或其他機器上的瀏覽器,建立新的階段作業。相同瀏覽器的請求為「居留式」,並移至同一實例。
這些階段作業應該分配給叢集中的兩個實例。您可以查看伺服器存取記錄檔來進行驗證,其位於︰
- Solaris Java Enterprise System 安裝︰
/var/opt/SUNWappserver/nodeagents/nodeagent_name/i1/logs/access/server_access_log
/var/opt/SUNWappserver/nodeagents/nodeagent_name/i2/logs/access/server_access_log- Linux Java Enterprise System 安裝︰
/var/opt/sun/appserver/nodeagents/nodeagent_name/i1/logs/access/server_access_log
/var/opt/sun/appserver/nodeagents/nodeagent_name/i2/logs/access/server_access_log- 獨立的 Application Server 安裝:
install_dir/nodeagents/nodeagent_name/i1/logs/access/server_access_log
install_dir/nodeagents/nodeagent_name/i2/logs/access/server_access_log- 增加名稱與值對 (Name=Name Value=Duke),以便儲存在 HttpSession 中。
- 按一下 [增加至階段作業資料] 按鈕。
- 驗證是否已增加階段作業資料
在本節中,您已建立了用做負載平衡程式的實例,並設置了負載平衡配置。還驗證了負載平衡。
若要配置與驗證 HTTP 階段作業防故障備用,請繼續設置高可用性防故障備用。
清除若要清除,您可以透過完成選擇 1:解除安裝您安裝的產品中的步驟解除安裝 Application Server,或者您可以透過完成選擇 2:移除範例叢集中的步驟簡單地刪除範例叢集。
注意 如果您計劃完成「關於高可用性叢集和 HADB」小節,請勿現在清除安裝。而是開始「關於高可用性叢集和 HADB」小節,並在完成後,按照該小節中說明的程序進行清除。
選擇 1:解除安裝您安裝的產品
若要完全解除安裝,請:
- 使用以下指令停止 Application Server 程序:
asadmin stop-cluster FirstCluster
asadmin stop-node-agent hostname
asadmin stop-domain domain1
此時,所有與 Application Server 相關的程序均已停止。
- 解除安裝 Application Server。
在 Java Enterprise System 安裝中,請執行 var/sadm/prod/entsys/uninstall,然後執行解除安裝精靈中的步驟。
在獨立的 Application Server 安裝中,請執行 install_dir/uninstall,然後執行解除安裝精靈中的步驟。
- 如果您為本練習安裝了 Web Server,請停止用做負載平衡程式的 Web Server 實例,然後解除安裝 Web Server 產品。您可以按如下方式停止實例:
web_server_install_dir/https-hostname/stop
- 如果您要解除安裝 Web Server 產品,請從 web_server_install_dir 執行解除安裝程式。
選擇 2:移除範例叢集
若僅要移除本練習中使用的 FirstCluster (高度可用的範例叢集) 和應用程式範例,請:
- 停止 Application Server 程序並清除配置:
asadmin stop-cluster FirstCluster
asadmin disable-http-lb-server FirstCluster
asadmin delete-http-lb-ref --config MyLbConfig FirstCluster
asadmin delete-http-lb-config MyLbConfig
asadmin delete-instance i1
asadmin delete-instance i2
asadmin delete-cluster FirstCluster
asadmin undeploy clusterjsp
- 停止用做負載平衡程式的 Web Server 實例:
web_server_install_dir/https-hostname/stop
- 將 web_server_install_dir/https-hostname/config 中的 loadbalancer.xml 檔案重新命名為 loadbalancer.xml.sav
恭喜!您現在已完成了 Application Server 的快速入門。
其他可用資源另提供了有關瞭解和使用 Application Server 的其他資源,包括: