启动管理工具

要启动管理工具，请执行 admin-tool.jar 文件：

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

java 命令通常位于目录 /usr/jdk/entsys-j2se/bin 中。

ServiceRegistry-base 的位置为 /opt/SUNWsrvc-registry（在 Solaris 操作系统上）或 /opt/sun/srvc-registry（在 Linux 和 HP-UX 系统上）。

您可以安全地忽略启动工具时显示的警告。

要退出管理工具，请使用 quit 命令。

批处理模式

要在批处理模式中运行管理工具，请在启动管理工具时在命令行中指定 -command 选项。

例如，以下命令将执行 ls 命令：

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

管理工具将把您的命令和工具的响应回显到屏幕上，然后在执行完命令后退出。

确保正确转义对 Shell 有效的所有字符。

交互式模式

要在交互式模式中运行管理工具，请在命令行中指定除了 -command 以外的任何选项（或不指定任何选项）来启动管理工具 Shell：

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

管理工具将显示以下提示符并等待您输入命令：

admin>

管理工具命令行选项

管理工具可以识别一般形式中列出且在选项中说明的命令行选项。

一般形式

选项

-alias

访问密钥库中的用户证书时使用的别名。请指定您在注册为用户时使用的别名。如果使用管理工具向 Registry 中发布数据，则需要此选项。

-command

在不从交互式 Shell 中获取命令的情况下运行的管理工具命令序列。使用分号 (;) 可以分隔多个命令。不必在 commands 中包括 quit 命令。如果需要不将分号用作命令分隔符，请在分号前加上一个反斜杠：

\;

运行管理工具的 Shell 可能需要使用另一个反斜杠来转义该反斜杠：

\\;

如果命令中包含空格，请把整个命令序列用单引号或双引号引起来，以使管理工具将该序列作为一个命令行参数而不是多个命令行参数进行处理。如果您的 Shell 还将分号解释为 Shell 命令的分隔符，则必须始终把多个管理工具命令序列用引号引起来。

-create

如果有必要，则创建由 -root 选项指定的注册表包 (RegistryPackage)，并根据需要创建任意个注册表包 (RegistryPackage) 父对象。仅当运行管理工具的用户被授权创建对象时，此选项才有效。

-debug

输出在调试时会有用的附加信息。

-help

提供这些选项的列表。

-keypass

访问密钥库中的用户证书时使用的密码。请指定您在注册为用户时使用的密码。如果使用管理工具向 Registry 中发布数据，则需要此选项。

-localdir

与本地文件系统中的文件相关的命令所使用的本地文件系统中的基本目录。

-locale

选择资源包时使用的语言环境（例如 en 或 fr），将使用该语言环境显示错误消息和状态消息。默认值由 Java 虚拟机 (Java Virtual Machine, JVM) 确定。

-registry

连接指向的 ebXML 注册表的 URL。默认值为 http://localhost:6480/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。

使用管理工具向 Registry 中发布内容

您可以使用某些管理工具命令向 Registry 中发布内容：例如 cp 和 import。此外，可以使用 rm 命令从 Registry 中删除内容。在使用这些命令之前，必须执行一些其他步骤。

使您自己向 Registry 中发布内容

1. 按照《Service Registry 3.1 用户指南》中的“创建用户帐户”中的说明执行用户注册。

   请记住您下载的 PKCS12 证书的位置，以及您指定的用户名和密码。

2. 启动管理工具：

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

3. 执行 keystoreMover 命令将 PKCS12 证书导出到 JKS 密钥库中。有关详细信息，请参见keystoreMover。

   通常，只需指定命令示例中显示的四个选项。

4. 停止管理工具：

   quit

5. 再次启动管理工具。这次，按如下方式指定选项：

   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 值是您在创建用户帐户时指定的别名和密码。

   要保存键入的内容，请创建脚本以执行此命令。