test

适用于 Microsoft Windows 的 Service Registry 3.1 发行说明

第 1 章 Service Registry 3.1 发行说明

本发行说明包含了 Service Registry 3.1 发行时可用的重要信息，其中涉及新增与增强功能、已知问题与限制以及其他信息。开始使用 Service Registry 之前，请先阅读本文档。

可以在 Sun 文档 Web 站点 http://docs.sun.com 找到本发行说明的最新版本。安装与设置软件之前，请先检查此 Web 站点，以查看最新发行说明与产品文档，并在此后定期查看这些资料。

本发行说明包含以下部分：

本文档引用了第三方 URL，其中提供了其他相关的信息。

Sun 对本文档中提到的第三方 Web 站点的可用性不承担任何责任。对于此类站点或资源中的（或通过它们获得的）任何内容、广告、产品或其他资料，Sun 并不表示认可，也不承担任何责任。对于因使用或依靠此类站点或资源中的（或通过它们获得的）任何内容、产品或服务而造成的或连带产生的实际或名义损坏或损失，Sun 概不负责，也不承担任何责任。

Service Registry 3.1 中的新增功能

本节提供有关 Service Registry 3.1 中新增功能、功能性及支持产品的信息。

新的 Service Registry 的访问端口

Service Registry 的默认访问端口值已更改，因为先前的端口值 6060 在使用 X Window 系统 (X11) 时，与向国际因特网地址分配委员会 (Internet Assigned Numbers Authority, IANA) 注册的值相冲突。新的默认访问端口值为 6480。所有默认的 Service Registry 端口现在均已向 IANA 注册。

任何使用 Java API for XML Registries (JAXRTM) 的现有客户机均应更改为使用新端口值。javax.xml.registry.queryManagerURL 和 javax.xml.registry.lifeCycleManagerManagerURL 属性将为 JAXR 客户机指定此端口值。如果已在属性文件中定义这些属性，则无需重新编译客户机。

Service Registry 的安装路径名

Service Registry 的安装路径名已更改，如下表所示。

表 1–1 Service Registry 的安装路径

描述 

Java ES4 路径名 

Java ES5 路径名 

安装基目录 

C:\Sun\ServiceRegistry

C:\Program Files\Sun\JavaES5\srvc-registry

域和数据安装目录 

C:\Sun\ServiceRegistry

C:\Program Files\Sun\JavaES5\srvc-registry\data

新配置目标名称

在先前的 Service Registry 发行版中，用于配置 Service Registry 的 Ant 目标的名称是 install。在此发行版中的目标名称为 configure。为实现向后兼容性，仍支持 install 目标，但可能在将来的发行版中删除。有关详细信息，请参见《Service Registry 3.1 Administration Guide》中的第 1  章 “Configuring and Setting Up Service Registry”。

为残疾人士提供的辅助功能

欲获得自本介质发行以来所发布的辅助功能，请联系 Sun 索取有关 "Section 508" 法规符合性的产品评估文档，以便确定哪些版本最适合部署辅助功能解决方案。可通过以下网址获取应用程序的更新版本：http://sun.com/software/javaenterprisesystem/get.html。有关 Sun 在辅助功能方面所做出的努力，请访问 http://sun.com/access。

特定于实现的 API

Service Registry 包括 1.0 版 Java API for XML Registries (JAXR) 规范的实现。JAXR 1.0 版本用于支持 UDDI 和 ebXML Registry 2.0 规范。在 Service Registry 中，JAXR 的实现包括对 JAXR 版本 1.0 的非标准扩展。

默认路径和文件名

下表介绍了本书中使用的默认路径和文件名。

表 1–2 默认路径和文件名

占位符 

默认值 

描述 

ServiceRegistry-base

C:\Program Files\Sun\JavaES5\srvc-registry

Service Registry 的安装基目录。 

DomainRegistry-base

C:\Program Files\Sun\JavaES5\srvc-registry

Service Registry 的 Application Server 域和 Service Registry 数据库所在的目录。 

Ant-base

ServiceRegistry-base\install\ant

Ant 工具的 Java ES 版本所在的目录。

硬件和软件要求

本节列出了安装 Service Registry 3.1 之前必须满足的要求。

Service Registry 的安装要求与 Sun Java System Application Server 大致相同。就磁盘空间而言，除了要满足 Application Server 的要求外，还要满足下表中的要求。

