test

Sun Java System Application Server 9.1 管理指南

Application Server 指令

Application Server 的管理包含多項作業，如網域、叢集、節點代理程式和伺服器實例的建立、配置、控制和管理。本小節包含下列主題：

建立網域

您必須使用 create-domain 指令建立網域。以下範例指令將建立名為 mydomain 的網域。管理伺服器在連接埠 5000 上進行偵聽，管理使用者名稱為 admin。該指令提示您輸入管理密碼和主密碼。


$ asadmin create-domain --adminport 5000 --adminuser admin mydomain

若要為 mydomain 網域啟動管理主控台，請在瀏覽器中輸入以下 URL：


http://hostname:5000

在 Application Server 9.1 中，每個網域都具有一個相關聯的設定檔。如需有關設定檔的資訊，請參閱用法設定檔。您只能在建立期間選擇網域的設定檔。將 --profile 選項與 create-domain 指令搭配使用可指定網域的設定檔。若未使用 --profile 選項來明確指定設定檔，則預設的設定檔會與網域相關聯。asadminenv.conf 檔案中的 AS_ADMIN_PROFILE 變數，可定義預設的設定檔。

注意 – 注意 –

除非您具有 HADB 和 Network Security Services (NSS) 金鑰庫，否則請勿建立企業網域。除非您具有 HADB 和 NSS，否則將無法啟動企業網域。

對於前面的 create-domain 範例，網域的記錄檔、配置檔案和部署的應用程式現在常駐於以下目錄中：

domain-root-dir/mydomain

若要在其他位置建立網域目錄，請指定 --domaindir 選項。如需指令的完整語法，請鍵入 asadmin help create-domain 或 create-domain(1)。

刪除網域

使用 asadmin delete-domain 指令可刪除網域。僅具有網域管理權限的作業系統使用者 (或 root 使用者) 才能成功地執行該指令。例如，若要刪除名為 mydomain 的網域，請鍵入以下指令：


$ asadmin delete-domain mydomain

列出網域

使用 asadmin list-domains 指令可找到在機器中建立的網域。若要列出預設 domain-root-dir 目錄中的網域，請鍵入以下指令：


$ asadmin list-domains

若要列出在其他目錄中建立的網域，請指定 --domaindir 選項。

啟動網域

啟動網域時，將啟動管理伺服器和 Application Server 實例。啟動 Application Server 實例之後，Application Server 實例將持續執行、偵聽並接受請求。必須單獨啟動各個網域。

若要啟動網域，請鍵入 asadmin start-domain 指令並指定網域名稱。例如，若要啟動預設網域 (domain1)，請鍵入以下指令：


$ asadmin start-domain --user admin domain1

如果只有一個網域，則可以省略網域名稱。如需完整的指令語法，請鍵入 asadmin help start-domain。如果省略了密碼資料，系統將提示您提供此資料。

在 Windows 上啟動預設網域

在 Windows [開始] 功能表中，依次選取 [程式集] -> [Sun Microsystems] -> [Application Server] -> [啟動 Admin Server]。

停止網域

停止網域將關閉該網域的管理伺服器和 Application Server 實例。停止網域時，伺服器實例將停止接受新的連線，然後等待所有未完成的連線完成。由於伺服器實例必須完成其關閉程序，因此該程序需要幾秒鐘時間。停止網域時，管理主控台或大多數 asadmin 指令都無法使用。

若要停止網域，請鍵入 asadmin stop-domain 指令並指定網域名稱。例如，若要停止預設網域 (domain1)，請鍵入以下指令：


$ asadmin stop-domain domain1

如果只有一個網域，則網域名稱是選擇性的。如需完整語法，請鍵入 asadmin help stop-domain。

請參閱管理主控台線上說明，透過管理主控台停止網域。

在 Windows 上停止預設網域

在 [開始] 功能表中，依次選取 [程式集] -> [Sun Microsystems] -> [Application Server] -> [停止 Admin Server]。

重新啟動網域

重新啟動伺服器與重新啟動網域相同。若要重新啟動網域或伺服器，請停止然後再啟動網域。

建立叢集

叢集是使用 create-cluster 指令建立的。以下範例建立了一個名為 mycluster 的叢集。管理伺服器主機是 myhost，伺服器連接埠是 1234，而管理使用者名稱是 admin。該指令提示您輸入管理密碼。


$ asadmin create-cluster --host myhost --port 1234 --user admin mycluster

如需完整語法，請鍵入 asadmin help create-cluster。

啟動叢集

叢集是使用 start-cluster 指令啟動的。以下範例啟動了名為 mycluster 的叢集。該指令提示您輸入管理密碼。


$ asadmin start-cluster --host myhost --port 1234 --user admin mycluster

如需完整語法，請鍵入 asadmin help start-cluster。

停止叢集

叢集是使用 stop-cluster 指令停止的。以下範例停止了名為 mycluster 的叢集。該指令提示您輸入管理密碼。


$ asadmin stop-cluster --host myhost --port 1234 --user admin mycluster

myhost 是管理伺服器主機，1234 是管理連接埠，admin 則是管理使用者名稱。

如需完整語法，請鍵入 asadmin help stop-cluster。停止某叢集後，即會停止該叢集中的所有伺服器實例。沒有伺服器實例的叢集無法啟動。

建立節點代理程式

