Sun Java System Application Server 9.1 管理指南

附錄 C asadmin 公用程式

Application Server 包含一個名為 asadmin 的指令行管理公用程式。您可以使用 asadmin 公用程式來啟動與停止 Application Server、管理使用者、資源和應用程式。

本章包括下列小節:

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 中的子指令 (經由輸入串流的管道),以及從其他程式呼叫的子指令,都無法以互動式選項執行。

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

對於可在本機或遠端執行的子指令,若已在環境或指令行中設定 --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.xmladmin http-listener 中啟用安全性 --enabled 旗標。使用 asadmin 子指令來建立和/或刪除時,必須重新啟動伺服器,新建的指令才會生效。使用 start-domain 指令來重新啟動伺服器。

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

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

遠端指令的共用選項

所有遠端指令都需要以下共用選項:

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

選項 

定義 

--host

正在執行網域管理伺服器的機器名稱。預設值是 localhost。 

--port

用於進行管理的 HTTP/S 連接埠。您應將瀏覽器指向此連接埠,以便管理網域。例如,http://localhost:4848。Platform Edition 的預設連接埠號碼是 4848。

--user

授權的網域管理伺服器管理使用者名稱。若已使用 asadmin login 指令向網域認證,則針對此特定網域執行後續作業時,不需要指定 --user 選項。

--passwordfile

-‐passwordfile 選項指定包含特殊格式密碼項目的檔案名稱。密碼項目必須具有 AS_ADMIN_ 前綴,後面接著大寫字母的密碼名稱。

例如,若要指定網域管理伺服器密碼,請使用具有以下格式的項目:AS_ADMIN_PASSWORD=password,其中 password 是實際的管理員密碼。可指定的其他密碼包括 AS_ADMIN_MAPPEDPASSWORDAS_ADMIN_USERPASSWORDAS_ADMIN_ALIASPASSWORD

所有遠端指令都必須指定管理密碼以向網域管理伺服認證 (透過 -‐passwordfileasadmin login,或在指令提示符號以互動式方式完成)。asadmin login 指令只能用於指定管理密碼。對於必須為遠端指令指定的其他密碼,請使用 -‐passwordfile,或在指令提示符號輸入。

若已使用 asadmin login 指令向網域認證,則針對此特定網域執行後續作業時,不需要透過 -‐passwordfile 選項指定管理密碼。不過,這只適用於 AS_ADMIN_PASSWORD 選項。當個別指令 (例如,update-file-user) 要求您輸入密碼時,您仍需要提供其他密碼 (例如,AS_ADMIN_USERPASSWORD)。

為了安全性考量,asadmin 將不會讀取指定為環境變數的密碼。

--secure

若設定為 true,將使用 SSL/TLS 與網域管理伺服器通訊。 

--interactive

如果設定為 true (預設值),將只提示您輸入必需的密碼選項。 

--terse

表示任何輸出資料都必須簡潔,即通常不會使用人性化的句子,而會優先使用格式完整的資料以供程序檔使用。 預設是 false。 

--echo

將此選項設定為 true,則指令行敘述會回應在標準輸出上。預設是 false。 

--help

顯示指令的說明文字。 

Multimode 指令

您可以使用 multimode 指令來處理 asadmin 指令。指令行介面會提示您指定指令、執行該指令、顯示該指令的結果,然後提示您執行下一個指令。此外,在此模式中設定的所有 asadmin 選項名稱會用於所有後續指令。您可以設定環境並執行指令,直到鍵入「exit」或「quit」結束 multimode。您可以傳送檔案或標準輸入 (管道) 中事先準備好的指令清單,以提供指令。您可以從 multimode 階段作業呼叫 multimode;一旦結束第二個 multimode 環境,就會返回原始的 multimode 環境。

Get、Set 與 List 指令

asadmin getsetlist 指令共同為 Application Server 的抽象階層提供瀏覽機制。共有兩種階層:configurationmonitoring,且這些指令適用於兩者。list 指令提供管理元件 (具有唯讀或可修改的屬性) 之完全合格的帶點名稱。

configuration 階層提供可修改的屬性;而來自 monitoring 階層的管理元件只有唯讀屬性。configuration 階層並非嚴格基於網域的模式文件;而 monitoring 階層則稍有不同。

