Sun Java logo     上一頁      下一頁     

Sun logo
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 的安裝目錄位於︰

  • Solaris Sun Java™ Enterprise System 安裝︰
    /opt/SUNWappserver/appserver
  • Linux Java Enterprise System 安裝︰
    /opt/sun/appserver/
  • Solaris 和 Linux 獨立的 Application Server 安裝,非超級使用者:
    user_home_directory/SUNWappserver
  • Solaris 和 Linux 獨立的 Application Server 安裝,超級使用者:
    /opt/SUNWappserver

 

domain_root_dir

依預設,包含所有網域的目錄位於︰

  • Solaris Java Enterprise System 安裝︰
    /var/opt/SUNWappserver/domains/
  • Linux Java Enterprise System 安裝︰
    /var/opt/sun/appserver/domains/
  • 所有其他安裝︰
    install_dir/domains/

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

本主題是三個基本主題中的第一個,為您提供以下步驟:

啟動管理伺服器

若要啟動管理伺服器,請按照下面的程序執行。

  1. install_dir/bin/ 目錄增加至 PATH 環境變數中:

         C Shell:
           setenv PATH install_dir/bin:$PATH

        
     Bourne Shell:
           PATH=install_dir/bin:$PATH
           export PATH
  2. 設定管理使用者環境變數,您即可不需為每個指令鍵入該變數:

         C Shell:
           setenv AS_ADMIN_USER admin_user

        
     Bourne Shell:
           AS_ADMIN_USER=admin_user
           export AS_ADMIN_USER
  3. 透過在 install_dir 中輸入以下指令啟動伺服器:
  4. asadmin start-domain domain1

    當提示您輸入管理密碼和主密碼時,請輸入您在安裝期間提供的密碼。

  5. 螢幕會顯示訊息告知您 Domain Administration Server 正在啟動:
    Starting Domain domain1, please wait.Log redirected to domain_dir/domain1/logs/server.log...
  6. 啟動程序完成後,您會看到一條附加訊息:
    Domain domain1 started

  7. 備註

    此指南可指導您為管理使用者名稱設定環境變數 AS_ADMIN_USER,因此,在使用 asadmin 指令時,此指南不提供使用者名稱引數。您可以在鍵入指令時提供此引數。例如︰

    asadmin command_verb --user username command_arguments


登入 Admin Console

Admin Console 是一種瀏覽器介面,可簡化各種管理和配置工作。Admin Console 通常用於:

如需有關使用 Admin Console 的更多資訊,請查閱線上說明或「Sun Java System Application Server Enterprise Edition 8.1 2005Q1 管理指南」。

若要登入 Admin Console,請:

  1. 在瀏覽器中鍵入以下 URL:
  2. 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 的自行簽署憑證。


  3. 當顯示登入視窗時,請輸入管理使用者名稱和密碼。
  4. 按一下 [登入]。
  5. 當顯示 [Admin Console] 時,其外觀如下所示:


    Admin Console 在頁面上有大標題窗格,左窗格中為常用工作樹,右窗格中為歡迎內容和常用工作和文件的連結。

在左窗格中,您可以從提供的樹中選取您要管理的內容。在右窗格中,[常用工作] 標題下面列示了各種管理作業。


秘訣

如果您尚未註冊軟體,請按一下 [註冊] 標籤以註冊您的軟體。


檢查記錄檔

Application Server 實例和 Domain Admin Server 產生有關檔案系統的帶註解記錄。依預設,將記錄所有的錯誤、警告或有用的資訊訊息。若要查看管理伺服器記錄檔,請:

  1. 從右窗格的 [常用工作] 清單中按一下 [搜尋日誌檔],以為記錄檢視器啟動新的瀏覽器視窗。

  2. 記錄檢視器提供檢視、搜尋和過濾選項。

  3. 在 [日誌檢視器] 視窗中,從 [實例名稱] 下拉式清單中選取伺服器,然後按一下
    [搜尋]。即可顯示 Domain Administration Server 的最新記錄檔項目。
  4. 掃描訊息並尋找所有表明在伺服器啟動期間遇到問題的 WARNINGSEVERE 訊息。
  5. 您可以隨時關閉記錄檢視器。建立叢集並部署應用程式之後,如果任何作業失敗,則應檢查記錄檔。記錄檢視器可用於檢視網域中所有執行中 Application 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 的預設節點代理程式。

若要啟動預設節點代理程式,請:

  1. 在終端機視窗中,鍵入以下指令:
  2. asadmin start-node-agent hostname

    使用執行 Application Server 的主機的名稱替代變數 hostname

  3. 當提示您輸入主密碼時,請提供主密碼。
  4. 節點代理程式會啟動並與 Domain Administration Server 建立連線。如果 Domain Admin Server 未執行,節點代理程式則可能無法啟動。

