您可以使用 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 選項會使用包含密碼的檔案。此檔案的有效內容如下:
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 選項,則會顯示所有可用子指令的清單。