第 2 章 使用管理工具

本章介绍了如何使用 Service Registry 的管理工具（“管理工具”）。

本章包括以下内容：

• 关于管理工具

• 启动管理工具

• 管理工具功能

• 使用管理工具命令

关于管理工具

Service Registry 管理工具提供了一个简单的命令行界面，可用于执行公用管理任务（例如，向 Registry 中添加关联和从 Registry 中删除对象）。

该工具能够以两种模式运行：

• 在批处理模式中，可以在工具的命令行中指定一个或多个命令。

• 在交互式模式中，可以在工具的交互式 Shell 中输入命令。

某些命令（例如 ls 和 rm）模仿了众所周知的用于操作文件和文件夹的 UNIX® 命令的名称和行为。其他命令没有相应的等效 UNIX 命令。

启动管理工具

要启动管理工具，请执行 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。

管理工具功能

此部分介绍了管理工具的以下功能：

• 权限

• 显示异常

• 识别 Registry 对象

• 语言环境对指定名称的影响

• 区分大小写

权限

使用管理工具时，您只能执行在启动工具时指定其主别名和密码的用户可以执行的操作。只有具有系统管理员角色的用户才能执行特定的命令（例如 chown）。有关详细信息，请参见创建管理员。

显示异常

使用管理工具可以使您避免在命令失败时查看较长的堆栈追踪。

当命令失败时，管理工具将打印堆栈追踪的第一行及以下消息：

An error occurred when executing the function.  Use the show exception 
command to view messages.

如果需要更多信息，则接着执行 show exception 命令以查看完整的堆栈追踪。

show exception 命令用于始终显示紧接在前面的命令的堆栈追踪。

识别 Registry 对象

识别 Registry 对象的主要方法是通过名称来识别。但是，识别 RegistryPackage 对象通常是通过从 registry 根到 RegistryPackage 的路径来识别。例如，/registry/userData 是指向 userData RegistryPackage 的路径。

匹配某些名称时可以使用通配符。使用问号 (?) 来匹配单个字符。使用星号 (*) 来匹配零个或多个字符。

一些命令（例如 cd 和 chown）支持通过对象的统一资源名称 (Uniform Resource Name, URN)（必须以 urn: 为开头）来对其进行识别。例如，urn:uuid:2702f889-3ced-4d49-82d1-e4cd846cb9e4 就是一个有效的 URN。

chown 命令还支持使用 %number 来引用上一个 users 命令列出的 User。

对于某些命令，您可以输入包含空格的名称，方法为把整个名称用双引号引起来，或在名称中的每个空格前加一个反斜杠。

select 命令支持使用 SQL 通配符：百分号 (%) 用于匹配多个字符，下划线 (_) 用于匹配单个字符。

语言环境对指定名称的影响

一个 RegistryObject（或 RegistryPackage）可以有多个名称，每个名称又可与不同的语言环境相关联。

您指定的路径和对象名称仅是针对当前语言环境求得的结果。当您尝试按名称选择具有多个名称的 Registry 对象时，Registry 仅尝试根据 Registry 对象的一个名称（其语言环境与当前语言环境的匹配程度最接近的选项）来对您提供的名称进行匹配，而不根据 Registry 对象的所有多个名称进行匹配。

例如，假定当前 RegistryPackage 有一个成员对象具有两个名称，每个名称与不同的语言环境相关联：en（英语）语言环境中的 red 和 fr（法语）语言环境中的 rouge。在当前语言环境为 en 时，命令 ls rouge 不显示该成员对象，但在语言环境为 fr（或其变形之一）时，则显示该成员对象。

区分大小写

管理工具识别的命令名称和字符参数不区分大小写。例如，ls、Ls 和 LS 是等效的。

赋值的选项将被逐字地传递给使用该选项的代码。

使用管理工具命令

下面几个部分将介绍可用的命令。对于每个命令，选项和操作数的一般形式和说明遵守以下印刷约定：

• Italics 表示一个选项参数或操作数，它应由运行命令时的实际值替代。

• 大括号 ({ }) 用于限定一组选项或操作数，您必须在命令中包括其中的一项。用垂直条 (|) 分隔选项或操作数。

• 方括号 ([ ]) 用于限定一个或一组选项或操作数，您可以省略其中的项目。

• 选项或操作数之后的省略号 (...) 表示可以重复使用该参数或操作数。

