啟動 Admin Tool

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

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

java 指令通常位在 /usr/jdk/entsys-j2se/bin 目錄中。

ServiceRegistry-base 位於 Solaris 作業系統上的 /opt/SUNWsrvc-registry，若是 Linux 和 HP-UX 系統，則位於 /opt/sun/srvc-registry。

您可放心略過啟動工具時出現的警告訊息。

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

批次模式

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

例如，下列指令會執行 ls 指令：

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

Admin Tool 會將您的指令以及工具的回應，回應 (echo) 至螢幕上，然後在指令執行之後結束。

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

互動式模式

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

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

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

admin>

Admin Tool 指令行選項

Admin Tool 可辨識之指令行選項的清單和說明，請分別參閱提要和選項。

提要

選項

-alias

存取金鑰庫中的使用者憑證時要使用的別名。指定您註冊為使用者時所使用的別名。如果您要使用 Admin Tool 發佈資料到登錄 (Registry)，則需要此選項。

-command

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

\;

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

\\;

如果任何指令中含有空格，請以單引號或雙引號括住整個指令序列，工具便可將序列視為一個 (而非數個) 指令行參數。此外，如果 shell 也會將分號解譯為分隔 shell 指令，則您務必始終以引號括住多條 Admin Tool 指令的序列。

-create

如有必要，依需要建立 -root 選項指定的 Registry 套裝軟體 (RegistryPackage) 以及父系 Registry 套裝軟體 (RegistryPackage) 物件。僅當執行 Admin Tool 的使用者被授權建立物件時此選項才有效。

-debug

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

-help

提供這些選項的清單。

-keypass

存取金鑰庫中的使用者憑證時要使用的密碼。指定您註冊為使用者時所使用的密碼。如果您要使用 Admin Tool 發佈資料到 Registry，則需要此選項。

-localdir

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

-locale

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

-registry

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

-root

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

-sqlselect

執行 SQL-statement 以選取登錄 (Registry) 物件。敘述必須是以 select 起始的完整 SQL 敘述。SQL 敘述必須以引號括住，但不必以分號終止。如果您指定此選項，然後使用不帶引數的 select 指令，則該指令將執行 SQL-statement，直到您使用帶有 SQL-statement 以外其他引數的 select 指令為止。

-v | -verbose

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

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

使用 Admin Tool 將內容發佈到登錄 (Registry)

某些 Admin Tool 指令可用來將內容發佈到登錄 (Registry)：例如，cp 和 import。此外，rm 指令可用來刪除登錄 (Registry) 中的內容。使用這些指令之前，您必須執行某些額外的步驟。

讓您自己可以將內容發佈到登錄 (Registry)

1. 依照「Service Registry 3.1 使用者指南」中的「建立使用者帳號」一節的說明，執行使用者註冊。

   請記住您下載 PKCS12 憑證的位置，以及您指定的使用者名稱和密碼。

2. 啟動 Admin Tool：

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

3. 執行 keystoreMover 指令，將 PKCS12 憑證匯出至 JKS 金鑰庫。如需詳細資訊，請參閱keystoreMover。

   一般而言，您只需要指定指令範例中所顯示的四個選項。

4. 停止 Admin Tool：

   quit

5. 再次啟動 Admin Tool。此時指定選項，如下所示：

   java -Djaxr-ebxml.security.storetype=JKS \ -Djaxr-ebxml.security.keystore=security/filename \ -Djaxr-ebxml.security.storepass=ebxmlrr \ -jar ServiceRegistry-base/lib/admin-tool.jar -alias alias -keypass password

   其中 filename 是憑證檔案的名稱，通常是 keystore.jks。位置 security/filename 與目錄 $HOME/soar/3.0/jaxr-ebxml 相關。alias 和 password 值是您在建立使用者帳號時指定的值。

   若要節省鍵入的時間，可建立程序檔執行此指令。