定義叢集

叢集是一組共用相同配置、資源和應用程式的伺服器實例 (通常在多台主機上)。叢集可透過防故障備用促進伺服器實例間的負載平衡與高可用性。你可以跨多台機器建立叢集,並在每台機器上節點代理程式程序的協助下對其進行管理。在本指南中,為簡單起見,我們的範例叢集將位於一台主機上,該主機即為執行 Domain Administration Server 的主機。

如前面小節所述,您必定已經啟動了每台主機上的節點代理程式程序。在叢集建立期間指定實例時,您必須將實例與您要執行實例之機器上的執行中節點代理程式相關聯。在網域中所建立的叢集中,節點代理程式和實例名稱必須是唯一的。

若要建立叢集,請:

  1. 如果您尚未登入 Administration Console,請登入 https://localhost:4849 處的 Administration Console。
  2. 使用執行 Domain Admin Server 之系統的名稱替換 localhost 變數。

    4849 為 Admin Console 的預設連接埠號。如果您在安裝期間已變更連接埠號,請使用該號碼替代預設連接埠號。

  3. 在右窗格的 [常用工作] 下,按一下 [建立新的叢集] 以顯示 [建立叢集] 輸入頁面。
  4. 鍵入 FirstCluster 做為新叢集的名稱。
  5. 從可用的配置範本的下拉式清單中,選取 default-config 配置並選擇 [複製選取的配置]。
  6. 按兩下 [加入] 按鈕建立兩個項目,以便為叢集指定兩個實例。
  7. 鍵入叢集名稱 i1i2。節點代理程式名稱會自動加入本地機器的名稱。
  8. 您將看到類似下圖的螢幕:


    [建立叢集] 頁面,顯示叢集名稱、配置以及要建立的伺服器實例。

  9. 按一下 [確定]。建立過程可能需要幾分鐘時間。

  10. 備註

    此操作需要自動為 HTTP、HTTPS、IIOP 和 IIOPS 指定連接埠號。如果需要,以後您可以對其進行變更。


    建立過程完成後,會顯示 [已成功建立叢集] 頁面,[FirstCluster] 將會出現在左窗格的樹中。系統為此叢集製作了配置範本 default-config 的副本,並為該範本指定了名稱 FirstCluster-config

  11. 在左窗格中展開 [叢集],然後按一下 [FirstCluster],以顯示叢集的 [一般資訊] 頁面。
  12. 按一下 [實例] 標籤,以顯示您建立的實例 i1 和 i2。
    1. 按一下 [i1],以檢查此實例。
    2. 在右窗格 [一般資訊] 標頭上的標籤中,按一下 [特性],然後查看 HTTP_LISTENER_PORT 的值。
    3. 對 i2 重複這些步驟。

    4. 備註

      依預設,i1 的 HTTP 連接埠為 38081,i2 的 HTTP 連接埠為 38080。如果建立這些叢集時,您機器上的這些連接埠已被佔用,或者已將這些連接埠指定給了其他實例和叢集,則會指定其他連接埠號。


在本節中,您已在一台機器上建立了一個簡單的叢集。您也可以使用相同的基本步驟跨多個機器建立叢集 (只要您安裝了該軟體且每台機器上的節點代理程式均在執行)。

如果您不想繼續,可以在此處停止參閱快速入門。


部署應用程式

本節是三個基本主題中的第三個,為您提供以下步驟:

部署應用程式範例

本指南使用 clusterjsp 應用程式範例來說明 Web 路徑負載平衡功能。

  1. 如果您尚未位於 [常用工作] 頁面,請按一下 [首頁] 按鈕,以移至該頁面。
  2. 在右窗格的 [常用工作] 下,按一下 [部署企業應用程式]。
  3. 在 [要上傳的檔案] 文字方塊中,按一下 [瀏覽],並導覽至 install_dir/samples/ee-samples/highavailability/apps/clusterjsp/clusterjsp.ear
  4. 按 [下一步],以顯示 [部署企業應用程式] 頁面。
  5. 向下捲動至該頁面的 [目標] 區段。
  6. 從 [可用項目] 清單中選取 [FirstCluster],然後按一下 [增加],以將其移至 [選取] 清單。
  7. 按一下 [確定]。
  8. clusterjsp 應用程式現在已部署至 FirstCluster。

    此螢幕確認 clusterjsp 應用程式現在已部署至 FirstCluster。


    具有 clusterjsp 且已部署的企業應用程式清單