其他内容是运行命令时必须包括的字符文本。

add association

向 Registry 中添加 Association 对象。

一般形式

说明

add association 命令用于向 Registry 中添加指定类型的 Association 对象。您可以使用以下类型：

• AccessControlPolicyFor

• AffiliatedWith（拥有 EmployeeOf 和 MemberOf 子概念）

• Contains

• ContentManagementServiceFor

• EquivalentTo

• Extends

• ExternallyLinks

• HasFederationMember

• HasMember

• Implements

• InstanceOf

• InvocationControlFileFor（拥有 CatalogingControlFileFor 和 ValidationControlFileFor 子概念）

• OffersService

• OwnerOf

• RelatedTo

• Replaces

• ResponsibleFor

• SubmitterOf

• Supersedes

• Uses

选项

-type

Association 对象的类型。

操作数

sourceURN

源对象的 URN。

targetURN

目标对象的 URN。

示例

以下命令（全都在一行）将在具有两个指定 URN 的对象之间创建 RelatedTo 关系。

admin> add association -type RelatedTo 
urn:uuid:ab80d8f7-3bea-4467-ad26-d04a40045446 
urn:uuid:7a54bbca-2131-4a49-8ecc-e7b4ac86c4fd

add user

向 Registry 中添加用户。

一般形式

说明

add user 命令用于添加 User 对象。通常，User 对象至少包含一个 PostalAddress、TelephoneNumber 和 EmailAddress 对象。

在命令行中或通过使用 -load 选项指定含有信息的 Java 属性文件来指定有关用户的信息。将按照信息选项和 -load 选项在命令行中显示的顺序求值。例如，您可以在命令行中指定一些属性，从某个属性文件中装入其他属性，然后用后面的命令行选项覆盖该属性文件中的信息。

您最多可以为一个新用户指定三组地址、电话号码和电子邮件地址。如果需要指定更多信息，您可以在以后使用 Web 控制台或 JAXR 来添加。

当您指定地址、电话号码或电子邮件地址时，必须提供针对其类型的值：例如，-emailType OfficeEmail。

您可以在命令行中使用简写选项（例如 -fn）以提供每个用户需要的一些通用信息。但是，当您在属性文件中提供信息时，必须使用选项的完整形式。例如，您可以在命令行中使用 -email1.address、-emailAddress 或 -email 指定用户的第一个电子邮件地址。但是，当您在属性文件中指定第一个电子邮件地址时，必须使用 email1.address=。由于用户的第二个电子邮件地址只有一个选项，因此在命令行中必须使用 -email2.address，在属性文件中必须使用 email2.address=。

如果指定了 -edit 选项，管理工具将启动编辑器，以使您可以编辑新用户的信息。有关详细信息，请参见选项说明。

使用 -load 装入或使用 -edit 编辑的属性文件使用 IS0-8859-1 字符集，就象所有 Java 属性文件一样。有关如何在属性文件中表示不属于 ISO-8859-1 的字符的详细信息，请参见 java.util.Properties.load(InputStream) 文档。

选项

-edit

使管理工具启动编辑器，以使您可以编辑新用户的信息。计算其他命令行参数之后，该工具将启动编辑器。因此，将启动编辑程序以便求得在命令行或属性文件中指定的所有信息的值。编辑程序必须在不出错的情况下终止，然后命令才能继续执行。管理工具将启动由 set editor 命令指定的编辑器（请参见set）；默认情况下，此编辑器为 vi 编辑器。

---

注 –

在此版本中，-edit 可与 emacsclient 和 NetBeans^TM 命令 bin/runide.sh --open 结合使用（但效果不是很好），但还不能与 vi 结合使用。

---

-load

指定用于指定用户属性的 Java 属性文件。属性名称与 add user 命令选项的长型名称（例如 lastName 和 post1.type）相同。

-fn | -firstName

指定用户的名字。

-ln | -lastName

指定用户的姓氏。姓氏是必需的信息，必须在命令行或属性文件中指定姓氏。

-mn | -middleName

指定用户的中间名。

-alias

访问密钥库中的用户证书时使用的别名。此选项是必需的。别名的长度不能少于三个字符。

-keypass

访问密钥库中的用户证书时使用的密码。此选项是必需的。密码的长度不能少于六个字符。

-postalType | -post1.type

第一个 PostalAddress 的类型。类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串（例如 Office 或 Home）。

