Sun Java System Application Server Enterprise Edition 8.2 管理指南

`asadmin` 指令用法

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

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

範例 19–1 語法範例

asadmin command [-short_option] [short_option_argument]* [--long_option [long_option_argument]* [operand]*

asadmin create-profiler -u admin --passwordfile password.txt myprofiler

若要在 Solaris 平台上存取 Application Server asadmin 公用程式指令的線上手冊，請將 $AS_INSTALL/man 增加到您的 MANPATH 環境變數中。

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

範例 19–2 help 指令範例

asadmin --help 可顯示一般說明

asadmin command --help 可顯示指定之指令的說明。

本小節包含下列主題：

多重模式與互動式模式

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

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

本機指令

本機指令可在沒有管理伺服器的情況下執行。然而，使用者必須登入至託管網域的機器，才能執行指令並擁有該安裝與網域目錄的存取 (權限)。

對於可在本機或遠端執行的指令，若已在環境或指令行中設定 --host、--port、--user 與 --passwordfile 選項中的任何一個選項，則該指令會以遠端模式執行。此外，若未在指令行或環境中設定任何本機選項，則該指令預設會在本機執行。

遠端指令

遠端指令的執行方式永遠是先連線到管理伺服器，然後在該處執行指令。這時一定要有執行中的管理伺服器。所有遠端指令都需要以下共用選項：

表 19–1 遠端指令必需的選項


短選項	選項	定義
`-H`	`--host`	正在執行網域管理伺服器的機器名稱。預設值是 localhost。
`-p`	`--port`	用於進行管理的 HTTP/S 連接埠。您應將瀏覽器指向此連接埠，以便管理網域。例如，`http://localhost:4848`。Platform Edition 的預設連接埠號是 4848。
`-u`	`--user`	授權的網域管理伺服器管理使用者名稱。若已使用 `asadmin login` 指令向網域認證，則針對此特定網域執行後續作業時，不需要指定 `--user` 選項。
	`--passwordfile`	`-‐passwordfile` 選項指定包含特殊格式密碼項目的檔案名稱。密碼項目必須具有 `AS_ADMIN_` 前綴，後面接著大寫字母的密碼名稱。例如，若要指定網域管理伺服器密碼，請使用具有以下格式的項目：`AS_ADMIN_PASSWORD`=`password`，其中 `password` 是實際的管理員密碼。可指定的其他密碼包含 `AS_ADMIN_PASSWORD`、`AS_ADMIN_USERPASSWORD` 與 `AS_ADMIN_ALIASPASSWORD`、`AS_ADMIN_MAPPEDPASSWORD`。所有遠端指令都必須指定管理密碼以向網域管理伺服認證 (透過 `-‐passwordfile` 或 `asadmin login`，或在指令提示符號以互動式方式完成)。`asadmin login` 指令只能用於指定管理密碼。對於必須為遠端指令指定的其他密碼，請使用 `-‐passwordfile`，或在指令提示符號輸入。若已使用 `asadmin login` 指令向網域認證，則針對此特定網域執行後續作業時，不需要透過 `-‐passwordfile` 選項指定管理密碼。不過，這只適用於 `AS_ADMIN_PASSWORD` 選項。當個別指令 (例如，`update-file-user`) 要求您輸入密碼時，您仍需要提供其他密碼 (例如，`AS_ADMIN_USERPASSWORD`)。為了安全性考量，`asadmin` 將不會讀取指定為環境變數的密碼。
`-s`	`--secure`	若設定為 true，將使用 SSL/TLS 與網域管理伺服器通訊。
`-I`	`--interactive`	若設定為 true (預設)，將只提示您輸入必需的密碼與使用者選項。
`-t`	`--terse`	表示任何輸出資料都必須簡潔，即通常不會使用人性化的句子，而會優先使用格式完整的資料以供程序檔使用。預設是 false。
`-e`	`--echo`	將此選項設定為 true，則指令行敘述會回應在標準輸出上。預設是 false。
`-h`	`--help`	顯示指令的說明文字。

密碼檔案

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

範例 19–3 密碼檔案內容

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

asadmin 指令用法