使用 list 指令以存取所要階層中的特定管理元件。接著,呼叫 getset 指令以取得管理元件屬性的名稱與值,或設定手邊管理元件屬性的值。使用萬用字元 (*) 選項可擷取符合指定之完全合格的帶點名稱的所有項目。請參閱範例,以進一步瞭解可能瀏覽的階層和管理元件。

Application Server 帶點名稱使用「.」(點號) 做為分隔完整名稱各部分的分隔符。這類似在 UNIX 檔案系統中使用「/」字元,來分隔檔案的絕對路徑名稱層級。建立 getsetlist 指令接受的帶點名稱時,適用以下規則。請注意,某些特定指令採用某些額外的語義。

list 指令是這三個指令的瀏覽能力基礎。若要使用 setget 來設定或取得特定 Application Server 子系統的屬性,必須先知道其帶點名稱。list 指令可引導您找到該子系統的帶點名稱。例如,若要在大型檔案系統 (開頭為 /) 中找出特定檔案的修改日期 (屬性),可以使用上述指令。首先,您必須找出該檔案在檔案系統中的位置,然後檢視其屬性。因此,可用來瞭解 appserver 中階層的前兩個指令是:* list "*" 和 <command>* list * -‐monitor。請參閱 getsetlist 指令線上手冊,以辨別這些指令的排序輸出。

伺服器生命週期指令

伺服器生命週期指令指的是可用來建立/刪除或啟動/停止網域或實例的指令。

表 C–2 伺服器生命週期指令

指令 

定義 

create-domain

建立網域的配置。網域是管理名稱空間。每個網域都具有其配置,它是儲存在一組檔案中。您可以在指定的 Application Server 安裝中建立任何數目的網域 (各自擁有不同的管理身份)。網域可獨立存在,不需依賴其他網域。使用者只要可存取指定系統上的 asadmin 程序檔,即可建立網域並將其配置儲存在所選的資料夾中。依預設,網域配置會建立在 install_dir/domains 目錄中。您可以置換此位置,以便將配置儲存在其他地方。。

delete-domain

刪除指定的網域。該網域必須已經存在,且已停止使用。 

start-domain

啟動網域。若未指定網域目錄,將啟動預設 install_dir/domains 目錄中的網域。若其中有兩個以上的網域,則必須指定 domain_name 運算元。

stop-domain

停止指定網域的 Domain Administration Server。 

restore-domain

從備份目錄復原網域下的檔案。 

list-domains

列出網域。若未指定網域目錄,會列出預設 install_dir/domains 目錄中的網域。若有一個以上的網域,則必須指定 domain_name 運算元。

backup-domain

備份指定網域下的檔案。 

login

可讓您登入網域。若已在不同的機器 (本機) 建立不同的 Application Server 網域,從這些機器中的任何一部呼叫 asadmin 即可管理位於其他地方 (遠端) 的網域。當您選擇特定機器做為管理用戶端,且要使用它來管理多個網域與伺服器時,這個方法非常有用。用來管理位於其他地方之網域的 asadmin 指令稱為遠端指令。asadmin login 指令可簡化管理此類遠端網域的作業。您只能以互動式模式執行 login 指令。它會提示您輸入管理使用者名稱與密碼。成功登入之後,會在該使用者的主目錄建立 .asadminpass 檔案。該檔案即為使用 -‐savelogin 選項時 create-domain 指令會修改的檔案。網域必須正在執行中,您才能執行此指令。

create-instance

建立本機或遠端機器上常駐的新伺服器實例。 

delete-instance

刪除伺服器實例。您可在遠端或本機上執行此指令。使用者需以管理伺服器的密碼進行認證。此外,實例必須已存在於管理伺服器所服務的網域中。請謹慎使用此指令,因為其具有破壞性且無法還原。 

List 與 Status 指令

list 與 status 指令可顯示已部署之元件的狀態。

表 C–3 List 與 Status 指令

指令 

定義 

show-component-status

取得已部署之元件的狀態。狀態是由伺服器傳回的字串表示。可能的狀態字串包含「status of app-name is enabled」或「status of app-name is disabled」。