表 1–3 硬件和软件要求

组件 

要求 

操作系统 

Windows 2000 Advanced Server SP4 

Windows XP SP2 

Windows 2003 Enterprise Server（32 位） 

Windows 2003 Enterprise Server（64 位） 

最小内存 

512 MB 

建议的内存 

1 GB 

最小磁盘空间 

65 MB 空闲空间 

建议的磁盘空间 

100 MB 空闲空间 

Java 虚拟机 (Java Virtual Machine, JVM) 

J2SETM 5_02 版

使用期限即将终止的功能

用户注册机制

此 Service Registry 发行版依赖于其自身的用户管理和验证机制。

Service Registry 3.1 文档

可在 http://docs.sun.com/coll/1314.2 和 http://docs.sun.com/coll/1383.2 中获得 Service Registry 文档集。

此发行版中修复的错误

下表介绍了在 Service Registry 3 中报告并已在 Service Registry 3.1 中修复或处理的错误。

表 1–4 此发行版中修复或已处理的错误

错误号 

描述 

6290339 

无法检索组织 (Organization) 对象的电子邮件地址 (EmailAddress) 对象

6297023 

执行发布操作后，分类方案 (ClassificationScheme) 显示保持不变

6298946 

尝试在组织 (Organization) 对象之间创建引用会导致错误

6303812 

重复的用户名会导致不明确的错误消息 

6305210 

如果应用服务器域使用非英语语言环境，则 Registry 将无法使用英语语言环境 

6312083 

某些搜索返回意外的结果 

6312094 

注册向导在创建证书标识名时会忽略必填值 

6313327 

Service Registry 重新安装后配置失败 

6313791 

使用 -alias 选项时，管理工具操作失败

6318002 

使用无效概念创建外部对象 (ExtrinsicObject) 或外部链接 (ExternalLink) 后出现错误

6323057 

删除对象创建的可审计事件 (AuditableEvent) 时会导致异常

6324423 

在单击“应用”按钮之前尝试查看系统信息库项目会导致错误  

6338836 

使用上载证书选项创建用户帐户时出现问题 

6397404 

WSDL 编目程序未将缺少的相关项告知用户 

6415812 

java.lang.OutOfMemoryError: PermGen space 错误

6430997 

有些 Web 控制台字符串未本地化 

6436398 

Web 控制台未显示本地化的分类方案和节点 

6438523 

未更新“设置或更改状态”组合框 

6443263 

单击关联导致服务器日志中的异常 

6456272 

单击“插槽”选项卡中的“删除”按钮抛出异常 

6466376 

WSDL 编目程序替换临时 ID 失败 

6470179 

单击“关联 (Association)”选项卡中的“删除”按钮显示错误消息  

6472233 

无法创建预定义的查询 

6477124 

单击“应用”按钮无法保持在“详细信息”页面所做的更改 

已知问题和错误

下列已知问题和错误会影响 Service Registry 3.1 发行版的操作。

6248218：版本化的注册表包 (RegistryPackage) 的内容丢失

问题摘要：如果启用了版本更新，并且您更改了注册表包 (RegistryPackage) 对象以创建新的对象版本，则所有软件包内容都将从新版本中消失。

解决方法：请不要启用版本更新。有关更多信息，请参见《Service Registry 3.1 管理指南》中的“启用注册表 (Registry) 对象的版本更新”。

6248293：分类 (Classification) 同时被添加到对象的旧版本和新版本中

问题摘要：如果启用了版本更新，并且您将分类添加到某个对象版本中，然后保存该对象，则分类同时存在于旧版本和新版本中。

解决方法：请不要启用版本更新。有关更多信息，请参见《Service Registry 3.1 管理指南》中的“启用注册表 (Registry) 对象的版本更新”。

6248418：添加分类 (Classification)、外部标识符 (ExternalIdentifier) 或插槽 (Slot) 将会删除外部链接 (ExternalLink)

问题摘要：如果启用了版本更新，并且您向具有外部链接 (ExternalLink) 的对象中添加了插槽 (Slot)、分类 (Classification) 或外部标识符 (ExternalIdentifier)，则外部链接 (ExternalLink) 将从新对象版本中消失。