驗證叢集應用程式

在此步驟中啟動叢集並檢查應用程式是否在兩個實例上均可存取。

若要啟動叢集,請:

  1. 在左窗格的樹中,按一下 [叢集] 下的 [FirstCluster] 節點。
  2. 在右窗格中,如果 [一般] 標籤尚未在使用中,請按一下 [一般] 標籤。
  3. 按一下 [啟動實例] 按鈕,以啟動叢集。
  4. 透過檢查 [狀況] 欄位是否變更為指出哪些實例在執行,來驗證叢集是否已啟動。

若要存取每個實例上的應用程式,請:

  1. 在瀏覽器中鍵入以下 URL:
  2. http://localhost:port/clusterjsp

    使用執行 Domain Admin Server 之系統的名稱替換 localhost 變數。

    使用 i1 的 HTTP-LISTENER-PORT 的值替代 port 變數。此範例使用 http://localhost:38081/clusterjsp

  3. 增加一些階段作業屬性資料。
  4. 檢查顯示的階段作業和主機資訊。例如︰
    • 從伺服器執行:localhost
    • 伺服器連接埠號:38081
    • 執行的伺服器的 IP 位址:192.18.145.133
    • 建立的階段作業:Day Mon 05 14:55:34 PDT 2005
  5. 增加一些階段作業資料,然後按一下 [增加至階段作業] 按鈕。
  6. 透過在瀏覽器中鍵入以下 URL,對實例 i2 重複此步驟:
  7. 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 軟體:

  1. 啟動 Java Enterprise System 安裝程式。
  2. 在 [元件選取] 頁面中,選取 Sun Java System Web Server 元件。
  3. 在安裝期間,選擇 [立即配置] 以提示您配置 Web Server。
  4. 當出現提示時,請定義一個預設 Web Server 實例。

  5. 秘訣

    請記住您為此 Web Server 實例選擇的連接埠號。本指南假定連接埠 38000 已選取為預設實例的 HTTP 連接埠。


如果您使用的是獨立的 Sun Java System Application Server,或者您沒有對 Sun Java Enterprise System 安裝程式的存取權限,則請執行以下步驟來安裝 Web Server 軟體︰

  1. 請移至 http://www.sun.com/downloads。向下捲動至 [Web Server 與代理伺服器] 標題,然後按一下 [Web Server]。
  2. 下載適用於您選擇的語言環境和平台的 Web Server 6.1 Service Pack 2 或更高版本。
  3. 若要下載,您必須使用透過 MySunSM、Sun StoreSM、SunSolveSM 或線上支援中心註冊的使用者名稱和密碼登入。如果您沒有登入帳號,可以在線上註冊。

  4. 遵循說明安裝 Web Server 軟體。您必須︰
    1. 從壓縮的歸檔檔案中擷取該軟體。
    2. 執行安裝程式。如果您需要其他資訊,請參閱 http://docs.sun.com/doc/819-0131-10 上的 Web Server 安裝說明。
  5. Web Server 安裝程序為 Web Server 配置管理伺服器,還提示您定義預設 Web Server 實例。

  6. 秘訣

    請記住您為此 Web Server 實例選擇的連接埠號。本指南假定連接埠 38000 已選取為預設實例的 HTTP 連接埠。


安裝負載平衡外掛程式

若要安裝負載平衡外掛程式,請︰

  1. 執行您使用的發行軟體 (Sun Java Enterprise System 軟體或獨立的 Sun Java System Application Server 軟體) 的安裝程式。
  2. 當詢問要安裝的元件時,請選取 [負載平衡外掛程式]。
  3. 在 Sun Java Enterprise System 安裝程式上,您必須展開 Application Server 項目才能看到負載平衡外掛程式。依預設,其未被選取以進行安裝。

建立負載平衡程式配置

現在返回至與 Application Server 的 Domain Admin Server 互動的操作。此節中您將需要 shell 執行環境。

  1. 建立名為 MyLbConfig 的負載平衡程式配置,其目標為叢集 FirstCluster:
  2. asadmin create-http-lb-config --target FirstCluster MyLbConfig

  3. 為 HTTP 負載平衡啟用 FirstCluster 叢集及已部署在該叢集中的 clusterjsp 應用程式:
  4. asadmin enable-http-lb-server FirstCluster

    asadmin enable-http-lb-application --name clusterjsp FirstCluster

  5. 為負載平衡程式建立運作狀態檢查程式。該運作狀態檢查程式用於在出現故障的實例回復時發出訊號。
  6. asadmin create-http-health-checker --interval 10 --config MyLbConfig FirstCluster

    其中,interval 是指運作狀態檢查程式在檢查異常實例之前等待的秒數。

  7. 將配置匯出至檔案 loadbalancer.xml
  8. asadmin export-http-lb-config --config MyLbConfig loadbalancer.xml

  9. loadbalancer.xml 複製到 web_server_install_dir/https-hostname/config/loadbalancer.xml