list-components

列出所有已部署的 Java EE 5 元件。若未指定 -‐type 選項,將列出所有元件。

list-sub-components

列出已部署之模組或已部署之應用程式的模組中的 EJB 或 Servlet。若未指定模組,將列出所有模組。 

enable

啟用指定的元件。若指定的元件已啟用,將重新啟用該元件。元件必須先經部署後才能啟用。若尚未部署元件,將傳回錯誤訊息。 

disable

立即停用指定的元件。元件必須先經部署。若尚未部署元件,將傳回錯誤訊息。 

export

將變數名稱標記成要自動匯出至後續指令的環境。 除非取消設定所有後續指令或結束多重模式,否則所有後續指令都會使用指定的變數名稱值。 

get

取得屬性的名稱與值。 

set

設定一個或多個可配置屬性的值。 

list

列出可配置的元素。在 Solaris 上,執行使用 * 做為選項值或運算元的指令時,必須加上引號。

unset

移除針對 multimode 環境設定的一或多個變數。指定的變數與其關聯值將不再存在於環境中。 

部署指令

部署指令可部署應用程式或取得用戶端 stub。

表 C–4 部署指令

指令 

定義 

deploy

部署企業應用程式、Web 應用程式、EJB 模組、連接器模組或應用程式用戶端模組。若某個元件已部署或已存在,且 -‐force 選項已設定為 true,則會強制重新部署該元件。

deploydir

從開發目錄直接部署應用程式。部署目錄中必須有符合 Java EE 規格的適當目錄階層與部署描述元。 

get-client-stubs

從伺服器到本機目錄,取得 AppClient 獨立模組或包含 AppClient 模組之應用程式的用戶端 stub JAR 檔案。執行此指令之前,必須先部署該應用程式或模組。

版本指令

版本指令會傳回版本字串,並顯示所有 asadmin 指令的清單,還允許您安裝授權檔案。

表 C–5 版本指令

指令 

定義 

version

顯示版本資訊。若此指令無法使用指定的使用者/密碼和主機/連接埠與管理伺服器通訊,它將會擷取本機版本並顯示警告訊息。 

help

顯示所有 asadmin 公用程式指令的清單。指定特定指令可顯示關於該指令的用法資訊

install-license

防止未經授權即使用 Application Server。允許您安裝授權檔案。 

shutdown

以正常方式關閉管理伺服器與所有執行中的實例。若要重新啟動管理伺服器,必須以手動方式重新啟動。 

訊息佇列管理指令

您可以使用訊息佇列管理指令來管理 JMS 目標。

表 C–6 訊息佇列指令

指令 

定義 

create-jmsdest

建立 JMS 實體目標。除了實體目標之外,您也可以使用 create-jms-resource 指令來建立具有指定實體目標之 Name 特性的 JMS 目標資源。

delete-jmsdest

移除指定的 JMS 目標。 

flush-jmsdest

清除指定目標的 JMS 服務配置中,實體目標內的訊息。 

list-jmsdest

列出 JMS 實體目標。 

jms-ping

檢查 JMS 服務 (又稱為 JMS 提供者) 是否已啟動並正在執行。當您啟動 Application Server 時,預設會啟動 JMS 服務。此外,它只會使用 ping 指令偵測 JMS 服務中的預設 JMS 主機。若使用 ping 指令偵測不到內建的 JMS 服務,則會顯示錯誤訊息。 

資源管理指令

您可以使用資源指令來管理應用程式中使用的各種資源。

表 C–7 資源管理指令

指令 

定義 

create-jdbc-connection-pool

以指定的 JDBC 連線池名稱註冊新的 JDBC 連線池。 

delete-jdbc-connection-pool

刪除 JDBC 連線池。運算元可識別要刪除的 JDBC 連線池。 

list-jdbc-connection-pools

取得已建立的 JDBC 連線池。 

create-jdbc-resource

建立新的 JDBC 資源。 

delete-jdbc-resource

移除具有指定之 JNDI 名稱的 JDBC 資源。 

list-jdbc-resources

顯示已建立之 JDBC 資源的清單。 

create-jms-resource