解决方法：请不要启用版本更新。有关更多信息，请参见《Service Registry 3.1 Administration Guide》中的“Enabling Versioning of Registry Objects”。

6359188：尝试将关联创建到用户拥有的已过时对象，或从用户拥有的已过时对象创建关联不会导致 IllegalStateException

问题摘要：JAXR 规范不允许用户将关联创建到已过时的对象，也不允许从已过时的对象创建关联。但是，Service Registry JAXR 提供者允许用户在拥有已过时的对象时创建此类关联。

6374079：个人 (Person) 和用户 (User) 的“详细信息 (Details)”区域不相同

问题摘要：个人 (Person) 对象的“详细信息”区域不允许用户添加邮政地址 (PostalAddress)、电子邮件地址 (EmailAddress) 或电话号码 (TelephoneNumber)，尽管个人 (Person) 对象包含所有这些属性。

解决方法：创建用户 (User) 对象，而不是个人 (Person) 对象。您可以将所有这些属性添加到用户 (User) 对象。

6407168：管理工具 add association 命令输出误导性错误

问题摘要： 用户若未经授权即尝试发出管理工具命令 add association 以创建关联，将导致误导性错误消息。例如，如果不是管理员的用户尝试创建类型为 HasMember 的关联，则将显示以下错误消息：

不存在以下类型的概念对象: HasMember

6407974：许多文件保留在临时目录中

问题摘要：WSDL 目录服务将 XML 和 XSLT 文件保留在服务器上，位置在 install.properties 文件的 java.io.tmpdir 属性指定的目录中。此外，用户验证进程将以 .omar 开头并以 .jks 为后缀的文件保留在同一目录中。停止 Registry 域之前，不会删除这些文件。

解决方法：文件名类似以下示例的文件将被删除。 变量 n 代表一个数字。

CanonicalXMLValidationService_OutputFilennnnn.xml
InvocationControlFile_WSDLValidationnnnnn.xslt

6422192：将 Service Registry 3.1 管理工具用在 Service Registry 3.0 上时会导致 NullPointerException

问题摘要：如果将 Service Registry 3.1 管理工具用在已部署的 Service Registry 3.0 上，则 cp 和 rm 等命令将导致 NullPointerException。

解决方法：Service Registry 3.1 管理工具只能用在 Service Registry 3.1 上，而 Service Registry 3.0 管理工具只能用在 Service Registry 3.0 上。

6436598：删除或更新源对象后，WSDL 编目程序不删除或更新已编目的对象

问题摘要：使用 WSDL 目录服务通过向 Registry 发布 WSDL 文件以创建服务时，Registry 将创建大量属于该服务的对象。删除或更新服务或 WSDL 文件时，不会删除或更新这些对象。删除或更新服务或 WSDL 文件时，必须将这些对象单独删除或更新。

解决方法：无。

6487653：创建对象时“设置或更改状态”按钮不起作用

问题摘要：创建对象时，“设置或更改状态”按钮不呈暗色。但是，无法设置或更改尚未创建的对象的状态。如果单击此按钮，将会出现错误消息，表明无法找到该对象。

解决方法：请不要在创建对象时单击“设置或更改状态”按钮。单击“应用”完成对象的创建，然后搜索此对象并更改其状态。

6499274：已修改的对象的状态为“空”

问题摘要：新建对象的状态为已提交。但是，修改并保存此对象之后，其状态将更改为空。而它应该继续保持已提交 状态。

解决方法：无。

6500654：“选择分类节点 (Classification Node)”窗口中的描述和按钮不符

问题摘要：如果在“搜索”区域中单击“选择分类节点 (Classification Node)”按钮，则文本将提示在选择概念后单击“确定”，而按钮标记为“关闭”。

解决方法：无。

6500668：用户注册向导没有解释星号的含义

问题摘要：在 Web 控制台中，“新用户详细信息”表单和“用户验证详细信息”表单都包含星号，但是这两个表单都没有解释星号表示必填字段。

解决方法：联机帮助中给出了必填字段。

6502100：WSDL 编目程序无法处理具有结尾正斜杠的 java.io.tmpdir

问题摘要：如果将 JVM 属性 java.io.tmpdir 设置为以正斜杠 (/) 结尾的值，则尝试对 zip 文件使用 WSDL 编目程序将会失败。失败的症状为产生 CatalogingException，并显示一条消息，指出编目程序在请求中找不到其中一个文件。