-city | -post1.city

第一个 PostalAddress 的城市。

-country | -post1.country

第一个 PostalAddress 的国家/地区。

-postalCode | -postcode | - zip | -post1.postalcode

第一个 PostalAddress 的邮政编码。

-stateOrProvince | -state | - province | -post1.stateOrProvince

第一个 PostalAddress 的省/自治区/直辖市。

-street | -post1.street

第一个 PostalAddress 的街道名称。

-streetNumber | -number | - -post1.streetNumber

第一个 PostalAddress 的门牌号码。

-post2.type

第二个 PostalAddress 的类型。如果指定了第二个 PostalAddress，则类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串（例如 Office 或 Home）。

-post2.city

第二个 PostalAddress 的城市。

-post2.country

第二个 PostalAddress 的国家/地区。

-post2.postalcode

第二个 PostalAddress 的邮政编码。

-post2.stateOrProvince

第二个 PostalAddress 的省/自治区/直辖市。

-post2.street

第二个 PostalAddress 的街道名称。

-post2.streetNumber

第二个 PostalAddress 的门牌号码。

-post3.type

第三个 PostalAddress 的类型。如果指定了第三个 PostalAddress，则类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串（例如 Office 或 Home）。

-post3.city

第三个 PostalAddress 的城市。

-post3.country

第三个 PostalAddress 的国家/地区。

-post3.postalcode

第三个 PostalAddress 的邮政编码。

-post3.stateOrProvince

第三个 PostalAddress 的省/自治区/直辖市。

-post3.street

第三个 PostalAddress 的街道名称。

-post3.streetNumber

第三个 PostalAddress 的门牌号码。

-phoneType | -telephone1.type

第一个 TelephoneNumber 的类型。类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串，但您可以指定下面的一种已知类型：Beeper、FAX、HomePhone、MobilePhone 或 OfficePhone。

-areaCode | -telephone1.areaCode

第一个 TelephoneNumber 的区号。

-countryCode | -telephone1.countryCode

第一个 TelephoneNumber 的国家/地区代码。

-extension | -telephone1.extension

第一个 TelephoneNumber 的分机。

-number | -telephone1.number

第一个 TelephoneNumber 的电话号码后缀（不包括国家/地区代码或区号）。该号码是必需的信息，必须在命令行或属性文件中指定该号码。

-URL | -telephone1.URL

第一个 TelephoneNumber 的 URL（可以在网上拨打此号码的 URL）。

-telephone2.type

第二个 TelephoneNumber 的类型。如果指定了第二个 TelephoneNumber，则类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串，但您可以指定下面的一种已知类型：Beeper、FAX、HomePhone、MobilePhone 或 OfficePhone。

-telephone2.areaCode

第二个 TelephoneNumber 的区号。

-telephone2.countryCode

第二个 TelephoneNumber 的国家/地区代码。

-telephone2.extension

第二个 TelephoneNumber 的分机。

-telephone2.number

第二个 TelephoneNumber 的电话号码后缀（不包括国家/地区代码或区号）。如果指定了第二个 TelephoneNumber，则该号码是必需的信息，必须在命令行或属性文件中指定该号码。

-telephone2.URL

第二个 TelephoneNumber 的 URL（可以在网上拨打此号码的 URL）。

-telephone3.type

第三个 TelephoneNumber 的类型。如果指定了第三个 TelephoneNumber，则类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串，但您可以指定下面的一种已知类型：Beeper、FAX、HomePhone、MobilePhone 或 OfficePhone。

-telephone3.areaCode

第三个 TelephoneNumber 的区号。

-telephone3.countryCode

第三个 TelephoneNumber 的国家/地区代码。

-telephone3.extension

第三个 TelephoneNumber 的分机。

-telephone3.number

第三个 TelephoneNumber 的电话号码后缀（不包括国家/地区代码或区号）。如果指定了第三个 TelephoneNumber，则该号码是必需的信息，必须在命令行或属性文件中指定该号码。

-telephone3.URL

第三个 TelephoneNumber 的 URL（可以在网上拨打此号码的 URL）。

-emailType | -email1.type

第一个 EmailAddress 的类型。类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串，但您可以指定下面的一种已知类型：HomeEmail 或 OfficeEmail。

-emailAddress | -email | - email1.address

第一个电子邮件地址。第一个电子邮件地址是必需的信息。

-email2.type