建立 Java 訊息服務 (JMS) 連線工廠資源或 JMS 目標資源。 

delete-jms-resource

移除指定的 JMS 資源。 

list-jms-resources

列出現有 JMS 資源 (目標與連線工廠資源)。 

create-jndi-resource

註冊 JNDI 資源。 

delete-jndi-resource

移除具有指定之 JNDI 名稱的 JNDI 資源。 

list-jndi-resources

識別所有現有 JNDI 資源。 

list-jndi-entries

瀏覽並查詢 JNDI 樹狀結構。 

create-javamail-resource

建立 JavaMail 階段作業資源。 

delete-javamail-resource

移除指定的 JavaMail 階段作業資源。 

list-javamail-resources

列出現有 JavaMail 階段作業資源。 

create-persistence-resource

註冊持續性資源。 

delete-persistence-resource

移除持續性資源。當您刪除持續性資源時,此指令也會移除 JDBC 資源 (若該資源是使用 create-persistence-resource 指令所建立)。

list-persistence-resources

顯示所有持續性資源。 

create-custom-resource

建立自訂資源。自訂資源指定實作 javax.naming.spi.ObjectFactory 介面的自訂全伺服器資源物件工廠。

delete-custom-resource

移除自訂資源。 

list-custom-resources

列出自訂資源。 

create-connector-connection-pool

增加具有指定之連線池名稱的新連接器連線池。 

delete-connector-connection-pool

移除使用運算元 connector_connection_pool_name 指定的連接器連線池。

list-connector-connection-pools

列出已建立的連接器連線池。 

create-connector-resource

註冊具有指定之 JNDI 名稱的連接器資源。 

delete-connector-resource

移除具有指定之 JNDI 名稱的連接器資源。 

list-connector-resources

取得所有連接器資源。 

create-admin-object

建立具有指定之 JNDI 名稱的受管理物件。 

delete-admin-object

移除具有指定之 JNDI 名稱的受管理物件。 

list-admin-objects

列出所有受管理物件。 

create-resource-adapter-config

為連接器模組建立配置資訊。 

delete-resource-adapter-config

刪除為連接器模組在 domain.xml 中建立的配置資訊。

list-resource-adapter-configs

列出 domain.xml 中的連接器模組配置資訊

add-resources

在指定的 XML 檔案中建立指定資源。xml_file_path 是包含要建立之資源的 XML 檔案的路徑。DOCTYPE 應該指定為 resources.xml 檔案中的 install_dir/lib/dtds/sun-resources_1_2.dtd

ping-connection-pool

測試 JDBC 連線池與連接器連線池中的連線池是否可用。例如,若為稍後即將部署的應用程式建立新的 JDBC 連線池,部署該應用程式之前可使用此指令來測試該 JDBC 池。使用 ping 指令偵測連線池之前,您必須建立具有認證的連線池,並確定企業伺服器或資料庫已啟動。 

配置指令

配置指令可讓您建構 IIOP 偵聽程式、生命週期模組、HTTP 和 IIOP 偵聽程式、效能評測器及其他子系統。

本小節包含下列主題:

HTTP 和 IIOP 偵聽程式指令

HTTP 與 IIOP 偵聽程式指令可協助您管理偵聽程式。只有遠端模式支援這些指令。

表 C–8 IIOP 偵聽程式指令

指令 

定義 

create-http-listener

增加新的 HTTP 偵聽程式通訊端。 

delete-http-listener

移除指定的 HTTP 偵聽程式。 

list-http-listeners

列出現有 HTTP 偵聽程式。 

create-iiop-listener

建立 IIOP 偵聽程式。 

delete-iiop-listener

移除指定的 IIOP 偵聽程式。 

list-iiop-listeners

列出現有 IIOP 偵聽程式。 

生命週期與稽核模組指令

生命週期與稽核模組指令可協助您控制生命週期模組,與實作稽核功能的選擇性外掛程式模組。只有遠端模式支援這些指令。

表 C–9 生命週期模組指令

指令 

定義 

create-lifecycle-module

建立生命週期模組。生命週期模組提供的方式,能讓您在 Application Server 環境中執行短期或長期 Java 作業。 

delete-lifecycle-module

