附錄 A
使用指令行介面

本附錄提供在系統提示的單模式下 (即，每次從指令提示下運行一個指令)、多重模式下 (即，可以運行多個指令，而無需重新輸入環境層級資訊)、程序檔與程式中，使用指令行介面 (asadmin 公用程式) 的說明。您可以使用指令行介面代替管理介面螢幕。

本附錄包含下列小節：

關於指令行介面
使用 asadmin
安全性考量
並行存取考量
指令參考

---

關於指令行介面

本章節包含下列主題：

關於 asadmin 公用程式
關於 Ant 工作
關於其他指令行公用程式

關於 asadmin 公用程式

asadmin 公用程式執行所有的配置與管理工作。您可以使用此公用程式代替使用管理介面。

關於 Ant 工作

許多開發人員使用 Ant 來加速 J2EE 應用程式的開發程序。Ant 程序檔會協助 asadmin 公用程式執行某些工作。開發人員可以使用 Ant 工作建立應用程式，部署與取消部署模組與應用程式，並控制 Sun ONE Application Server。

如需關於 Ant 工作的更多資訊，請參閱「Sun ONE Application Server Developer's Guide」。

如需關於 Ant 的更多資訊，請參閱 Jakarta Project 站點 (位於 http://jakarta.apache.org/ant/)。

關於其他指令行公用程式

Sun ONE Application Server 包含其他指令行公用程式。下表列示這些公用程式，並對每個公用程式進行簡要說明。

表格 A-1 其他指令行公用程式

公用程式	定義
appclient	會啟動應用程式用戶端容器，並且呼叫在應用程式 Jar 檔案中封裝的用戶端應用程式。
capture-schema	取得資料庫綱目與對映資訊。
flexanlg	產生關於伺服器的統計資料。
htpasswd	建立使用者認證檔案。
package-appclient	包裝應用程式用戶端容器程式庫與 jar 檔案。如需更多資訊，請參閱「Sun ONE Application Server Developer's Guide to Clients」。
verifier	使用 DTD 驗證 J2EE 部署描述元。如需更多資訊，請參閱「Sun ONE Application Server Developer's Guide」。
wscompile	採用服務定義介面，並且產生用戶端存根或伺服器端骨架，或為提供的介面產生 WSDL 集。
wsdeploy	產生可部署的 WAR 檔案。

如需關於這些公用程式的更多資訊，請參閱其線上輔助說明。

---

使用 asadmin

asadmin 公用程式具有執行管理工作的指令集。您可以將這些指令用於可透過管理介面執行的大多數工作。可以在 install_dir/bin 中找到 asadmin 公用程式，並從那裡執行它。在 Windows 中，按兩下 asadmin.bat 檔案，然後 asadmin 公用程式會在指令視窗中啟動，在多重模式下執行。

請注意，某些 HTTP 伺服器相關的特性與管理伺服器特性不能使用指令行設定，而必須使用管理介面設定。您可以設定儲存在 server.xml 配置檔案中的所有特性，但是不能設定儲存在 init.conf 或 obj.conf 中的特性。如需關於配置檔案的更多資訊，請參閱「Sun ONE Application Server Administrator's Configuration File Reference」。

如需關於個別指令的更多資訊，請參閱指令參考，以及指令的說明。

本章節包含下列主題：

瞭解指令語法
使用單模式與多重模式
使用互動式與非互動式選項
使用環境指令
使用密碼檔案選項
本機或遠端運行 asadmin
使用指令行呼叫
使用逸出字元
使用 get 與 set 指令
使用輔助說明
檢視輸出與錯誤

瞭解指令語法

asadmin 公用程式具有以下語法：

asadmin command -short-option argument --long-option argument operand

指令

指令是執行的作業或工作。指令區分大小寫。

選項

選項修改公用程式執行指令的方式。選項區分大小寫。請注意，短選項在其前面具有單一破折號 (-)，長選項在其前面具有兩個破折號 (--)。對於許多選項，您可以使用長形式或短形式的選項，例如，使用者可以為 --user 或 -u。某些選項是必需的，某些選項是選擇性的。選擇性的選項顯示在指令語法的括號中。在執行指令或收到錯誤訊息並且指令不執行的情況下，您必須包含所有必備選項。

如需關於可用長選項與短選項名稱的清單，請參閱指令參考中的短選項與長選項、預設值與環境變數表格。

大多數選項需要引數值，例如 --port port_number。布林選項例外，其可以開啟與關閉功能，並且不需要引數值。

也可以在環境變數中儲存選項。如需更多資訊，請參閱使用環境指令。如需對等於選項的環境變數之完整清單，請參閱長選項格式與短選項格式、預設值與對等的環境變數。

布林選項

布林選項開啟或關閉 (例如 --interactive 使您處於互動式模式下，提示您輸入選項；--no-interactive 會關閉互動式模式)。在長選項的前面置入 --no-，會關閉此選項。指定短選項名稱時，總是會設定相反的預設值。

您可以群組短布林選項。例如，可以使用 -Ie 來指定互動式 (短選項 -I) 與回應 (短選項 -e)。

運算元

運算元由空格或標籤分隔。它們可以以任何順序排列在指令語法中。您可以在運算元之後使用 --no 選項，將選項與運算元分開。以下任何引數均可以被視為運算元，即使其以破折號 (-) 開始。例如，於以下碼行中

asadmin> create-jvm-options --instance server1 -- -Xmx1500m

-XMx1500m 被視為運算元 (雖然其以破折號開始)。

語法範例

asadmin create-instance [--user admin_user] [--password admin_password] [-H host_name] [--port port_number] [--sysuser sys_user] [--domain domain_name] [--local=true/false] [--passwordfile file_name] [--secure | -s] --instanceport instance_port instance_name

在此語法範例中，-H 為主機名稱的短選項；--user 為長選項，admin_user 為該選項的引數；instance_name 為運算元。括號內為選擇性選項。

以下範例顯示具有實數值的語法。某些選擇性選項未在此範例中使用。

asadmin create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

使用單模式與多重模式

您可以在單模式或多重模式下執行 asadmin。在單模式下，每次從指令提示下僅執行一個指令。在多重模式下，您可以執行多個指令，而無需重新輸入環境層級資訊。

如果您正在使用檔案中的輸入，並且指令執行失敗，則在單模式下，此程式會結束。如果您正在使用多重模式，並且指令執行失敗，則會返回至 asadmin 提示。

單模式

如果您在指令行介面中從指令提示下呼叫單一指令，則您在單模式下執行。指令行介面會執行此指令，然後返回至指令提示。若要從指令提示下執行指令行介面，請移往 install_dir/appserv/bin 目錄，然後在指令提示下鍵入指令：

> asadmin command options arguments

例如︰

> asadmin create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

多重模式

多重模式讓您在開始時設定環境，以便無需重新輸入特定環境層級資訊 (例如伺服器名稱、連接埠與密碼) 便可以執行多個指令。使用多重模式的一個突出優點是可以更快速地輸入並執行指令，因為 asadmin 儲存在記憶體中。如果在作業系統層級中設定這些環境變數，則多重模式會使用那些設定。asadmin 公用程式會一直使用這些設定，除非您變更它們。

在 Windows 中，當您執行 asadmin.bat 檔案時，會自動處於多重模式中。

在 UNIX 中，若要在多重模式下從指令行啟動 asadmin 公用程式，請鍵入：

> asadmin 多重模式

處於多重模式時，指令提示會變更為 asadmin。然後您便可以在 asadmin 提示下鍵入指令。無需使用公用程式名稱。例如︰

asadmin> create-instance --user admin --password password -H austen --port 4848 --instanceport 1024 server2

鍵入 exit 或 quit 後，會結束多重模式。您返回至指令提示。

多重模式內的多重模式

也可以透過使用以下指令，從多重模式階段作業中呼叫多重模式：

asadmin> multimode

結束第二個多重模式環境後，您便會返回至原始的多重模式環境。

例如，如果您正在多重模式下管理 server1，並且要管理 server2，以比較這兩個指令，則可以從執行 server1 的多重模式內呼叫執行 server2 的多重模式。由於您無需結束目前的多重模式階段作業，因此可以保留環境設定。當您結束正在使用的 server2 多重模式階段作業時，會返回至 server1 多重模式環境。

使用互動式與非互動式選項

您使用指令行介面時，可以在互動式或非互動式模式下使用此介面。如果您選擇使用互動式模式，但未指定互動式模式，系統會提示您輸入密碼。依預設，會啟用互動式模式。

您可以透過使用 export 指令設定互動式環境變數，停用與啟用互動式模式。如需更多資訊，請參閱與 export 指令一起使用的環境變數表格。

您可以在單模式的各種情況下，使用互動式選項。在每次從指令提示執行一個指令以及在多重模式下從檔案中執行指令時，可以使用多重模式中的互動式選項。但是，在多重模式下從輸入串流中傳輸的指令以及從另一個程式中呼叫的指令，不能在互動式模式下執行。

使用環境指令

asadmin 公用程式包含您可以使用環境指令設定的環境變數集。在多重模式下，一旦設定了這些變數，結束多重模式之前便無需重新設定您的環境。也可以在作業系統層級中設定這些環境變數，如果這樣做，在您輸入多重模式時會自動點選這些環境變數，並且在結束多重模式之後它們會繼續存在。

環境變數是可以在任何時間透過指定進行設定的名稱/值對。環境變數由大寫的選項名稱之字首 AS_ADMIN_ 構成。例如，若要設定管理伺服器使用者，可以鍵入：

export AS_ADMIN_USER=administrator

其中 administrator 是管理員的使用者名稱。

同時，AS_ADMIN_USER 的值也可用於 asadmin 指令，例如：

asadmin 多重模式
asadmin> export AS_ADMIN_HOST=austen

只要您在多重模式階段作業中，管理伺服器主機名稱就會設定為 austen，除非您重新指定該名稱。

也可以在一個步驟中，設定並匯出多重環境變數的值，例如：

asadmin> export AS_ADMIN_PORT=4848 AS_ADMIN_USER=admin

若要查看目前的環境變數設定，請使用沒有引數的 export 指令：

asadmin> export
AS_ADMIN_HOST=austen
AS_ADMIN_PORT=4848
AS_ADMIN_USER=admin

使用 unset 指令，移除此環境中的變數及其值。例如︰

asadmin> unset AS_ADMIN_HOST

您可以透過重新設定變數或設定作為 asadmin 指令部分的另一個值，置換環境變數的設定值。例如︰

asadmin> export AS_ADMIN_HOST=dickens
asadmin> show-instance-status --host austen instance-name

此範例顯示管理伺服器主機 austen 中的實例狀況，因為該值置換了 dickens 的先前主機值。

如果您不使用已匯出的變數，則必須為大多數指令提供以下選項或使用預設值 (如需預設值的清單，請參閱長選項格式與短選項格式、預設值與對等的環境變數)：

--host
--port
--user
--password 或 --passwordfile
--secure=true (如果安全)
--instance (如果需要)

下表與 export 指令一起使用的環境變數描述與 export 指令一起使用的一些環境變數。這些變數為經常使用的變數，因為其專用於設定環境。第一欄顯示環境變數名稱，第二欄顯示使用情況，並且如果未設定值，將使用預設值。如需環境變數的完整清單，請參閱長選項格式與短選項格式、預設值與對等的環境變數。

表格 A-2 與 export 指令一起使用的環境變數

環境變數	用法
AS_ADMIN_HOST	管理伺服器的主機名稱。如果未指定值，則使用 localhost。
AS_ADMIN_PORT	管理伺服器的連接埠號。如果未指定值，則使用 4848。
AS_ADMIN_USER	執行指令的使用者名稱。
AS_ADMIN_PASSWORD	執行指令的使用者名稱密碼。使用者名稱與密碼用於認證使用者，以確認允許使用者管理伺服器。這與透過管理介面存取管理伺服器時進行的認證相同。
AS_ADMIN_SECURE	如果安全的話，則為 =true。
AS_ADMIN_INSTANCE	設定 Sun ONE Application Server 的實例。任何使用實例名稱作為引數的後續指令 (但不是使用其作為運算元的指令) 使用此指定的實例。

使用密碼檔案選項

如果您不想在指令行鍵入密碼或為密碼設定環境變數，可以建立一個密碼檔案，並使用其作為指令行中的一個選項。

每個具有 password 選項的指令也具有可以取代使用的 passwordfile 選項。密碼檔案包含以下行：

AS_ADMIN_PASSWORD=value

AS_ADMIN_ADMINPASSWORD=value

AS_ADMIN_USERPASSWORD=value

如果您使用 passwordfile 選項，則檔案中的密碼會匯出至多重模式環境中，並且沒有指定 password 選項的後續指令使用這些值。

如果您在指令行同時指定密碼與密碼檔案選項，則密碼檔案中的值會匯出至多重模式環境中，但是目前的指令仍使用密碼選項中指定的密碼，因為密碼選項要優先於密碼檔案。

本機或遠端運行 asadmin

通常 asadmin 公用程式透過管理伺服器發送其指令。因此，不需要在安裝了 Sun ONE Application Server 的系統上執行 asadmin。但是，必須執行管理伺服器，以便讓大多數 asadmin 指令進行工作。

某些指令具有在本機執行的選項，例如，create-instance。如果您在 create-instance 中使用 --local=true 選項，則必須在安裝此伺服器的機器上執行它，但是無需執行管理伺服器來建立實例。

某些指令必須在本機執行。例如，啟動管理伺服器及其所有實例的 start-appserv 不能在遠端執行，因為管理伺服器只有在該指令啟動它時才執行。

如需有關管理伺服器的更多資訊，請參閱第 2 章「設定管理伺服器偏好設定」。

以下指令可以在本機與遠端執行：

create-instance
delete-instance
list-instances
start-instance
stop-instance
display-license
version
stop-domain
restart-instance
list-domains

對於這些指令，無需您指定本機選項，便可選擇在本機執行指令。依預設，如果您在指令語法中指定使用者、密碼、主機或連接埠的值，則此指令會被視為遠端指令 (雖然您仍然可以為這些選項指定本機值)。如果您不指定這些選項的值，則依預設，此指令在本機執行。

在本機執行指令時，如果有一個領域選項，則其為此指令所需的選項 (除非只有一個領域)；在遠端執行指令時，如果您指定了此指令，則會忽略此領域選項。

使用指令行呼叫

您可以以多種方式呼叫指令行，如以下主題所述：

從指令行使用 asadmin
以檔案 (程序檔) 中的輸入，使用 asadmin
以標準輸入 (管道) 使用 asadmin

從指令行使用 asadmin

使用指令的最簡便方式是在指令行上，一次僅執行一個指令。您鍵入公用程式、指令及其選項與引數。在多重模式下，無需重新鍵入公用程式名稱與環境選項 (如果您已設定環境變數)，便可鍵入多個指令。您可以互動式或非互動式執行單模式或多重模式指令 (提示進行其他需要的輸入，例如，密碼)。

如需關於單模式與多重模式的更多資訊，請參閱使用單模式與多重模式。

如需關於互動式使用指令的更多資訊，請參閱使用互動式與非互動式選項。

指令行中的範例

> asadmin create-instance --user admin --password password --host austen --port 4848 --instanceport 1024 server2

指令執行結束後，會返回至作業系統提示。

以檔案 (程序檔) 中的輸入，使用 asadmin

您可以建立包含許多 asadmin 指令的程序檔。使用程序檔，您可以批次處理指令、設定在特定時間要執行的工作，並且還可簡化管理工作，使之自動化。

若要呼叫檔案中的程序檔，請使用此語法：

> asadmin multimode --file filename

以下是您可以以此方式呼叫的檔案中簡單程序檔範例：

# 建立新實例並啟動它。
export AS_ADMIN_USER=admin AS_ADMIN_PASSWORD=mypassword AS_ADMIN_HOST=austen AS_ADMIN_PORT=4848
create-instance --instanceport 9000 austen3
start-instance austen3

此程序檔設定環境，建立名為 austen3 的實例，然後啟動新的實例。以數字符號 (#) 開始的行被視為注釋，並被忽略。

以標準輸入 (管道) 使用 asadmin

您可以使用以下語法，在 asadmin 公用程式中傳輸輸入：

cat filename | asadmin multimode

此語法可能在 Windows 中無法使用。

使用逸出字元

如果您在指令語法中使用某些字元，如冒號 (:)、星號 (*) 與反斜線 (\)，則會發生錯誤 (除非您使用逸出字元將其分開)。使用逸出字元的可能性因您使用的平台與您使用單模式還是多重模式而異。

註	不需要在 get 與 set 指令中為冒號使用逸出字元。

本章節包含下列主題：

在單模式下的 UNIX 中之逸出字元
在單模式下的 Windows 中之逸出字元
在單模式下的所有平台中之逸出字元
在多重模式下的所有平台中之逸出字元

在單模式下的 UNIX 中之逸出字元

在 Solaris 中，您可以使用兩個反斜線 (\\) 或雙引號 (" ")，以逸出受限的字元。

使用反斜線 (\\) 逸出

例如，在建立 JDBC 連線區時，其中其選項值包含冒號，則可以使用反斜線 (範例假設已為某些特性設定了環境變數)：

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=jdbc\\:oracle\\:thin\\:@asperfsol8\\:1521\\:V8i:user=staging_lookup_app:password=staging_lookup_app OraclePoollookup

使用引號逸出

若要在以上同一個範例中使用引號，則需以雙引號 (") 包含此值，然後使用反斜線逸出此雙引號。

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=\"jdbc:oracle:thin:@asperfsol8:1521:V8i\":user=staging_lookup_app:password=staging_lookup_app OraclePoollookup

也可以使用在單模式下的所有平台中之逸出字元中所述的方法。

在單模式下的 Windows 中之逸出字元

在 windows 中，您可以使用反斜線字元逸出。例如，在建立 JDBC 連線區時，其中其選項值包含冒號，則可以使用反斜線 (範例假設已為某些特性設定了環境變數)：

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url=jdbc\:oracle\:thin\:@asperfsol8\:1521\:V8i:user=staging_lookup_app:password=staging_lookup_app OraclePoollookup

也可以使用在單模式下的所有平台中之逸出字元中所述的方法。

在單模式下的所有平台中之逸出字元

在任何平台中，您可以使用反斜線逸出字元，並且在雙引號中加上包含逸出字元的值。例如，在建立 JDBC 連線區時，其中其選項值包含冒號，則可以使用如下所示的逸出字元 (範例假設已為某些特性設定了環境變數)：

asadmin create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url="jdbc\:oracle\:thin\:@iasperfsol8\:1521\:V8i":user=staging_lookup_app:password=staging_lookup_app OraclePoollookup

在多重模式下的所有平台中之逸出字元

在多重模式下，您可以使用以下語法，其僅需要引號，而不需斜線或反斜線：

asadmin> create-jdbc-connection-pool --instance server1 --datasourceclassname oracle.jdbc.pool.OracleDataSource --failconnection=true --isconnectvalidatereq=true --property url="jdbc:oracle:thin:@asperfsol8:1521:V8i":user=staging_lookup_app:password=staging_lookup_app OraclePoollookup

使用 get 與 set 指令

使用 get 與 set 指令，可存取並變更 Sun ONE Application Server 中的配置設定。在大多數情況下，asadmin 指令僅設定所需的特性。使用 set 指令，變更選擇性特性的值。

表格 A-3 get 與 set 指令

指令	引數	用法
get	(scope)，其中 scope 表示屬性，為有效名稱。	取得屬性值。
set	(scope=value)，其中 scope 表示屬性，為有效名稱，而 value 是您要為此屬性設定的值。	設定屬性值。
reconfig	instance-name	執行修改配置檔案的任何指令之後，需要執行 reconfig，以便使變更套用於伺服器。如需關於套用變更/重新配置伺服器的更多資訊，請參閱將變更套用至應用程式伺服器實例。

您可以透過在屬性之間使用空格，在單一指令中取得或設定多個屬性值。例如︰

set server1.appReloadPollInterval=20 server1.mime.mime1.file=mime.types

也可以使用 AS_ADMIN_PREFIX 環境變數，設定後續 get 與 set 指令使用的字首。小數點 (".") 隱式插入在 get 和 set 指令中的前綴字串與運算元之間。例如︰

asadmin>export AS_ADMIN_PREFIX=server1
asadmin>get *
server1.locale = en_US
server1.appReloadPollInterval = 2
server1.name = server1
...

由於 get 與 set 指令需要小數點分隔符號，如果項目在其名稱中包含小數點，則必須在小數點之前使用逸出字元反斜線 (\)。以下範例顯示了伺服器實例名稱 server2.sun.com，其小數點之前為反斜線：

get server2\.sun\.com.*

如果您不包含反斜線，則會出現錯誤訊息。

get 與 set 指令範例

以下範例顯示如何使用 get 指令取得屬性值，以及如何使用 set 指令設定值。

MDB 容器服務範例

如果應用程式伺服器實例為 server1，則可以使用多重模式中的以下指令，取得所有 mdb-container 屬性的值，其中環境設定為：

asadmin> get server1.mdb-container.*

以下是此指令的輸出範例，顯示屬性的目前值：

server1.mdb-container.logLevel = null
server1.mdb-container.steadyPoolSize = 10
server1.mdb-container.idleInPoolTimeoutInSeconds = 600
server1.mdb-container.maxPoolSize = 60
server1.mdb-container.monitoringEnabled = false
server1.mdb-container.poolResizeQuantity = 2

若要僅取得 MDB 容器屬性 monitoringEnabled 的值，請使用以下內容：

asadmin> get server1.mdb-container.montioringEnabled

若要將 monitoringEnabled 屬性值設定為 true，請使用以下內容：

asadmin> set server1.mdb-container.montioringEnabled=true

JMS 資源範例

如需配置任何資源，此屬性應該如下表示：

instancename.resource.primary_key_value.attribute_name

例如︰

asadmin> get server1.jms-resource.myjms.*

取得名為 myjms 的 JMS 目標資源之所有屬性。例如︰

server1.jms-resource.myjms.resType = javax.jms.Topic
server1.jms-resource.myjms.enabled = true
server1.jms-resource.myjms.name = myjms
server1.jms-resource.myjms.description = null

取得單一屬性的值，例如 resType：

asadmin> get server1.jms-resource.myjms.resType

設定屬性，例如 description：

asadmin> set server1.jms-resource.myjms.description=mydescription

此範例將 description 設定為 mydescription。

取得並設定多個值範例

您可以使用同一指令，取得並設定多個值。若要同時設定兩個屬性，請使用空格分隔屬性。例如︰

set server1.appReloadPollInterval=20 server1.mime.mime1.file=mime.types

同時，也可以使用環境變數 AS_ADMIN_PREFIX，設定許多 get 與 set 指令要使用的字首。

使用 get 與 set 指令監視

也可以使用 get 與 set 指令，監視執行中的伺服器。list 指令也用於監視。您可以將 monitor 選項設定為 true 或 false。如果設定為 true，則會監視已指定的屬性。如需關於使用指令行介面監視 Sun ONE Application Server 的更多資訊，請參閱使用 CLI 擷取監視資料。

使用輔助說明

每個 asadmin 指令的輔助說明均可以透過鍵入 -h 或 --help，從指令提示下取得。例如，如需關於 asadmin 的輔助說明，請鍵入：

asadmin --help

您會看到所有 asadmin 指令的清單。

若要取得特定 asadmin 指令的輔助說明，請鍵入：

asadmin command -h

或

asadmin command --help

此輔助說明包含提要、指令說明、語法資訊、範例，以及相關指令的清單。

請注意，如果您在指令的任何位置使用 -h 或 --help，將取得該指令的輔助說明。此指令將不執行。

也可以在 UNIX 環境中，將指令行輔助說明頁存取為線上援助頁。對於非隨附式安裝，請在 MANPATH 環境變數中加入 install_dir/man。完成之後，便可以存取 Sun ONE Application Server 公用程式的線上援助頁，例如，透過在指令提示下鍵入 man asadmin。

檢視輸出與錯誤

指令執行成功後，您將會看到通知您完成作業的訊息。如果指令執行失敗，則會看到錯誤訊息。

本章節包含下列主題：

檢視結束狀況
檢視用法

檢視結束狀況

除錯誤訊息外，asadmin 指令總是在結束狀況下結束。如果此指令執行成功，則結束狀況為 0；如果指令執行失敗，則結束狀況為 1。

在 UNIX 中的結束狀況

可以透過鍵入 echo $?，在指令提示下檢查結束狀況。

也可以在程序檔中使用結束碼，例如，以下 Korn shell 程序檔使用結束狀況，指出 list-instances 指令執行成功還是失敗：

#!/bin/ksh
asadmin list-instances
if [[ $? = 0 ]]
 then
   echo "success"
 else
  echo "error"
fi

在 Windows 中的結束狀況

在 Windows 中，可以在 .bat 程序檔中檢查結束狀況。例如，以下兩個程序檔分別顯示成功的程序檔及其傳回的輸出，以及不成功的程序檔及其傳回的輸出：

Success Condition

myscript.bat
------------
echo off
echo Processing Command
call asadmin list-instances --domain domain1
if not %errorlevel% EQU 0 goto end
echo Command Succesful
goto program-end
:end
echo Command Failed
:program-end

Output:

Processing Command
admin-server <not running>
server1 <not running>
Command Succesful

Error Condition

myscript.bat
-------------
echo off
echo Processing Command
call asadmin list-instances
if not %errorlevel% EQU 0 goto end
echo Command Succesful
goto program-end
:end
echo Command Failed
:program-end

Output:

Processing Command
No default domain.Need to enter a domain.
Command Failed

檢視用法

如果鍵入沒有引數的指令，則會出現包含此指令語法的錯誤訊息。例如︰

asadmin> create-instance

Invalid number of operands received

USAGE:create-instance [--user admin_user] [--password admin_password] [--host localhost] [--port 4848] [--sysuser sys_user] [--domain domain_name] [--local=false] [--passwordfile file_name] [secure | -s] --instanceport instanceport instancename

---

安全性考量

您從指令行執行指令行介面時，必須提供使用所有指令的密碼。如果在多重模式下執行，則必須在設定環境時，首先提供密碼。如果結束多重模式，您再次啟動多重模式時，必須再次設定環境，包括密碼。使用環境指令設定密碼。如需更多資訊，請參閱使用環境指令。

也可以設定密碼檔案，因此，無需在指令行鍵入密碼。如需更多資訊，請參閱使用密碼檔案選項。

如果沒有有效使用者名稱與密碼的認證資訊，指令將不執行。

指令行介面具有您為 Sun ONE Application Server 設定的安全性措施。如需關於 Sun ONE Application Server 中安全性的更多資訊，請參閱「Sun ONE Application Server Administrator's Security Guide」。

---

並行存取考量

有可能多個使用者使用指令行介面和/或管理介面，嘗試同時配置伺服器。如果這樣，第二個配置請求一直佇列到第一個配置請求完成為止。如果此請求佇列的時間太長，則會逾時。

對於某些指令，只有您使用 reconfig 指令之後，這些變更才會生效。這意味著有多個使用者在變更套用於伺服器之前，可以編輯屬性。如需關於 reconfig 的更多資訊，請參閱將變更套用至應用程式伺服器實例。

---

指令參考

本章節包含下列主題：

指令清單
點名稱與屬性清單
長選項格式與短選項格式、預設值與對等的環境變數

指令清單

下表顯示所有的 asadmin 指令及其用途。如需關於指令語法與用法的更多資訊，請參閱線上說明。

左欄顯示指令名稱，右欄顯示其用法。

表格 A-4 asadmin 指令

指令	用法
add-resources	加入類型為 jdbc、jms 或 javamail 的一個或更多資源。
create-acl	建立 ACL (存取控制清單)。
create-authdb	建立認證資料庫。
create-auth-realm	建立認證範圍。
create-custom-resource	建立自訂資源。
create-domain	建立領域。
create-file-user	在 keyfile 中建立檔案範圍使用者。
create-http-listener	建立 HTTP 偵聽程式。
create-http-qos	為應用程式伺服器實例或虛擬伺服器建立服務設定的 HTTP 品質。
create-iiop-listener	建立 IIOP 偵聽程式。
create-instance	建立應用程式伺服器實例。
create-javamail-resource	建立 Java 郵件資源。
create-jdbc-connection-pool	建立 JDBC 連線區。
create-jdbc-resource	建立 JDBC 資源。
create-jmsdest	建立 JMS (Java 訊息服務) 目標。
create-jms-resource	建立 JMS 資源。
create-jndi-resource	建立 JNDI 資源。
create-jvm-options	在 java-config 中建立 JVM 選項或測量程式元素。
create-lifecycle-module	建立生命週期模組。
create-mime	建立 MIME 類型檔案。
create-persistence-resource	建立持續性管理程式 Factory 資源。
create-profiler	為 JVM 建立測量程式。
create-ssl	建立 HTTP 偵聽程式、IIOP 偵聽程式或 IIOP 服務的 SSL 設定。
create-virtual-server	建立虛擬伺服器。
delete-acl	刪除 ACL。
delete-authdb	刪除認證資料庫。
delete-auth-realm	刪除認證範圍。
delete-custom-resource	刪除自訂資源。
delete-domain	刪除領域。此指令僅可以在本機執行。
delete-file-user	從 keyfile 中刪除檔案範圍使用者。
delete-http-listener	刪除 HTTP 偵聽程式。
delete-http-qos	刪除應用程式伺服器實例或虛擬伺服器的服務設定之 HTTP 品質。
delete-iiop-listener	刪除 IIOP 偵聽程式。
delete-instance	刪除應用程式伺服器實例。
delete-javamail-resource	刪除 Java 郵件資源。
delete-jdbc-connection-pool	刪除 JDBC 連線區。
delete-jdbc-resource	刪除 JDBC 資源。
delete-jmsdest	刪除 JMS 目標。
delete-jms-resource	刪除 JMS 資源。
delete-jndi-resource	刪除 JNDI 資源。
delete-jvm-options	在 java-config 中刪除 JVM 選項或測量程式元素。
delete-lifecycle-module	刪除生命週期模組。
delete-mime	刪除 MIME 類型檔案。
delete-persistence-resource	刪除持續性管理程式 Factory 資源。
delete-profiler	刪除 JVM 測量程式。
delete-ssl	刪除 HTTP 偵聽程式、IIOP 偵聽程式或 IIOP 服務的 SSL 設定。
delete-virtual server	刪除虛擬伺服器。
deploy	部署 EJB、WEB、連接器、appclient 或應用程式伺服器實例的應用程式元件。
deploydir	部署 EJB、WEB、連接器、appclient 或在此目錄中的應用程式伺服器實例之應用程式元件。
disable	停用應用程式伺服器實例中的已部署元件。
display-license	顯示授權資訊。此指令僅可以在本機執行。
enable	啟用 (允許執行) 應用程式伺服器實例中的已部署元件。
export	匯出 asadmin 環境變數值，以便後續的 asadmin 指令可以使用該值。
get	取得屬性值。
help	顯示給定指令的輔助說明 (說明、用法、語法、範例)，或 asadmin 的一般輔助說明。
install-license	安裝授權檔案。此指令僅可以在本機執行。
jms-ping	ping JMS 提供者，以查看其是否在執行。
list	列示可配置的元素。
list-acls	列示應用程式伺服器實例的 ACL。
list-authdbs	列示認證資料庫。
list-auth-realms	列示認證範圍。
list-components	列示伺服器實例的已部署元件。
list-custom-resources	列示伺服器實例中的自訂資源。
list-domains	列示領域。
list-file-users	列示伺服器實例中的所有檔案範圍使用者。
list-file-groups	列示指定的檔案範圍使用者之所有群組。如果您不指定使用者，則會列示伺服器實例的所有群組。
list-http-listeners	列示伺服器實例的 HTTP 偵聽程式。
list-instances	列示領域中的應用程式伺服器實例。
list-iiop-listeners	列示伺服器實例的 IIOP 偵聽程式。
list-javamail-resources	列示伺服器實例的 Java 郵件資源。
list-jdbc-connection-pools	列示伺服器實例的 JDBC 連線區。
list-jdbc-resources	列示伺服器實例的 JDBC 資源。
list-jmsdest	列示伺服器實例的 JMS 目標。
list-jms-resources	列示伺服器實例的 JMS 資源。
list-jndi-resources	列示伺服器實例的 JNDI 資源。
list-lifecycle-modules	列示伺服器實例的生命週期模組。
list-mimes	列示伺服器實例的 MIME 類型檔案。
list-persistence-resources	列示伺服器實例的持續性管理程式 Factory 資源。
list-profilers	列示伺服器實例的 JVM 測量程式。
list-sub-components	在已部署模組或已部署應用程式的模組中列示一個或多個 EJB 或 Servlet。
list-virtual-servers	列示伺服器實例的虛擬伺服器。
multimode	允許您執行多重指令，同時保留環境設定並保留在 asadmin 中。
reconfig	將變更套用至伺服器。大多數變更僅在套用至伺服器後，其才能生效。
restart-instance	重新啟動伺服器實例。
set	設定屬性值。
show-component-status	顯示已部署元件的狀況。
show-instance-status	顯示伺服器實例的狀況 (即，該實例是否在執行)。
shutdown	關閉管理伺服器。
start-appserv	啟動管理伺服器及所有伺服器實例。此指令僅可以在本機執行。
start-domain	啟動領域中的所有實例。此指令僅可以在本機執行。
start-instance	啟動伺服器實例。
stop-appserv	停止管理伺服器及所有伺服器實例。此指令僅可以在本機執行。
stop-domain	停止領域中的所有實例。
stop-instance	停止伺服器實例。
undeploy	從伺服器實例中移出已部署的元件。
unset	取消設定 asadmin 的匯出環境變數。
update-file-user	更新現有的檔案範圍使用者。
version	顯示 Sun ONE Application Server 的版本資訊。

點名稱與屬性清單

您使用 get 或 set 指令取得並設定屬性時，需知道 asadmin 使用的服務與資源等的名稱，從而可以使用此名稱取得該特定物件的屬性。

由於使用這些名稱的語法在小數點之間分隔名稱，所以這些名稱稱為點名稱。

在 asadmin 中使用的點名稱

下表列示使用 asadmin 配置項目所使用的名稱。這些名稱分為以下幾類：

服務名稱
資源名稱
應用程式名稱
其他名稱

服務名稱

下表顯示取得並設定服務屬性要使用的服務名稱：

表格 A-5 指令行介面的服務名稱

服務	點名稱
JMS 服務配置	jms-service
作業事件服務配置	transaction-service
MDB 容器配置	mdb-container
EJB 容器配置	ejb-container
Web 容器配置	web-container
JVM 配置	java-config
ORB 配置	orb 或 iiop-service
ORB 偵聽程式配置	orblistener 或 iiop-listener 請注意，orblistener 或 iiop-listener 不是有效名稱，兩者均需要偵聽程式的名稱跟隨其後。例如︰ ORB 偵聽程式配置 orblistener.<偵聽程式名稱> 或 iiop-listener.<偵聽程式名稱>
日誌配置	log-service
安全性配置	security-service
HTTP 配置	http-service

資源名稱

下表顯示取得並設定資源屬性要使用的資源名稱。請注意，這些名稱本身是無效的，其需要資源名稱跟隨其後。

表格 A-6 指令行介面的資源名稱

資源	點名稱
JDBC 資源配置	jdbc-resource
JNDI 資源配置	jndi-resource
JDBC 連線區資源配置	jdbc-connection-pool
自訂資源配置	custom-resource
JMS 資源配置	jms-resource
持續性管理程式 Factory 資源配置	persistence-manager-factory-resource
Java 郵件資源配置	mail-resource

應用程式名稱

下表顯示取得並設定應用程式相關的配置屬性要使用的點名稱。請注意，這些名稱本身是無效的，其需要應用程式名稱跟隨其後。

表格 A-7 指令行介面的應用程式名稱

應用程式元件	點名稱
應用程式配置	application
EJB 模組配置	ejb-module
Web 模組配置	web-module
連接器模組配置	connector-module

其他名稱

下表顯示使用 get 與 set 可以配置的其他項目之點名稱。請注意，這些名稱本身是無效的，其需要應用程式名稱跟隨其後。例如，http-listener.listener_name、lifecycle-module.module-name 等。

表格 A-8 指令行介面的其他項目名稱

項目	點名稱
HTTP 偵聽程式	http-listener 或 http-server.http-listener
MIME 類型檔案	mime
ACL	acl
虛擬伺服器	virtual-server
認證資料庫	auth-db
安全性範圍	authrealm
生命週期模組	lifecycle-module
測量程式配置	profiler
伺服器配置	server configuration (伺服器實例名稱)

屬性

以下章節顯示以上列示的每個具名項目的屬性，並且提供用法範例。請注意，某些屬性是唯讀的 (即，其僅可以用在 get 指令中，而不能用在 set 指令中)。

註	本小節的範例假設已在環境變數中定義使用者、密碼、主機與連接埠，並且在此語法中未列示這些選項。

jms-service

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-9 JMS 服務屬性

server.xml 名稱	asadmin 名稱
port	port
admin-username	adminUserName
admin-password	adminPassword
log-level	logLevel
enabled	enabled
init-timeout-in-seconds	initTimeoutInSeconds
start-args	startArgs

從實例 (server1) 中取得所有屬性：

asadmin> get server1.jms-service.*

取得名為 adminPassword 的屬性：

asadmin> get server1.jms-service.adminPassword

將名為 adminPassword 的屬性設定為值 admin：

asadmin> set server1.jms-service.adminPassword=admin

transaction-service

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-10 作業事件服務屬性

server.xml 名稱	asadmin 名稱
automatic-recovery	automaticTransactionRecovery
timeout-in-seconds	transactionRecoveryTimeout
tx-log-dir	transactionLogFile
heuristic-decision	heuristicDecision
keypoint-interval	keypointInterval
log-level	logLevel
monitoring-enabled	monitoringEnabled

從實例 (server1) 中取得所有屬性：

asadmin> get server1.transaction-service.*

取得名為 transactionRecoveryTimeout 的屬性：

asadmin> get server1.transaction-service.transactionRecoveryTimeout

將名為 transactionRecoveryTimeout 的屬性設定為值 49：

asadmin> set server1.transaction-service.transactionRecoveryTimeout=49

mdb-container

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-11 MDB 容器屬性

server.xml 名稱	asadmin 名稱
steady-pool-size	steadyPoolSize
pool-resize-quantity	poolResizeQuantity
max-pool-size	maxPoolSize
idle-timeout-in-seconds	idleInPoolTimeoutInSeconds
log-level	logLevel
monitoring-enabled	monitoringEnabled

從實例 (server1) 中取得所有屬性：

asadmin> get server1.mdb-container.*

取得名為 steadyPoolSize 的屬性：

asadmin> get server1.mdb-container.steadyPoolSize

將名為 steadyPoolSize 的屬性設定為值 10：

asadmin> set server1.mdb-container.steadyPoolSize=10

ejb-container

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-12 EJB 容器屬性

server.xml 名稱	asadmin 名稱
steady-pool-size	steadyPoolSize
pool-resize-quantity	poolResizeQuantity
max-pool-size	maxPoolSize
cache-resize-quantity	cacheResizeQuantity
max-cache-size	maxCacheSize
pool-idle-timeout-in-seconds	idleInPoolTimeoutInSeconds
cache-idle-timeout-in-seconds	idleInCacheTimeoutInSeconds
removal-timeout-in-seconds	removalTimeoutInSeconds
victim-selection-policy	victimSelectionPolicy
commit-option	commitOption
log-level	logLevel
monitoring-enabled	monitoringEnabled

從實例 (server1) 中取得所有屬性：

asadmin> get server1.ejb-container.*

取得名為 maxPoolSize 的屬性：

asadmin> get server1.ejb-container.maxPoolSize

將名為 maxPoolSize 的屬性設定為值 12：

asadmin> set server1.ejb-container.maxPoolSize=12

web-container

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-13 Web 容器屬性

server.xml 名稱	asadmin 名稱
log-level	logLevel
monitoring-enabled	monitoring-enabled (不使用)

從實例 (server1) 中取得所有屬性：

asadmin> get server1.web-container.*

取得名為 logLevel 的屬性：

asadmin> get server1.web-container.logLevel

將名為 monitoringEnabled 屬性設定為 WARNING：

asadmin> set server1.web-container.logLevel=WARNING

java-config

下表在左欄中顯示屬性的 sserver.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-14 JVM 屬性

server.xml 名稱	asadmin 名稱
java-home	javahome
debug-enabled	debugEnabled
debug-options	debugOptions
javac-options	javacoptions
rmic-options	rmicoptions
classpath-prefix	classpathprefix
server-classpath	serverClasspath
classpath-suffix	classpathsuffix
native-library-path-prefix	libpathprefix
native-library-path-suffix	libpathsuffix
env-classpath-ignored	envpathignore

從實例 (server1) 中取得所有屬性：

asadmin> get server1.java-config.*

取得名為 classpathprefix 的屬性：

asadmin> get server1.java-config.classpathprefix

將名為 classpathprefix 的屬性設定為值 com.sun：

asadmin> set server1.java-config.classpathprefix=com.sun

orb 或 iiop-service

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-15 ORB/IIOP 服務屬性

server.xml 名稱	asadmin 名稱
message-fragment-size	msgSize
steady-thread-pool-size	minThreads
max-thread-pool-size	maxThreads
max-connections	maxConnections
idle-thread-timeout-in-seconds	idleThreadTimeout
log-level	log
monitoring-enabled	monitor
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
tls-rollback-enabled	tlsRollback
client-auth-enabled	clientAuth

從實例 (server1) 中取得所有屬性：

asadmin> get server1.orb.*

或

asadmin> get server1.iiop-service.*

取得名為 msgSize 的屬性：

asadmin> get server1.orb.msgSize

或

asadmin> get server1.iiop-service.msgSize

將名為 idleThreadTimeout 的屬性設定 300：

asadmin> set server1.orb.idleThreadTimeout=300

或

asadmin> set server1.iiop-service.idleThreadTimeout=300

orblistener 或 iiop-listener

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-16 IIOP 偵聽程式屬性

server.xml 名稱	asadmin 名稱
id	id
address	address
port	port
enabled	enabled
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
tls-rollback-enabled	tlsRollback
client-auth-enabled	clientAuth

從實例 (server1) 中取得所有屬性：

asadmin> get server1.orblistener.orb_listener_id.*

或

asadmin> get server1.iiop-listener.orb_listener_id.*

取得名為 port 的屬性：

asadmin> get server1.orblistener.orb_listener_id.port

或

asadmin> get server1.iiop-listener.orb_listener_id.port

將名為 address 的屬性設定為 bluestar：

asadmin> set server1.orblistener.orb_listener_id.address=bluestar

或

asadmin> set server1.iiop-listener.orb_listener_id.address=bluestar

log-service

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-17 日誌配置屬性

server.xml 名稱	asadmin 名稱
file	file
level	level
log-stdout	stdout
log-stderr	stderr
echo-log-messages-to-stderr	echoToStderr
create-console	createConsole
log-virtual-server-id	LogVirtualServerId
use-system-logging	useSystemLogging

從實例 (server1) 中取得所有屬性：

asadmin> get server1.log-service.*

取得名為 level 的屬性：

asadmin> get server1.log-service.level

將名為 echoToStderr 的屬性設定為 true：

asadmin> set server1.log-service.echoToStderr=true

security-service

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-18 安全性範圍配置屬性

server.xml 名稱	asadmin 名稱
default-realm	defaultRealm
default-principal	defaultPrinicpal
default-principal-password	defaultPrinicpalPassword
anonymous-role	anonymousRole
audit-enabled	auditEnabled
log-level	logLevel

從實例 (server1) 中取得所有屬性：

asadmin> get server1.security-service.*

取得名為 anonymousRole 的屬性：

asadmin> get server1.security-service.anonymousRole

將名為 encryptPasswords 的屬性設定為 true：

asadmin> set server1.security-service.auditEnabled=true

http-service

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-19 HTTP 服務屬性

server.xml 名稱	asadmin 名稱
qos-metrics-interval-in-seconds	qos-metrics-interval-in-seconds
qos-recompute-time-interval-in-millis	qos-recompute-time-interval-in-millis
qos-enabled	qos-enabled
bandwidth-limit	bandwidthLimit
enforce-bandwidth-limit	enforceBandwidthLimit
connection-limit	connectionLimit
enforce-connection-limit	enforceConnectionLimit

從實例 (server1) 中取得所有屬性：

asadmin> get server1.http-service.*

取得名為 bandwidthLimit 的屬性：

asadmin> get server1.http-service.bandwidthLimit

將名為 qos-enabled 的屬性設定為 true：

asadmin> set server1.http-service.qos-enabled=true

jdbc-resource

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-20 JDBC 資源屬性

server.xml 名稱	asadmin 名稱
jndi-name	name
pool-name	pool
enabled	enabled
description	description

從實例 (server1) 中取得所有屬性：

asadmin> get server1.jdbc-resource.jdbc_resource_name.*

取得名為 pool 的屬性：

asadmin> get server1.jdbc-resource.jdbc_resource_name.pool

將名為 enabled 的屬性設定為 true：

asadmin> set server1.jdbc-resource.jdbc_resource_name.enabled=true

jndi-resource

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-21 JNDI 資源屬性

server.xml 名稱	asadmin 名稱
jndi-name	name
jndi-lookup-name	LookupName
res-type	resType
factory-class	factory
enabled	enabled
description	description

從實例 (server1) 中取得所有屬性：

asadmin> get server1.jndi-resource.jndi_name.*

取得名為 factory 的屬性：

asadmin> get server1.jndi-resource.jndi_name.factory

將名為 factory 的屬性設定為 com.sun：

asadmin> set server1.jndi-resource.jndi_name.factory=com.sun

jdbc-connection-pool

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-22 JDBC 連線區屬性

server.xml 名稱	asadmin 名稱
name	name
datasource-classname	dsClassName
res-type	resType
description	description
steady-pool-size	steadyPoolSize
max-pool-size	maxPoolSize
max-wait-time-in-millis	maxWaitTime
pool-resize-quantity	resizeValue
idle-timeout-in-seconds	idleTimeout
transaction-isolation-level	transactionIsolationLevel
is-isolation-level-guaranteed	isIsolationLevelGuaranteed
connection-validation-method	validationMethod
is-connection-validation-required	isValidationRequired
fail-all-connections	failAll
validation-table-name	validationTable

從實例 (server1) 中取得所有屬性：

asadmin> get server1.jdbc-connection-pool.pool_name.*

取得名為 dsClassName 的屬性：

asadmin> get server1.jdbc-connection-pool.pool_name.dsClassName

將名為 resizeValue 的屬性設定為 2：

asadmin> set server1.jdbc-connection-pool.pool_name.resizeValue=2

custom-resource

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-23 自訂資源屬性

server.xml 名稱	asadmin 名稱
jndi-name	name
res-type	resType
factory-class	factory
enabled	enabled
description	description

從實例 (server1) 中取得所有屬性：

asadmin> get server1.custom-resource.jndi_name.*

取得名為 factory 的屬性：

asadmin> get server1.custom-resource.jndi_name.factory

設定名為 factory 的屬性：

asadmin> set server1.custom-resource.jndi_name.factory=myclass

jms-resource

下表在左欄中顯示屬性的 sserver.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-24 JMS 資源屬性

server.xml 名稱	asadmin 名稱
jndi-name	name
res-type	resType
enabled	enabled
description	description

從實例 (server1) 中取得所有屬性：

asadmin> get server1.jms-resource.jms_resource_name.*

取得名為 res-type 的屬性：

asadmin> get server1.jms-resource.jms_resource_name.resType

將名為 enabled 的屬性設定為 true：

asadmin> set server1.jms-resource.jms_resource_name.enabled=true

persistence-manager-factory-resource

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-25 持續性管理程式 Factory 資源屬性

server.xml 名稱	asadmin 名稱
jndi-name	jndiName
jdbc-resource-jndi-name	JdbcResourceJndiName
factory-class	factoryClass
enabled	enabled
description	description

從實例 (server1) 中取得所有屬性：

asadmin> get server1.persistence-manager-factory-resource.jndi_name

取得名為 factoryClass 的屬性：

asadmin> get server1.persistence-manager-factory-resource.jndi_name.factoryClass

將名為 enabled 的屬性設定為 true：

asadmin> set server1.persistence-manager-factory-resource.jndi_name.enabled=true

mail-resource

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-26 Java 郵件資源屬性

server.xml 名稱	asadmin 名稱
jndi-name	name
enabled	enabled
store-protocol	storeProtocol
store-protocol-class	storeProtocolClass
transport-protocol	transportProtocol
transport-protocol-class	transportProtocolClass
host	host
user	user
from	from
debug	debug
description	description

從實例 (server1) 中取得所有屬性：

asadmin> get server1.mail-resource.jndi_name.*

取得名為 host 的屬性：

asadmin> get server1.mail-resource.jndi_name.host

將名為 enabled 的屬性設定為 true：

asadmin> set server1.mail-resource.jndi_name.enabled=true

application

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-27 應用程式屬性

server.xml 名稱	asadmin 名稱
name	name
location	location
virtual-servers	virtualServers
description	description
enabled	enabled

從實例 (server1) 中取得所有屬性：

asadmin> get server1.application.application_name.*

在應用程式中取得名為 location 的屬性：

asadmin> get server1.application.application_name.location

設定名為 location 的屬性：

asadmin> set server1.application.application_name.location=
"/export/home/as7se/as1/repository/applications/ASConverter"

ejb-module

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-28 EJB 模組屬性

server.xml 名稱	asadmin 名稱
name	name
location	location
description	description
enabled	enabled

取得實例 (server1) 中獨立 EJB 模組的所有屬性：

asadmin> get server1.ejb-module.ejb_jar_name.*

為實例 (server1) 取得應用程式中 EJB 模組的所有屬性：

asadmin> get server1.j2ee-application.application_name.ejb-module.ejb_jar_name.*

或

asadmin>get server1.application.application_name.ejb-module.ejb_jar_name.*

從獨立的 EJB 模組中取得名為 location 的屬性：

asadmin> get server1.ejb-module.ejb_jar_name.location

在應用程式的 EJB 模組中取得名為 location 的屬性：

asadmin> get server1.j2ee-application.application_name.ejb-module.ejb_jar_name.
location

或

asadmin> get server1.application.application_name.ejb-module.ejb_jar_name.location

在獨立的 EJB 模組中設定名為 location 的屬性：

asadmin> set server1.ejb-module.ejb_jar_name.location="/export/home/as7se/as1/repository/modules/ejb_jar_name"

在隨附於應用程式的 EJB 模組中設定名為 location 的屬性：

asadmin> set server1.j2ee-application.application_name.ejb-module.ejb_jar_name.
location="/export/home/as7se/as1/repository/modules/ejb_jar_name"

或

asadmin>set server1.application.application_name.ejb-module.ejb_jar_name.location="/export/home/as7se/as1/repository/modules/ejb_jar_name"

web-module

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-29 WEB 模組屬性

server.xml 名稱	asadmin 名稱
name	name
location	location
context-root	contextRoot
virtual-servers	virtualServers
description	description
enabled	enabled

取得實例 (server1) 中獨立 web 模組的所有屬性：

asadmin> get server1.web-module.web_war_name.*

為實例 (server1) 取得應用程式中 web 模組的所有屬性：

asadmin> get server1.web-module.application_name.web_war_name.*

從獨立的 web 模組中取得名為 location 的屬性：

asadmin> get server1.web-module.web_war_name.location

從應用程式的 web 模組中取得名為 location 的屬性：

asadmin> get server1.web-module.application_name.web_war_name.location

在獨立的 web 模組中設定名為 location 的屬性：

asadmin> set server1.web-module.war-ic.location=
"/export/home/as7se/as1/repository/modules/web_war_name"

在隨附於應用程式的 web 模組中設定名為 location 的屬性：

asadmin> set server1.web-module.application_name.web_war_name.location=
"/export/home/as7se/as1/repository/modules/web_war_name"

connector-module

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-30 連接器模組屬性

server.xml 名稱	asadmin 名稱
name	name
location	location
description	description
enabled	enabled

取得實例 (server1) 中獨立連接器模組的所有屬性：

asadmin> get server1.connector-module.connector_rar_name.*

從獨立的連接器模組中取得名為 location 的屬性：

asadmin> get server1.connector-module.connector_rar_name.location

在獨立的連接器模組中設定名為 location 的屬性：

asadmin> set server1.connector-module.connector_rar_name.location=
"/export/home/as7se/as1/repository/modules/connector_rar_name"

http-listener 或 http-server.http-listener

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-31 HTTP 偵聽程式屬性

server.xml 名稱	asadmin 名稱
id	id
address	address
port	port
family	family
acceptor-threads	acceptorThreads
blocking-enabled	blockingEnabled
security-enabled	securityEnabled
default-virtual-server	defaultVirtualServer
server-name	serverName
enabled	enabled
cert-nickname	cert
ssl2-enabled	ssl2
ssl2-ciphers	ssl2Ciphers
ssl3-enabled	ssl3
ssl3-tls-ciphers	ssl3Ciphers
tls-enabled	tls
tls-rollback-enabled	tlsRollback
client-auth-enabled	clientAuth

從實例 (server1) 中取得所有屬性：

asadmin> get server1.http-listener.http_listener_name.*

或

asadmin> get server1.http-server.http-listener.http_listener_name.*

取得名為 factory 的屬性：

asadmin> get server1.httpl-listener.http_listener_name.address

或

asadmin> get server1.http-server.http-listener.http_listener_name.address

將名為 address 的屬性設定為 0.0.0.0 IP 位址：

asadmin> set server1.http-listener.http_listener_name.address=0.0.0.0

或

asadmin> set server1.http-server.http-listener.http_listener_name.address=0.0.0.0

mime

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-32 MIME 類型屬性

server.xml 名稱	asadmin 名稱
id	id
file	file

從實例 (server1) 中取得所有屬性：

asadmin> get server1.mime.mime_name.*

取得名為 file 的屬性：

asadmin> get server1.mime.mime_name.file

將名為 file 的屬性設定為 mime.types：

asadmin> set server1.mime.mime_name.file=mime.types

acl

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-33 ACL 屬性

server.xml 名稱	asadmin 名稱
id	id
file	file

從實例 (server1) 中取得所有屬性：

asadmin> get server1.acl.acl_name.*

取得名為 file 的屬性：

asadmin> get server1.acl.acl_name.file

設定名為 file 的屬性：

asadmin> set server1.acl.acl_name.file=com/as1.acl

virtual-server

下表在左欄中顯示屬性的 server.xml 名稱，在右欄中顯示 asadmin 使用的名稱。

表格 A-34 虛擬伺服器屬性

server.xml 名稱	asadmin 名稱
id	id
http-listeners	httpListeners
config-file	configFile
default-object	defaultObject
accept-language	acceptLanguage
log-file	logFile
default-web-module	defaultWebModule
hosts	hosts
mime	mime
state	state
acls	acls
bandwidth-limit	bandwidthLimit
enforce-bandwidth-limit	enforceBandwidthLimit
connection-limit	connectionLimit
enforce-connection-limit	enforceConnectionLimit
property name="dir" value=	property.dir
property name="nice" value=	property.nice
property name="user" value=	property.user
property name="group" value=	property.group
property name="chroot" value=	property.chroot
property name="docroot" value=	property.docroot
property name="accesslog" value=	property.accesslog

從實例 (server1) 中取得所有屬性：

asadmin> get instance_name.virtual-server.vserver_id.*

例如︰

asadmin> get server1.virtual-server.server1.*

取得虛擬伺服器 server1 的名為 httpListeners 之屬性：

asadmin> get server1.virtual-server.server1.httpListeners

將名為 acceptLanguage 的屬性設定為 false：

asadmin> set server1.virtual-acceptLanguage=false

auth-db

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-35 認證資料庫屬性

server.xml 名稱	asadmin 名稱
id	id
database	database
basedn	basedn
certmaps	certmaps

從實例中取得所有屬性：

asadmin> get instancename.virtual-server.vserver_id.auth-db.authdb_id.*

例如，對於實例 server1，虛擬伺服器 server1：

asadmin> get server1.virtual-server.server1.auth-db.authdb_id.*

取得名為 database 的屬性：

asadmin> get server1.virtual-server.server1.auth-db.authdb_id.database

設定名為 database 的屬性：

asadmin> set server1.virtual-server.server1.auth-db.authdb_id.database=Oracle

authrealm

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-36 授權範圍屬性

server.xml 名稱	asadmin 名稱
name	name
classname	classname

從實例 (server1) 中取得所有屬性：

asadmin> get server1.authrealm.authrealm_id.*

取得名為 classname 的屬性：

asadmin> get server1.authrealm.authrealm_id.classname

設定名為 classname 的屬性：

asadmin> set server1.authrealm.authrealm_id.classname=com.sun.as.security.auth.realm.sharedpassword.SharedPasswordRealm

lifecycle-module

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-37 生命週期模組屬性

server.xml 名稱	asadmin 名稱
name	name
enabled	enabled
class-name	className
classpath	classPath
load-order	loadOrder
is-failure-fatal	isFailureFatal
description	description

從實例 (server1) 中取得所有屬性：

asadmin> get server1.lifecycle-module.lifecycle_module_id.*

為生命週期模組取得名為 className 的屬性：

asadmin> get server1.lifecycle-module.lifecycle_module_id.className

設定名為 className 的屬性：

asadmin> set server1.lifecycle-module.lifecycle_module_id.className=com.lifecycle_module_id.lifecycle

profiler

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-38 JVM 效能評測器配置屬性

server.xml 名稱	asadmin 名稱
name	name
classpath	classPath
native-library-path	nativeLibraryPath
enabled	enabled

從實例 (server1) 中取得所有屬性：

asadmin> get server1.profiler.*

取得名為 enabled 的屬性：

asadmin> get server1.profiler.enabled

將名為 enabled 的屬性設定為 false：

asadmin> set server1.profiler.enabled=false

server configuration (伺服器實例名稱)

下表在左欄中顯示屬性的 server.xml 名稱，右欄中顯示 asadmin 使用的名稱。

表格 A-39 伺服器配置屬性

server.xml 名稱	asadmin 名稱
instance-name	name
locale	locale
log-root	logRoot
session-store	sessionStore
application-root	applicationRoot
dynamic-reload-enabled	appDynamicReloadEnabled
dynamic-reload-poll-interval-in-seconds	appReloadPollInterval

從實例 (server1) 中取得所有屬性：

asadmin> get server1.*

取得名為 logRoot 的屬性：

asadmin> get server1.logRoot

設定名為 logRoot 的屬性：

asadmin> set server1.logRoot="/space/log"

長選項格式與短選項格式、預設值與對等的環境變數

下表列示指令行選項的長格式與短格式。如果沒有列示短格式，則此選項的短格式不可用。

表格 A-40 短選項與長選項、預設值與環境變數

選項名稱	長格式	短格式	預設值	環境變數
acceptlang	--acceptlang			AS_ADMIN_ACCEPT_
acceptorthreads	--acceptorthreads			AS_ADMIN_ACCEPTOR_THREADS
acls	--acls			AS_ADMIN_ACLS
address	--address			AS_ADMIN_ADDRESS
adminpassword	--adminpassword			AS_ADMIN_ADMINPASSWD
adminport	--adminport		4848	AS_ADMIN_ADMINPORT
adminuser	--adminuser			AS_ADMIN_ADMINUSER
basedn	--basedn			AS_ADMIN_BASEDN
blockingenabled	--blockingenabled			AS_ADMIN_BLOCKINGENABLED
bwlimit	--bwlimit			AS_ADMIN_BWLIMIT
certmaps	--certmaps			AS_ADMIN_CERTMAPS
certname	--certname			AS_ADMIN_CERTNAME
classname	--classname			AS_ADMIN_CLASSNAME
classpath	--classpath			AS_ADMIN_CLASSPATH
clientauthenabled	--clientauthenabled			AS_ADMIN_CLIENTAUTHENABLED
configfile	--configfile			AS_ADMIN_CONFIGFILE
connectionpoolid	--connectionpoolid			AS_ADMIN_CONNECTIONPOOLID
connlimit	--connlimit			AS_ADMIN_CONNLIMIT
contextroot	--contextroot			AS_ADMIN_CONTEXTROOT
database	--database			AS_ADMIN_DATABASE
debug	--debug		false	AS_ADMIN_DEBUG
defaultobj	--defaultobj			AS_ADMIN_DEFAULTOBJ
defaultwebmodule	--defaultwebmodule			AS_ADMIN_DEFAULTWEBMODULE
description	--description			AS_ADMIN_DESCRIPTION
discardmanualchanges	--discardmanualchanges	-d	false	AS_ADMIN_DISCARDMANUALCHANGES
echo	--echo	-e	false	AS_ADMIN_ECHO
enabled	--enabled			AS_ADMIN_ENABLED
enforcebwlimit	--enforcebwlimit			AS_ADMIN_ENFORCEBWLIMIT
enforceconnlimit	--enforceconnlimit			AS_ADMIN_ENFORCECONNLIMIT
failconnection	--failconnection		false	AS_ADMIN_FAILCONNECTION
failurefatal	--failurefatal		false	AS_ADMIN_FAILUREFATAL
family	--family			AS_ADMIN_FAMILY
file	--file	-f		AS_ADMIN_FILE
force	--force	-F	true	AS_ADMIN_FORCE
help	--help	-h		AS_ADMIN_HELP
host	--host	-H		AS_ADMIN_HOST
hosts	--hosts			AS_ADMIN_HOSTS
httplistenerid	--httplistenerid			AS_ADMIN_HTTPLISTENERID
httplisteners	--httplisteners			AS_HTTP_LISTENERS
idletimeout	--idletimeout		300	AS_ADMIN_IDLETIMEOUT
instance	--instance	-i	server1	AS_ADMIN_INSTANCE
instanceport	--instanceport			AS_ADMIN_INSTANCEPORT
interactive	--interactive	-I	true	AS_AMDIN_INTERACTIVE
isconnectvalidaterequired	--isconnectvalidaterequired		false	AS_ADMIN_ISCONNECTVALIDATEREQUIRED
jdbcjndiname	--jdbcjndiname	-a		AS_ADMIN_JDBCJNDINAME
jndilookupname	--jndilookupname	-l		AS_ADMIN_JNDILOOKUPNAME
keepmanualchanges	--keepmanualchanges	-k	false	AS_ADMIN_KEEPMANUALCHANGES
loadorder	--loadorder			AS_ADMIN_LOADORDER
local	--local	-l	false
logfile	--logfile			AS_ADMIN_LOGFILE
maxpoolsize	--maxpoolsize		32	AS_ADMIN_MAXPOOLSIZE
maxwait	--maxwait		6000	AS_ADMIN_MAXWAIT
mime	--mime			AS_ADMIN_MIME
mimefile	--mimefile			AS_ADMIN_MIMEFILE
monitor	--monitor	-m	false	AS_ADMIN_MONITOR
name	--name	-n		AS_ADMIN_NAME
nativelibpath	--nativelibpath			AS_ADMIN_NATIVELIBPATH
objtype	--objtype	-o		AS_ADMIN_OBJTYPE
password	--password	-w		AS_ADMIN_PASSWORD
poolresize	--poolresize		2	AS_ADMIN_POOLRESIZE
port	--port	-p	8000	AS_ADMIN_PORT
prefix	--prefix	-x		AS_ADMIN_PREFIX
printprompt	--printprompt	-P	true	AS_ADMIN_PROMPT
property	--property			AS_ADMIN_PROPERTY
securityenabled	--securityenabled			AS_ADMIN_SECURITYENABLED
servername	--servername			AS_ADMIN_SERVERNAME
ssl2ciphers	--ssl2ciphers			AS_ADMIN_SSL2CIPHERS
ssl2enabled	--ssl2enabled			AS_ADMIN_SSL2ENABLED
ssl3enabled	--ssl3enabled			AS_ADMIN_SSL3ENABLED
ssl3tlsciphers	--ssl3tlsciphers			AS_ADMIN_SSL3TLSCIPHERS
state	--state			AS_ADMIN_STATE
steadypoolsize	--steadypoolsize	8		AS_ADMIN_STEADYPOOLSIZE
storeprotocol	--storeprotocol			AS_ADMIN_STOREPROTOCOL
storeprotocolclass	--storeprotocolclass			AS_ADMIN_STOREPROTOCOLCLASS
tlsenabled	--tlsenabled			AS_ADMIN_TLSENABLED
tlsrollbackenabled	--tlsrollbackenabled			AS_ADMIN_TLSROLLBACKENABLED
transprotocol	--transprotocol		smtp	AS_ADMIN_TRANSPROTOCOL
type	--type			S_ADMIN_TRANSPROTOCOLCLASS
upload	--upload	-U	true	AS_ADMIN_TYPE
url	--url			AS_ADMIN_URL
user	--user	-u		AS_ADMIN_USER
validationmethod	--validationmethod		auto-commit	AS_ADMIN_VALIDATIONMETHOD
validationtable	--validationtable			AS_ADMIN_VALIDATIONTABLE
version	--version	-v		AS_AMDIN_VERSION
virtualserver	--virtualserver			AS_ADMIN_VIRTUALSERVER

上一個      目錄      索引      下一個

---

Copyright 2003 Sun Microsystems, Inc. 。版權所有。