第二个 EmailAddress 的类型。如果指定了第二个 EmailAddress，则类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串，但您可以指定下面的一种已知类型：HomeEmail 或 OfficeEmail。

-email2.address

第二个电子邮件地址。

-email3.type

第三个 EmailAddress 的类型。如果指定了第三个 EmailAddress，则类型是必需的信息，必须在命令行或属性文件中指定类型。该值是一个任意字符串，但您可以指定下面的一种已知类型：HomeEmail 或 OfficeEmail。

-email3.address

第三个电子邮件地址。

示例

以下命令将从用户主目录的 JaneSmith.properties 文件中装入 User 属性。

admin> add user -load ~/JaneSmith.properties

以下命令（全都在一行）将指定创建 User 对象所必需的最少属性。

admin> add user -ln Smith -postaltype Office -country US 
-phonetype Office -number 333-3333 -emailtype OfficeEmail 
-emailaddress JaneSmith@JaneSmith.com -alias 123 -keypass 123456

cd

更改 RegistryPackage 的位置。

一般形式

说明

cd 命令将目录（广义的）更改到指定路径处或具有指定 URN 的 RegistryPackage。

当多个 RegistryPackage 对象以相同路径存在（对于当前语言环境）时，该命令将更改到指定的 URN。

操作数

locator

从系统信息库的根目录到系统信息库中某个对象的 Registry 对象名称的路径，每个名称前加上一个正斜杠 (/)。

例如，属于 registry RegistryPackage（其本身不是任何 RegistryPackage 的成员）成员的 userData RegistryPackage 的定位器为 /registry/userData。属于 userData RegistryPackage 成员的 folder1 RegistryPackage 的定位器为 /registry/userData/folder1。

URN

RegistryPackage 的 URN，必须是以 urn: 为开头的 URN。

示例

以下命令将目录更改到 URN 为 urn:uuid:92d3fd01-a929-4eba-a5b4-a3f036733017 的 RegistryPackage。

admin> cd urn:uuid:92d3fd01-a929-4eba-a5b4-a3f036733017

以下命令将把目录更改到位置 /registry/userData/myData。

admin> cd /registry/userData/myData

chown

更改 RegistryObject 的所有者。

一般形式

说明

chown 命令用于把前面的 select 命令所选取的对象的拥有权更改到前面的 users 命令列出时通过 URN 或引用用户的 URN 指定的用户。

只有具有管理员角色的用户才能成功地执行此命令。

操作数

URN

URN 指定的 User 对象。

%index

在前面的 users 命令中列出的 User 对象的 URN 的数字引用。

示例

以下命令将把选定对象的拥有权更改到 URN urn:uuid:26aa17e6-d669-4775-bfe8-a3a484d3e079 所指定的用户。

admin> chown urn:uuid:26aa17e6-d669-4775-bfe8-a3a484d3e079

以下命令将把选定对象的拥有权更改到前面的 users 命令中的编号为 2 的用户。

admin> chown %2

cp

将文件和文件夹复制到 Registry 中。

一般形式

说明

cp 命令将文件夹和文件分别作为 RegistryPackage 和 ExtrinsicObject 对象复制到 Registry 中。

从其中复制文件和文件夹的本地文件系统中的本地目录默认为启动管理工具的当前目录。启动管理工具时，您可以使用 -localdir 选项更改本地目录。管理工具启动后，您可以使用 lcd 命令更改本地目录。您可以使用 show localdir 命令获取当前本地目录的绝对路径。

该命令是递归命令。即，如果指定一个目录，则该命令将复制该目录下的所有文件和文件夹。

选项

-owner

将复制的 Registry 对象的拥有者设置为通过 URN 或 %index 参数指定的用户。有关这些参数的说明，请参见 chown 命令的说明。您必须具有管理员角色才能指定您之外的拥有者。

-exclude

复制其文件名不包含指定模式的所有文件，其中 pattern 是由文字字符和特殊字符星号 (*)（表示零个或多个字符）和问号 (?)（表示一个字符，且仅表示一个字符）组成的模式。

可以多次指定此选项。

-include

复制其文件名包含指定模式的所有文件，其中 pattern 是由文字字符和特殊字符星号 (*)（表示零个或多个字符）和问号 (?)（表示一个字符，且仅表示一个字符）组成的模式。

可以多次指定此选项。

操作数

pattern