移除指定的生命週期模組。 

list-lifecycle-modules

列出現有生命週期模組。 

create-audit-module

為實作稽核功能的外掛程式模組增加指定的稽核模組。 

delete-audit-module

移除指定的稽核模組。 

list-audit-modules

列出所有稽核模組。 

效能評測器和 SSL 指令

效能評測器和 SSL 指令可讓您管理效能評測器和 SSL 用戶端配置。只有遠端模式支援這些指令。

表 C–10 效能評測器和 SSL 指令

指令 

定義 

create-profiler

建立效能評測器元素。伺服器實例會依據 Java 配置中的效能評測器元素,連接至特定的效能評測器。 變更效能評測器之後必須重新啟動伺服器。 

delete-profiler

刪除指定的效能評測器元素。伺服器實例會依據 Java 配置中的效能評測器元素連接至特定的效能評測器。變更效能評測器之後必須重新啟動伺服器。 

create-ssl

在選取的 HTTP 偵聽程式、IIOP 偵聽程式或 IIOP 服務中建立並配置 SSL 元素,以保護偵聽程式/服務上的通訊安全。 

delete-ssl

刪除選取的 HTTP 偵聽程式、IIOP 偵聽程式或 IIOP 服務中的 SSL 元素。 

JVM 選項和虛擬伺服器指令

您可以使用 JVM 選項和虛擬伺服器指令來控制這些元素。只有遠端模式支援這些指令。

表 C–11 JVM 選項和虛擬伺服器指令

指令 

定義 

create-jvm-option

在 Java 配置或 domain.xml 檔案的效能評測器元素中建立 JVM 選項。若為效能評測器建立了 JVM 選項,則會使用這些選項來記錄執行特定效能評測器所需的設定。您必須重新啟動伺服器,新建的 JVM 選項才會生效。

delete-jvm-option

移除 Java 配置或 domain.xml 檔案效能評測器元素中的 JVM 選項。

create-virtual-server

建立指定的虛擬伺服器。Application Server 中的虛擬功能可讓偵聽多個主機位址的單一 HTTP 伺服器程序服務多個 URL 網域。若兩部虛擬伺服器提供相同的應用程式,它們仍會共用相同的實體資源池。 

delete-virtual-server

移除具有指定之虛擬伺服器 ID 的虛擬伺服器。 

執行緒池和認證範圍指令

您可以使用執行緒池和認證範圍指令來控制這些元素。只有遠端模式支援這些指令。

表 C–12 執行緒池和認證範圍指令

指令 

定義 

create-threadpool

建立具有指定名稱的執行緒池。您可以指定池中執行緒的最大數目與最小數目、工作佇列數目,以及執行緒的閒置逾時。已建立的執行緒池可用於服務 IIOP 請求,並由資源配接卡用來服務工作管理請求。已建立的執行緒池可用於多個資源配接卡。 

delete-threadpool

移除具有指定之 ID 的執行緒池。 

list-threadpools

列出所有執行緒池。 

create-auth-realm

增加指定的認證範圍。 

delete-auth-realm

移除指定的認證範圍。 

作業事件和計時器指令

您可以使用作業事件和計時器指令來控制作業事件和計時器子系統,以及暫停任何執行中的作業事件。只有遠端模式支援這些指令。

表 C–13 作業事件指令

指令 

定義 

freeze-transaction

在所有執行中作業事件都已暫停的情況下,固定作業事件子系統。回復任何執行中的作業事件之前,請先呼叫此指令。針對任何已固定的作業事件子系統呼叫此指令沒有任何效用。 

unfreeze-transaction

繼續所有已暫停的執行中作業事件。在已固定的作業事件上呼叫此指令。 

recover-transactions

手動回復擱置的作業事件。 

rollback-transaction

回復指定的作業事件。 

unpublish-from-registry

 

list-timers

列出特定伺服器實例所擁有的計時器 

登錄指令

登錄指令讓您發佈或取消發佈 Web 服務工件。

表 C–14 作業事件指令

指令 

定義 

publish-to-registry

將 Web 服務工件發佈至登錄。 

unpublish-from-registry

從登錄取消發佈 Web 服務工件。 

list-registry-locations

 