在 Linux 中不会出现此问题，因为其中 java.io.tmpdir 的默认设置不以正斜杠结尾。

解决方法：更改 java.io.tmpdir 的值，使其不以正斜杠结尾。

    执行以下步骤：

  1. 按照《Service Registry 3.1 管理指南》中的“使用 Application Server 管理控制台”中所述，登录应用服务器管理控制台。

  2. 展开“配置”节点。

  3. 展开服务器节点 server-config (Admin Config)。

  4. 单击“JVM 设置”。

  5. 单击“JVM 选项”选项卡。

  6. 单击“添加 JVM 选项”。

  7. 在文本字段中键入以下内容：

    -Djava.io.tmpdir=c:\DOCUME~1\ADMINI~1\LOCALS~1\Temp

  8. 单击“保存”。

  9. 按照《Service Registry 3.1 管理指南》中“停止并重新启动 Registry 的 Application Server 域”的说明进行操作。

执行完这些步骤之后，您应该能够发布包含多个 WSDL 文件的 zip 文件。

本地化问题

Service Registry 3.1 中的下列错误与本地化相关。

6276676：Web 控制台中缺少本地化的字符串

问题摘要：在 Web 控制台中，以下字符串应该本地化，但却以英文显示：

此外，切换浏览器的语言环境并重置语言时，有些标签仍以先前的语言显示。

6493416：联机帮助链接导向英文页面

问题摘要：如果在提供了联机帮助的非英语语言环境中使用 Web 控制台，则“搜索结果”页面中的“书签及相关帮助”链接将导向英文帮助页面，而不是您的语言环境的帮助页面。

解决方法：无。

6496070：任何语言环境下的事件类型名称都没有翻译

问题摘要：在 Web 控制台中，如果在“详细信息”区域中单击任一对象的“审计跟踪”选项卡，则“事件类型”字段中的文本（Created、Updated 等）始终以英文显示。

解决方法：无。

6499672：非英语语言环境中缺少两个联机帮助页面

问题摘要：在 Web 控制台联机帮助中，除英文之外的所有语言环境中的最后一章（“故障排除”）都缺少最后两节。

解决方法：这两节可以在联机手册中找到，但只有英文版，请参见《Service Registry 3.1 用户指南》。

6500664：日语语言环境的联机帮助中存在未翻译的字符串

问题摘要：在 Web 控制台的联机帮助中，指向其他书籍（例如《Service Registry 3.1 管理指南》）的交叉引用没有翻译为日文。

解决方法：无。

6500673：日语语言环境中的姓名和邮政地址顺序不正确

问题摘要：在 Web 控制台的“用户注册向导”中，姓名和邮政地址字段的顺序没有针对日语语言环境进行本地化。

解决方法：无。

6500677：日语语言环境的联机帮助中的链接无效

问题摘要：在日语语言环境的 Web 控制台联机帮助的“前言”中，如果查看“默认路径和文件名”部分并单击“下一步”链接，则会显示“找不到页面”错误。此链接指向的页面并不存在。

解决方法：无。

6507818：所有非英语语言环境中都缺少 Service Registry 用户指南

问题摘要：在 Windows 的所有非英语语言环境中都缺少 Service Registry 用户指南。

解决方法：无。

6510165：“详细信息”选项卡中的对象名称没有翻译

问题摘要：在 Web 控制台任一对象的“详细信息”区域，“详细信息”选项卡中的对象名称没有翻译，而是使用了 Java 对象名称。此外，在法语语言环境中，词序不正确。

解决方法：无。

文档问题

Service Registry 3.1 中的下列错误与文档相关。

6500315：缺少一个联机帮助页面

问题摘要：在 Web 控制台联机帮助中，所有语言环境中的“前言”中都缺少“搜索 Sun 产品文档”一节。

解决方法：可以通过联机方式在英文版的《Service Registry 3.1 用户指南》中找到完整的“前言”部分。

6501734：资源管理器目录的联机帮助名称错误

问题摘要：在 Web 控制台中，“资源管理器”选项卡的联机帮助错误地将根目录名称称为 root。它应该为 registry。

解决方法：正确的文档在《Service Registry 3.1 用户指南》中。