啟動負載平衡程式

如果用做負載平衡程式的 Web Server 實例尚未執行,請透過執行以下指令來啟動 Web Server 軟體:

如果用做負載平衡程式的 Web Server 實例尚未執行,請透過執行以下指令來重新啟動 Web Server 軟體:

驗證負載平衡

  1. 若要顯示 clusterjsp 應用程式的首頁,請在瀏覽器中鍵入以下 URL:
  2. http://localhost:web_server_port/clusterjsp

    使用執行 Web Server 之系統的名稱替換 localhost 變數。

    使用 web_server_install_dir/https-hostname/config/server.xml 中的 LS 元素之連接埠屬性值替換 web_server_port 變數。在此範例中使用連接埠 38000。

    螢幕會顯示一個類似您在「驗證叢集應用程式」一節看到的頁面。

  3. 檢查顯示的階段作業和主機資訊。例如︰
    • 從伺服器執行:localhost
    • 伺服器連接埠號:38000
    • 執行的伺服器的 IP 位址:192.18.145.133
    • 建立的階段作業:Day Mon 05 14:55:34 PDT 2005
  4. 伺服器連接埠號為 38000,是 Web Server 的連接埠。負載平衡程式已在叢集中的兩個實例上轉寄了請求。
  5. 使用其他瀏覽器軟體或其他機器上的瀏覽器,建立新的階段作業。相同瀏覽器的請求為「居留式」,並移至同一實例。
  6. 這些階段作業應該分配給叢集中的兩個實例。您可以查看伺服器存取記錄檔來進行驗證,其位於︰

    • 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
  7. 增加名稱與值對 (Name=Name Value=Duke),以便儲存在 HttpSession 中。
  8. 按一下 [增加至階段作業資料] 按鈕。
  9. 驗證是否已增加階段作業資料

在本節中,您已建立了用做負載平衡程式的實例,並設置了負載平衡配置。還驗證了負載平衡。

若要配置與驗證 HTTP 階段作業防故障備用,請繼續設置高可用性防故障備用


清除

若要清除,您可以透過完成選擇 1:解除安裝您安裝的產品中的步驟解除安裝 Application Server,或者您可以透過完成選擇 2:移除範例叢集中的步驟簡單地刪除範例叢集。


注意

如果您計劃完成「關於高可用性叢集和 HADB」小節,請勿現在清除安裝。而是開始「關於高可用性叢集和 HADB」小節,並在完成後,按照該小節中說明的程序進行清除。


選擇 1:解除安裝您安裝的產品

若要完全解除安裝,請:

  1. 使用以下指令停止 Application Server 程序:
  2. asadmin stop-cluster FirstCluster

    asadmin stop-node-agent hostname

    asadmin stop-domain domain1

    此時,所有與 Application Server 相關的程序均已停止。

  3. 解除安裝 Application Server。
  4. 在 Java Enterprise System 安裝中,請執行 var/sadm/prod/entsys/uninstall,然後執行解除安裝精靈中的步驟。

    在獨立的 Application Server 安裝中,請執行 install_dir/uninstall,然後執行解除安裝精靈中的步驟。

  5. 如果您為本練習安裝了 Web Server,請停止用做負載平衡程式的 Web Server 實例,然後解除安裝 Web Server 產品。您可以按如下方式停止實例:
  6. web_server_install_dir/https-hostname/stop

  7. 如果您要解除安裝 Web Server 產品,請從 web_server_install_dir 執行解除安裝程式。

選擇 2:移除範例叢集

若僅要移除本練習中使用的 FirstCluster (高度可用的範例叢集) 和應用程式範例,請:

  1. 停止 Application Server 程序並清除配置:
  2. 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

  3. 停止用做負載平衡程式的 Web Server 實例:
  4. web_server_install_dir/https-hostname/stop

  5. web_server_install_dir/https-hostname/config 中的 loadbalancer.xml 檔案重新命名為 loadbalancer.xml.sav

恭喜!您現在已完成了 Application Server 的快速入門。


其他可用資源

另提供了有關瞭解和使用 Application Server 的其他資源,包括:



上一頁      下一頁     


文件號碼 819-1257。   Copyright 2004-2005 Sun Microsystems, Inc. 版權所有。