啟動 Admin Tool

若要啟動 Admin Tool，請執行 admin-tool.jar 檔案︰

java -jar ServiceRegistry-base/lib/admin-tool.jar [options]...

在 Solaris 作業環境中，ServiceRegistry-base 位置為 /opt/SUNWsoar；在 Linux 系統上，位置為 /opt/sun/SUNWsoar。

請忽略啟動此工具時顯示的警告，這些警告不太重要。

若要結束 Admin Tool，請使用 quit 指令。

若要執行限於管理員的指令，您需要在指令行中指定憑證檔案 (即金鑰庫) 的類型、位置和密碼，如下所示 (全部位於同一行)︰

java -Djaxr-ebxml.security.storetype=PKCS12 \
-Djaxr-ebxml.security.keystore=security/filename.p12 \
-Djaxr-ebxml.security.storepass=password -jar admin-tool.jar

其中，filename 為憑證檔案的根名稱 (依預設為 generated-key)，password 為建立憑證時指定用來保護此檔案的密碼。位置 security/filename.p12 是目錄 $HOME/soar/3.0/jaxr-ebxml 的相對目錄。

若要省去鍵入作業，請建立程序檔來執行此指令。

批次模式

若要在批次模式中執行 Admin Tool，請在啟動 Admin Tool 時於指令行中指定 -command 選項。

例如，以下指令可執行 ls 指令︰

java -jar ServiceRegistry-base/lib/admin-tool.jar -command "ls *.html"

Admin Tool 會在螢幕上回應您的指令和工具的回應，然後在指令執行之後結束。

請確定正確退出對 shell 有重要意義的所有字元。

互動式模式

若要在互動式模式中執行 Admin Tool，請透過在指令行指定除 -command 之外的任何選項 (或不指定選項)，來啟動 Admin Tool shell。

java -jar ServiceRegistry-base/lib/admin-tool.jar

Admin Tool 會顯示以下提示並等待您的輸入︰

admin>

Admin Tool 指令行選項

Admin Tool 可識別在提要中列出並在選項中說明的指令行選項。

提要

選項

-alias

存取金鑰庫中的使用者憑證時要使用的別名。指定您註冊為使用者時所使用的別名。

-command

要執行的 Admin Tool 指令序列 (而非從互動式 shell 取得指令) 。使用分號 (;) 分隔多條指令。不必在 commands 中包含 quit 指令。如果您需要使用不是指令分隔符的分號，請在分號前加反斜線︰

\;

執行 Admin Tool 的 shell 可能需要您使用另一個反斜線來退出此反斜線︰

\\;

如果任何指令中含有空格，請為整個指令序列加上單引號或雙引號，以便工具將序列視為一個 (而非數個) 指令行參數。如果 shell 亦將分號解譯為分隔 shell 指令，您必須始終將多條 Admin Tool 指令的序列置於引號之中。

-create

如有必要，依需要建立 -root 選項指定的 RegistryPackage 以及任何父系 RegistryPackage 物件。僅當執行 Admin Tool 的使用者有權建立物件時此選項才有效。

-debug

輸出有助於除錯的附加資訊。

-help

提供這些選項的清單。

-keypass

存取金鑰庫中的使用者憑證時要使用的密碼。指定您註冊為使用者時所使用的密碼。

-localdir

與本機檔案系統中的檔案相關的指令在本機檔案系統中的基底目錄。

-locale

要用於選取資源束以用於錯誤和狀態訊息的語言環境 (例如，en 或 fr)。預設的語言環境由 Java 虛擬機器 (JVM) 決定。

-registry

要連線至的 ebXML Registry 的 URL。預設為 http://localhost:6060/soar/registry/soap。

-root

RegistryPackage 的定位器 (例如 /registry/userData)，該定位器用作將儲存庫視為 RegistryPackage 物件 (每個物件均含有其他 RegistryObject 和 RegistryPackage 物件) 之樹狀結構的指令的基底。預設是為所有使用者的資料定義的 RegistryPackage︰/registry/userData。

-sqlselect

執行 SQL_statement 以選取 Registry 物件。敘述應為以 select 起始的完整 SQL 敘述。SQL 敘述必須加上引號，但不必以分號終止。如果您指定此選項，然後使用沒有引數的 select 指令，則該指令將執行 SQL_statement，直到您使用帶有除 SQL_statement 之外的引數的 select 指令。

-v | -verbose

指定狀態訊息的詳細輸出。

-help 選項的輸出列出此發行版本不支援的兩個選項︰-class 和 -property。