使用者管理指令

您可以使用這些使用者指令來管理檔案範圍認證支援的使用者。只有遠端模式支援這些指令。

表 C–15 使用者管理指令

指令 

定義 

create-file-user

在金鑰檔案中建立具有指定使用者名稱、密碼和群組的項目。您可以建立多個群組,並使用冒號 (:) 加以分隔。

delete-file-user

在金鑰檔案中刪除具有指定使用者名稱的項目。 

update-file-user

使用指定的 user_nameuser_password 和群組,更新金鑰檔案中的現有項目。您可以輸入多個群組,並使用冒號 (:) 加以分隔。

list-file-users

建立檔案範圍認證支援的檔案使用者清單。 

list-file-groups

管理檔案範圍認證支援的檔案使用者與群組。此指令可列出檔案使用者中的可用群組。 

規則和監視指令

您可以使用規則和監視指令來管理規則和監視伺服器。只有遠端模式支援這些指令。

表 C–16 規則和監視指令

指令 

定義 

create-management-rule

建立新的管理規則,以透過智慧型的方式自我管理 Application Server 安裝與已部署的應用程式。 

delete-management-rule

移除指定的管理規則。 

create-transformation-rule

建立可套用至 Web 服務作業的 XSLT 變換規則。規則可套用到請求或回應。 

delete-transformation-rule

刪除指定之 Web 服務的 XSLT 變換規則。 

start-callflow-monitoring

從 Web 容器、EJB 容器與 JDBC 收集資料並建立資料關聯性,以提供完整的請求呼叫流程/路徑。只有當 callflow-monitoring 設定為 ON 時才會收集資料。

stop-callflow-monitoring

停止收集請求呼叫流程資訊。 

資料庫指令

您可以使用資料庫指令來啟動和停止 Java DB 資料庫 (基於 Apache Derby)。只有本機模式支援這些指令。

表 C–17 資料庫指令

指令 

定義 

start-database 

啟動 Application Server 隨附的 Java DB 伺服器。此指令只適用於已部署至 Application Server 的應用程式。 

stop-database 

停止 Java DB 伺服器的程序。Java DB 伺服器隨附於 Application Server。 

診斷與記錄指令

診斷與記錄指令可協助您疑難排解 Application Server 的問題。只有遠端模式支援這些指令。

表 C–18 診斷與記錄指令

指令 

定義 

generate-diagnostic-report

產生包含 Application Server 安裝詳細資訊 (例如,Application Server 實例的配置詳細資訊、記錄詳細資訊或程序專用資訊) 之指標或瀏覽連結的 HTML 報告。 

display-error-statistics

顯示自上次伺服器重新啟動後,server.log 中記錄的嚴重性與警告的摘要清單。

display-error-distribution

顯示實例 server.log 中整個模組的錯誤分佈狀況。

display-log-records

根據指定時間戳記顯示指定模組的所有錯誤訊息。 

Web 服務指令

您可以使用 Web 服務指令來監視已部署的 Web 服務並管理變換規則。

表 C–19 Web 服務指令

指令 

定義 

configure-webservice-management

配置已部署之 Web 服務的監視或 maxhistory 屬性。

create-transformation-rule

建立可套用至 Web 服務作業的 XSLT 變換規則。規則可套用到請求或回應。 

delete-transformation-rule

刪除指定之 Web 服務的 XSLT 變換規則。 

list-transformation-rules

列出指定之 Web 服務的所有變換規則 (按照規則的套用順序)。 

publish-to-registry

將 Web 服務工件發佈至登錄。 

unpublish-from-registry

從登錄取消發佈 Web 服務工件。 

list-registry-locations

顯示已配置之 Web 服務登錄存取點的清單。 

安全性服務指令

您可以使用這些安全指令來控制連接器連線池的安全對映。只有遠端模式支援這些指令。

表 C–20 安全指令

指令 

定義 

create-connector-security-map

