若要啟動 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 發佈資料到登錄 (Registry),則需要此選項。
要執行 (而非從互動式 shell 取得指令) 的 Admin Tool 指令序列。使用分號 (;) 分隔多條指令。您不需要在 commands 中包含 quit 指令。如果您需要使用分號 (不是指令分隔符),請在分號前加反斜線︰
\; |
執行 Admin Tool 的 shell 可能需要您使用另一個反斜線來退出此反斜線︰
\\; |
如果任何指令中含有空格,請以單引號或雙引號括住整個指令序列,工具便可將序列視為一個 (而非數個) 指令行參數。此外,如果 shell 也會將分號解譯為分隔 shell 指令,則您務必始終以引號括住多條 Admin Tool 指令的序列。
如有必要,依需要建立 -root 選項指定的 Registry 套裝軟體 (RegistryPackage) 以及父系 Registry 套裝軟體 (RegistryPackage) 物件。僅當執行 Admin Tool 的使用者被授權建立物件時此選項才有效。
輸出有助於除錯的附加資訊。
提供這些選項的清單。
存取金鑰庫中的使用者憑證時要使用的密碼。指定您註冊為使用者時所使用的密碼。如果您要使用 Admin Tool 發佈資料到 Registry,則需要此選項。
與本機檔案系統中的檔案相關的指令在本機檔案系統中的基底目錄。
要用於選取資源束以用於錯誤和狀態訊息的語言環境 (例如,en 或 fr)。預設的語言環境由 Java 虛擬機器 (JVM) 決定。
要連線至的 ebXML Registry 的 URL。預設為 http://localhost:6480/soar/registry/soap。
Registry 套裝軟體 (RegistryPackage) 的定位器 (例如 /registry/userData),該定位器將用作將儲存庫視為 Registry 套裝軟體 (RegistryPackage) 物件 (每個均含有其他 RegistryObject 和 Registry 套裝軟體 (RegistryPackage) 物件) 之樹狀結構的指令的基底。預設為針對所有使用者資料定義的 Registry 套裝軟體 (RegistryPackage)︰/registry/userData。
執行 SQL-statement 以選取登錄 (Registry) 物件。敘述必須是以 select 起始的完整 SQL 敘述。SQL 敘述必須以引號括住,但不必以分號終止。如果您指定此選項,然後使用不帶引數的 select 指令,則該指令將執行 SQL-statement,直到您使用帶有 SQL-statement 以外其他引數的 select 指令為止。
指定狀態訊息的詳細輸出。
-help 選項的輸出列出此發行版本不支援的兩個選項︰-class 和 -property。
某些 Admin Tool 指令可用來將內容發佈到登錄 (Registry):例如,cp 和 import。此外,rm 指令可用來刪除登錄 (Registry) 中的內容。使用這些指令之前,您必須執行某些額外的步驟。
依照「Service Registry 3.1 使用者指南」中的「建立使用者帳號」一節的說明,執行使用者註冊。
請記住您下載 PKCS12 憑證的位置,以及您指定的使用者名稱和密碼。
啟動 Admin Tool:
java -jar ServiceRegistry-base/lib/admin-tool.jar |
執行 keystoreMover 指令,將 PKCS12 憑證匯出至 JKS 金鑰庫。如需詳細資訊,請參閱keystoreMover。
一般而言,您只需要指定指令範例中所顯示的四個選項。
停止 Admin Tool:
quit |
再次啟動 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 值是您在建立使用者帳號時指定的值。
若要節省鍵入的時間,可建立程序檔執行此指令。