要复制的文件或文件夹，通过由文字字符和特殊字符星号 (*)（表示零个或多个字符）和问号 (?)（表示一个字符，且仅表示一个字符）组成的模式指定。可以指定多个 pattern。

示例

以下命令将把目录 mydir 复制到 Registry，以将其归前面的 users 命令中编号为 4 的用户拥有。

admin> cp -owner %4 mydir

以下命令将把目录 mydir 复制到 Registry 中（以字符串 .z 或 .c 结尾的文件和目录除外）。

admin> cp mydir -exclude \\.z -exclude \\.c

echo

回显字符串。

一般形式

说明

echo 命令用于将指定的 string 回显到输出中。在以批处理模式运行管理工具时，如果您在 -command 选项中指定此命令会十分有用。

操作数

string

一个字符序列。

示例

以下命令将把日期和 ls 命令的结果打印到日志文件中。

java -jar admin-tool.jar -command "echo ”date”; ls" > admin.log

help

显示关于命令的信息。

一般形式

说明

help 命令用于显示关于可用命令或指定命令的信息。

对于具有子命令（例如 add 和 show）的命令，help 命令将显示关于子命令的信息。

如果不指定参数，help 命令将显示所有命令的用法信息。

操作数

command_name

管理工具命令的名称。

示例

以下命令将显示所有命令的用法信息。

admin> help

以下命令将显示 lcd 命令的用法信息。

admin> help lcd

以下命令将显示 add 子命令的用法信息。

admin> help add

lcd

更改本地文件系统中的当前目录。

一般形式

说明

lcd 命令用于更改本地文件系统中的当前本地目录。

如果不指定参数，lcd 命令将把当前目录更改到您的默认主目录。

操作数

path_name

目录名称，可以是绝对目录，也可以是相对目录。

示例

以下命令将把当前本地目录更改到 /usr/share 目录。

admin> lcd /usr/share

以下命令将把当前本地目录更改到本地文件系统中的默认主目录。

admin> lcd

ls

列出当前 RegistryPackage 中的对象。

一般形式

说明

不带有参数的情况下，ls 命令将列出当前 RegistryPackage 中的对象。如果提供了 pattern 或 URN，该命令将列出当前 RegistryPackage 中其名称（在当前语言环境中）或唯一标识符与 pattern 或 URN 匹配的对象。

操作数

pattern

由文字字符和特殊字符星号 (*)（表示零个或多个字符）和问号 (?)（表示一个字符，且仅表示一个字符）组成的模式。可以指定多个 pattern。

URN

以 urn: 为开头的 URN，例如 urn:uuid:4a6741e7-4be1-4cfb-960a-e5520356c4fd。可以指定多个 URN。URN 必须是对象的唯一标识符（不能是逻辑标识符）。

示例

以下命令将列出当前 RegistryPackage 中的所有对象。

admin> ls

以下命令将列出名称与模式 urn:bird:poultry:chicken 相匹配或 ID 为 urn:bird:poultry:chicken 的所有对象。

admin> ls urn:bird:poultry:chicken

以下命令将列出名称与模式 *bird* 相匹配的所有对象。（如果 *bird* 是有效 ID，该命令还将列出 ID 为 *bird* 的对象。）

admin> ls *bird*

以下命令将列出名称与模式 *bird* 或 urn:bird:poultry:chicken 相匹配或 ID 为 urn:bird:poultry:chicken 的所有对象。

admin> ls *bird* urn:bird:poultry:chicken

pwd

显示指向当前 RegistryPackage 的路径。

一般形式

说明

pwd 命令用于使用与当前语言环境匹配度最好的名称显示指向当前 RegistryPackage 的路径，该命令还用于显示路径的语言环境。

示例

admin> pwd
(en_US) /registry/userData

quit

退出管理工具。

一般形式

说明

quit 命令用于退出管理工具。

示例

admin> quit

rm

从 RegistryPackage 中删除对象。

一般形式

说明

rm 命令用于删除当前 RegistryPackage 中名称（当前语言环境中）与 pattern 或 URN 指定的模式相匹配的成员对象。

如果匹配的 RegistryObject 是多个 RegistryPackage 对象的成员，则此命令仅删除当前 RegistryPackage 与该对象之间的关联。仅当删除关联后该对象与任何其他 RegistryObject 都没有关联时才从 Registry 中删除该对象。