建立指定之連接器連線池的安全對映。若該安全對映不存在,則會建立新的安全對映。此外,在基於容器管理式作業事件的方案中,您可以使用此指令將應用程式的呼叫者身份 (主體或使用者群組) 對映到適當的企業資訊系統 (EIS) 主體。一個或多個指定的安全對映可能會與連接器連線池關聯。連接器安全對映配置支援使用萬用字元星號 (*) 來表示所有使用者或所有使用者群組。為順利執行此指令,您必須先建立連接器連線池。EIS 是指控管組織資料的任何系統。它可以是主機、訊息傳送系統、資料庫系統或應用程式。

delete-connector-security-map

刪除指定之連接器連線池的安全對映。 

update-connector-security-map

修改指定之連接器連線池的安全對映。 

list-connector-security-map

列出屬於指定之連接器連線池的安全對映。 

create-message-security-provider

可供管理員為指定的訊息層 (domain.xmlmessage-security-config 元素,此檔案指定 Application Server 的參數與特性) 建立 provider-config 子元素。

delete-message-security-provide

可供管理員為指定的訊息層 (domain.xmlmessage-security-config 元素,此檔案指定 Application Server 的參數與特性) 刪除 provider-config 子元素。

list-message-security-providers

可供管理員列出指定之訊息層 (domain.xmlmessage-security-config 元素) 的所有安全訊息提供者 (provider-config 子元素)。

密碼指令

您可以使用密碼指令來管理密碼以確保 Application Server 的安全性。

表 C–21 密碼指令

指令 

定義 

create-password-alias

建立密碼的別名並將其儲存在 domain.xml 中。別名是格式為 ${ALIAS=password-alias-password} 的記號。別名名稱所對應的密碼是以已加密的格式儲存。此指令支援安全的互動式方式 (提示使用者輸入所有資訊),以及更適合用於程序檔的方式 (密碼會傳遞到指令行)。

delete-password-alias

刪除密碼別名。 

update-password-alias

更新指定之目標中的密碼別名 ID。 

list-password-aliases

列出所有密碼別名。 

change-admin-password

此遠端指令可修改管理密碼。此指令會以互動式方式執行,也就是會提示使用者輸入舊的管理密碼和新的管理密碼 (包含確認)。 

change-master-password

此本機指令可修改主密碼。此指令會以互動式方式執行,也就是會提示使用者輸入舊的主密碼與新的主密碼。除非伺服器已停止,否則此指令將無法運作。 

驗證指令

XML 檢驗器指令可驗證 domain.xml 檔案的內容。

表 C–22 驗證指令

指令 

定義 

verify-domain-xml

驗證 domain.xml 檔案的內容。

自訂 MBean 指令

您可以使用 MBean 指令來管理與註冊自訂 MBean。只有遠端模式支援這些指令。

表 C–23 自訂 MBean 指令

指令 

定義 

create-mbean

建立並註冊自訂 MBean。若目標 MBeanServer 並未執行,則不會註冊 MBean。

delete-mbean

刪除自訂 MBean。確定目標 MBeanServer 正在執行。

list-mbeans

列出指定之目標的自訂 MBean。 

服務指令

您可以使用服務指令來配置 Domain Administration Server (DAS) 的啟動。

表 C–24 服務指令

指令 

定義 

create-service

在自動啟動環境中配置 DAS 的啟動作業。在 Solaris 10 上,此指令會使用服務管理功能 (SMF)。這是本機指令,而且必須以具有超級使用者權限的作業系統層級使用者身份執行。只有 Solaris 10 才提供此指令。建立該服務之後,使用者必須啟動、啟用、停用、刪除或停止該服務。DAS 必須儲存在超級使用者可存取的資料夾中。您不能將該配置儲存在網路檔案系統上。該服務建立之後,即可由擁有 DAS 配置所在之資料夾的作業系統層級使用者控制。若要執行此指令,您必須具有 solaris.smf.* 授權。

特性指令

共用伺服器實例通常需要覆寫其參照配置中定義的屬性。您可透過名稱相同的系統特性,覆寫伺服器實例中的任何配置屬性。使用系統特性指令可管理這些共用的伺服器實例。

表 C–25 特性指令

指令 

定義 

create-system-property

針對網域、配置或伺服器實例,一次建立一個系統特性。 

delete-system-property

移除網域、配置或伺服器實例的一個系統特性。 

list-system-properties

顯示網域、配置或伺服器實例的系統特性。