節點代理程式是使用 create-node-agent 指令建立的。以下範例將建立一個名為 mynodeagent 的節點代理程式。管理伺服器主機是 myhost，管理伺服器連接埠是 1234，而管理使用者名稱是 admin。此指令通常會提示您輸入管理密碼，但是，當未指定 --savemasterpassword 選項或此選項為 false 時，指令就不會提示您輸入管理密碼。


$ asadmin create-node-agent --host myhost --port 1234 --user admin mynodeagent

如需完整語法，請鍵入 asadmin help create-node-agent。

啟動節點代理程式

節點代理程式是透過使用 start-node-agent 指令並指定節點代理程式名稱啟動的。例如，若要啟動節點代理程式 mynodeagent，請鍵入下列指令：


$ asadmin start-node-agent --user admin mynodeagent

如需完整語法，請鍵入 asadmin help start-node-agent。

停止節點代理程式

節點代理程式是透過使用 stop-node-agent 指令並指定節點代理程式名稱停止的。例如，若要停止節點代理程式 mynodeagent，請鍵入下列指令：


$ asadmin stop-node-agent mynodeagent

如需完整語法，請鍵入 asadmin help stop-node-agent。

啟動實例

伺服器實例是使用 start-instance 指令啟動的。以下範例啟動了名為 myinstance 的伺服器實例。該指令提示您輸入管理密碼。


$ asadmin start-instance --host myhost --port 1234 --user admin myinstance

管理伺服器主機是 myhost，管理連接埠是 1234，而管理使用者名稱是 admin。伺服器實例 myinstance 可以加入叢集，也可以保持獨立。

如需完整語法，請鍵入 asadmin help start-instance。

停止實例

您必須使用 stop-instance 指令停止伺服器實例。以下範例停止了名為 myinstance 的伺服器實例。該指令提示您輸入管理密碼。


$ asadmin stop-instance --host myhost --port 1234 --user admin myinstance

管理伺服器主機是 myhost，管理連接埠是 1234，而管理使用者名稱是 admin。伺服器實例 myinstance 可以加入叢集，也可以保持獨立。

如需完整語法，請鍵入 asadmin help stop-instance。

重新啟動實例

若要重新啟動伺服器實例，請先停止然後再啟動實例。

重新建立網域管理伺服器

若要進行鏡像並提供網域管理伺服器 (DAS) 的工作副本，您必須具有：

備註 –

必須保留一份第一台機器上的 DAS 的備份。使用 asadmin backup-domain 來備份目前網域。

Procedure遷移 DAS

以下步驟用於將 Domain Administration Server 從第一台機器 (machine1) 遷移到第三台機器 (machine3)：

  1. 將 Application Server 安裝在第三台機器上，方法與在第一台機器上安裝時相同。

    為了可以在第三台機器上正確地復原 DAS 並且不會發生路徑衝突，您必須執行此操作。

    1. 使用指令行 (互動) 模式來安裝 Application Server 管理套裝軟體。若要啟動指令行互動式模式，請使用 console 選項呼叫安裝程式：


      ./bundle-filename -console

      若要使用指令行介面進行安裝，您必須具有 root 許可權。

    2. 若要安裝預設網域，請取消選取該選項。

      只有具有相同架構且安裝路徑完全相同 (即兩台機器使用相同的 as-install 和 domain-root-dir) 的兩台機器，才支援復原備份的網域。

  2. 將第一台機器上的備份 ZIP 檔案複製到第三台機器上的 domain-root-dir 目錄中。也可以透過 FTP 方式複製檔案。

  3. 執行 asadmin restore-domain 指令，以將 ZIP 檔案復原到第三台機器：


    asadmin restore-domain --filename domain-root-dir/sjsas_backup_v00001.zip domain1

    可以備份任何網域。但是，在重新建立網域時，網域名稱應與原始網域名稱相同。

  4. 變更第三台機器上的 domain-root-dir/domain1/generated/tmp 目錄的權限，以與第一台機器上相同目錄的權限相符。

    該目錄的預設許可權為：?drwx------? (或 700)。

    例如︰

    chmod 700 domain-root-dir /domain1/generated/tmp

    以上範例假定您備份的是 domain1。如果備份的是其他名稱的網域，則應使用要備份網域的名稱取代上述的 domain1。

  5. 變更第三台機器的 domain.xml 檔案中的主機特性值：

  6. 更新第三台機器上的 domain-root-dir/domain1/config/domain.xml。

    例如，搜尋 machine1 並將其替代為 machine3。這樣，您就可以將：

    <jmx-connector><property name=client-hostname value=machine1/>...

    變更為：

    <jmx-connector><property name=client-hostname value=machine3/>...

  7. 將：

    <jms-service... host=machine1.../>

    變更為：

    <jms-service... host=machine3.../>

  8. 在 machine3 上啟動復原的網域：


    asadmin start-domain --user admin-user --password admin-password domain1

  9. 在 machine2 上變更節點代理程式下的 DAS 主機特性值。

  10. 在 machine2 上變更 as-install/nodeagents/nodeagent/agent/config/das.properties 中的 agent.das.host 特性值。

  11. 在 machine2 上重新啟動節點代理程式。

    備註 –

    使用 asadmin start-instance 指令啟動叢集實例，以使這些實例與復原網域同步。