asadmin 公用程式

您可以使用 asadmin 公用程式來執行 Application Server 的所有管理作業。您可以使用此 asadmin 公用程式來取代管理員介面。

asadmin 公用程式可呼叫子指令，以便指定您想要執行的操作或作業。子指令是區分大小寫的。短選項引數具有一個破折號 (-)；而長選項引數具有兩個破折號 (--)。選項可控制公用程式如何執行子指令。選項也須區分大小寫。大部分選項都需要引數值，但布林值選項除外 (此類型選項可將功能 [開啟] 或 [關閉])。運算元會跟在引數值後面，且兩者中間以空格、定位字元 (Tab) 或雙破折號 (--) 分隔。asadmin 公用程式會將選項與選項值後面的任何項目視為運算元。

asadmin 可用在指令 shell 呼叫或多重指令模式 (也稱為 multimode) 中。在指令 shell 呼叫中，您必須從指令 shell 呼叫 asadmin 公用程式。asadmin 會執行指令，然後結束。在多重指令模式中，您只需要呼叫一次 asadmin，其隨後即可接受多個指令，直到您結束 asadmin 並返回一般指令 shell 呼叫。在多重指令模式中，您設定的環境變數會用於所有後續指令，直到您結束 multimode。您可以傳送檔案或標準輸入 (管道) 中事先準備好的指令清單，以提供指令。此外，您可以從多重模式階段作業呼叫 multimode；一旦結束第二個多重模式環境，就會返回原始的多重模式環境。

您也可以在互動式或非互動式選項中執行 asadmin 公用程式。依預設，已啟用互動式選項。它會提示您輸入必要的引數。您可以在任何情況下，在指令 shell 呼叫中使用互動式選項。當您從指令提示符號一次執行一個子指令，以及從檔案執行 multimode 時，可以在 multimode 中使用互動式選項。multimode 中的子指令 (經由輸入串流的管道)，以及從其他程式呼叫的子指令，都無法以互動式選項執行。

本機子指令可在沒有管理伺服器的情況下執行。然而，使用者必須登入至主控網域的機器，才能執行子指令並擁有該安裝與網域目錄的存取 (權限)。遠端子指令的執行方式永遠是先連線到管理伺服器，然後在該處執行子指令。這時一定要有執行中的管理伺服器。 所有遠端子指令都需要下列選項：

• -u -‐user 授權的網域 Application Server 管理使用者名稱。

• -‐passwordfile 包含下列格式的網域 Application Server 密碼的檔案：AS_ADMIN_PASSWORD=password。其中，password 是實際的管理員密碼。

• -H -‐host 正在執行網域 Application Server 的機器名稱。

• -p -‐port 正在偵聽管理請求的網域 Application Server 的連接埠號碼。Platform Edition 的預設連接埠號碼是 4848。

• -s -‐secure 若為 true，則使用 SSL/TLS 與網域 Application Server 進行通訊。

• -t -‐terse 表示所有輸出資料都必須簡潔，即通常不會使用容易理解的句子，而會優先使用格式完整的資料以供程序檔使用。預設是 false。

• -e -‐echo 將此選項設定為 true，則指令行敘述會回應在標準輸出上。預設是 false。

• -I -‐interactive 如果設定為 true (預設值)，則只會提示必要的密碼選項。

• -h -‐help 顯示指令的說明文字。

對於可在本機或遠端執行的子指令，若已在環境或指令行中設定 --host、--port、--user 和 --passwordfile 選項中的任何一個選項，則此子指令會以遠端模式執行。此外，對於可在本機或遠端執行的子指令，若將 --local 選項設定為 true，則將在本機執行子指令。此外，若在指令行或環境中未設定任何本機選項，則依預設該子指令會在本機執行。若將 --local 選項設定為 true，則會覆寫本機的 --host、--port、--user 和 --passwordfile 設定 (即使已指定)。子指令將在本機模式中執行。

可在本機執行的子指令將接受 --domain 選項來指定想要的網域，如果只有一個網域，則會假設該網域為預設網域。如果有多個網域，--domain 選項為必要的選項。對於可在本機或遠端執行的子指令，在指定 --host、--port、--user 及 --passwordfile 選項的情況下在遠端執行時，將忽略 --domain 選項。如果子指令將在遠端模式中執行，則忽略 --domain 選項。請注意，每個網域有一個管理實例，因此在具有多個網域的一部機器中，本機執行必須指定網域，遠端執行則必須為該網域的管理實例指定 --host、--port、--user 和 --passwordfile 選項。

為了安全性考量，您可以從檔案設定子指令的密碼，而不要在指令行輸入該密碼。--passwordfile 選項會使用包含密碼的檔案。此檔案的有效內容如下：

範例 C–1 密碼檔案內容

AS_ADMIN_PASSWORD=value
AS_ADMIN_ADMINPASSWORD=value
AS_ADMIN_USERPASSWORD=value
AS_ADMIN_MASTERPASSWORD=value

如果已將 AS_ADMIN_PASSWORD 匯出至全域環境，則指定 --passwordfile 選項將產生使用 --password 選項的相關警告。取消設定 AS_ADMIN_PASSWORD 可防止此情況的發生。您無法透過指令行或環境變數傳播主密碼，但可在 passwordfile 中指定。

若要使用 --secure 選項，則必須使用 set 指令，在 domain.xml 的 admin http-listener 中啟用安全性 --enabled 旗標。使用 asadmin 子指令來建立和/或刪除時，必須重新啟動伺服器，新建的指令才會生效。使用 start-domain 指令來重新啟動伺服器。

若要在 Solaris 平台上存取 Application Server 指令行介面子指令的線上手冊，請將 $AS_INSTALL/man 增加到您的 MANPATH 環境變數中。

您可以呼叫 --help 選項，以取得任何 asadmin 公用程式子指令的完整用法資訊。如果指定子指令，則會顯示該子指令的用法資訊。若使用不含子指令的 --help 選項，則會顯示所有可用子指令的清單。