启动管理工具

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

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

在 Solaris 操作环境中，ServiceRegistry-base 位于 /opt/SUNWsoar，在 Linux 系统中，ServiceRegistry-base 位于 /opt/sun/SUNWsoar。

忽略您启动工具时显示的警告；这些警告并不重要。

要退出管理工具，请使用 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 目录的位置。

要节省输入，请创建一个脚本来执行这个命令。

批处理模式

要在批处理模式中运行管理工具，请在启动管理工具时在命令行中指定 -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

访问密钥库中的用户证书时使用的别名。请指定您在注册为用户时使用的别名。

-command

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

\;

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

\\;

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

-create

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

-debug

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

-help

提供这些选项的列表。

-keypass

访问密钥库中的用户证书时使用的密码。请指定您在注册为用户时使用的密码。

-localdir

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

-locale

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

-registry

连接指向的 ebXML Registry 的 URL。默认 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。