如果匹配的成员对象本身是一个包含其他对象的 RegistryPackage，则除非指定 -r 选项或 -d 选项，否则该对象和当前 RegistryPackage 与成员 RegistryPackage 之间的关联都不会被删除。

同时指定 -d 和 -r 选项时将递归应用 -d 选项，因此无论是否有其他关联，所有由 -r 选取的对象（及其关联）都将被删除。

选项

-d

删除当前 RegistryPackage 与指定 RegistryPackage 之间的关联。仅当指定的 RegistryPackage 仅剩下与其成员对象之间的关联时才将前者删除。对于立即删除的 RegistryPackage 的成员对象，它们并非其他 HasMember 关联的目标，现在可以作为 Registry 根的成员来访问它们了。

-r

删除指定的 RegistryPackage 对象及其所有的子对象（对象具有其他关联时除外）。

操作数

pattern

由文字字符和特殊字符星号 (*)（表示零个或多个字符）和问号 (?)（表示一个字符，且仅表示一个字符）组成的模式。可以指定多个 pattern。

URN

以 urn: 为开头的 URN，例如 urn:uuid:4a6741e7-4be1-4cfb-960a-e5520356c4fd。可以指定多个 URN。

示例

以下命令将删除包含字符串 "stat" 的所有 RegistryPackage 对象及其所有子对象。

admin> rm -r *stat*

select

执行一个 SQL select 语句。

一般形式

说明

select 命令用于选取并列出通过将整条命令作为一个 SQL 查询执行所指定的对象。如果不指定参数，该命令将列出由前面的 select 命令或 sqlselect 选项选取的所有对象。

操作数

SQL

SQL select 语句（前面无需加 select，因为已经以命令名称的方式提供了该语句）。

示例

以下命令将列出 Registry 中的所有 ClassificationScheme 对象：

admin> select s.* from ClassificationScheme s

set

设置属性值。

一般形式

说明

set 命令用于设置管理工具 Shell 的属性的值。

管理工具支持以下属性和值。

启用或禁用调试信息的输出。

设置在管理工具启动交互式编辑器时使用的命令。在 UNIX 和 Linux 系统上的默认值为 /bin/vi。

启用或禁用执行命令时更详细的消息输出。

操作数

property

下列属性之一：debug、editor、verbose。

value

指定的属性所支持的值。有关详细信息，请参见“说明”部分。

示例

以下命令将把编辑器设置为 /usr/bin/vi，而不是默认的 /bin/vi。

admin> set editor /usr/bin/vi

以下命令将启用调试。

admin> set debug true

以下命令将禁用详细输出。

admin> set verbose off

show

显示属性值。

一般形式

说明

show 命令用于显示管理工具 Shell 的属性的值。

如果不指定参数，此命令将显示所有属性的值。

此命令支持以下属性：

debug

是否启用调试输出。

editor

管理工具启动交互式编辑器时使用的编辑器。

exception

从前面刚执行的命令返回的异常堆栈追踪（如果有）。

localdir

本地文件系统中的当前目录。使用 lcd 命令设置此属性。有关详细信息，请参见lcd。

locale

当前语言环境。

verbose

是否启用详细输出。

操作数

property

要显示其当前值的属性。可以显示 exception 和 locale 属性，但不能使用 set 命令设置这两个属性。

示例

以下命令将显示上一个命令返回的异常。

admin> show exception

users

列出当前的 User 对象。

一般形式

说明

users 命令用于列出 Registry 中当前的 User 对象。

输出采用以下格式：

%index: URN lastname, firstname middlename

在输出中，index 是可以使用的数字值，包括百分号 (%)，以在运行 chown 或 cp 命令时引用用户。lastname、firstname 和 middlename 分别是用户的姓氏、名字和中间名。

示例

以下命令将显示当前用户：

admin> users
%0:  urn:freebxml:registry:predefinedusers:registryoperator  Operator, Registry 
%1:  urn:freebxml:registry:predefinedusers:registryguest  Guest, Registry 
%2:  urn:freebxml:registry:predefinedusers:farrukh  Najmi, Farrukh Salahudin
%3:  urn:freebxml:registry:predefinedusers:nikola  Stojanovic, Nikola 
%4:  urn:uuid:799cc524-b7cd-4e51-8b34-d93b79ac52de  User, Test 
%5:  urn:uuid:85428d8e-1bd5-473b-a8c8-b9d595f82728  Parker, Miles