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

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

版本 3 2005Q4

文件号码 819-5891

本发行说明中包含发行 Service Registry 3 2005Q4（适用于 Microsoft Windows）时可用的重要信息。文中阐述了已知问题和限制，并提供了其他信息。在开始使用 Service Registry 3 之前，请先阅读本文档。

本发行说明包含以下章节：

发行说明修订历史记录

表 1 修订历史记录 

日期

更改说明

2006 年 2 月

正式版

2005 年 11 月

初始版

关于 Service Registry 2005Q4

本节介绍与 Service Registry 3 2005Q4 的特点、功能以及所支持产品相关的信息。本节包含以下内容：

特定于实现的 API

Service Registry 实现了 Java API for XML Registries (JAXR) 规范 1.0 版。编写 JAXR 1.0 是为了支持 UDDI 和 ebXML Registry 2.0 规范。在 Service Registry 中实现 JAXR 时，对 JAXR 1.0 进行了非标准扩展。由于这些 API 扩展将被考虑添加到未来的 JAXR 标准中，因此它们会对将来版本的 JAXR 规范有所帮助。

在未来的 Service Registry 发行版中这些 API 扩展会有所变更。Sun 将尽量保持未来 Service Registry 发行版中的这些 API 的向后兼容性。在某些情况下，可能无法实现向后兼容性。对于要使用这些 API 扩展的客户，请注意 Service Registry JAXR 提供者中的这些扩展在未来的发行版中可能会发生变更。

使用期限即将终止的功能

用户注册机制

此发行版的 Service Registry 有其自己的用户管理和验证机制。计划在将来的发行版中将 Registry 更新为采用基于 SAML 的机制（如 ebXML Registry 标准中所述，此组件是该标准中的一个实现），并将在相应的发行版及其以后的发行版中使用 Access Manager 进行用户管理和验证。

在此发行版中，Service Registry 客户的用户注册信息由 Service Registry 维护。在将来的发行版及其以后的发行版中，客户的这些信息将由 Access Manager 维护。要升级至某一将来的 Service Registry 版本的客户需要将他们的用户信息迁移至 Access Manager，以便维持注册用户和 Registry 内容之间建立的连接（例如，审计追踪）。Sun 打算提供一个迁移工具用来简化此迁移。

硬件和软件要求

Service Registry 3 2005Q4 具有以下软硬件要求。

表 2 硬件和软件要求

组件

平台要求

操作系统

Microsoft Windows 2000 Advanced Server, Service Pack4

Microsoft Windows 2003 Enterprise Server

Microsoft Windows XP Professional, Service Pack 2

RAM

512 MB

磁盘空间

200 MB

此发行版中修复的错误

下表介绍了在 Service Registry 3 2005Q4 中修复的错误。

表 3 在 Service Registry 3 2005Q4 中修复的错误

错误号

说明

6348529

在 Windows 中安装 Service Registry 时，在安装后配置期间出现问题

6327977

卸载 Service Registry 时，提示重新启动。

重要信息

本节包含以下内容：

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

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

有关 Sun 在辅助功能方面所做出的努力，请访问 http://sun.com/access。

已知问题和限制

本节介绍有关 Service Registry 3 2005Q4 发行版（适用于 Microsoft Windows）的已知问题和限制。

无法检索 Organization 对象的 EmailAddress 对象 (6290339)

JAXR 提供者无法从 Organization 对象检索电子邮件地址。如果您发布一个包含电子邮件地址的 Organization 对象，并且发布似乎已经成功，但 OrganizationImpl.getEmailAddresses 方法却未返回任何结果。该问题还会导致 Web 控制台中显示空的结果。

解决方法

无

尝试创建 Organization 对象之间的引用导致发生错误 (6298946)

在 Web 控制台中，如果您对两个 Organization 对象选中了“拾取”复选框并单击“关联”，然后单击“保存”以保存默认关系（对象引用），则 Web 控制台报告错误，但没有详细的错误消息。服务器日志中将显示堆栈追踪。

重复的用户名导致出现意义不确切的错误消息 (6303812)

在 Web 控制台中，当用户尝试创建具有生成的证书的用户帐户，并指定对于服务器来说已知的别名时，在 Web 控制台中“步骤 3”页面上将出现以下错误消息：

发生错误。请参见服务器日志或与 Registry 支持联系。

解决方法

检查服务器日志。可在堆栈追踪中找到根源：

原因为: java.lang.Exception: 未生成密钥对，别名已存在。

创建证书标识名时，注册向导忽略必需的值 (6312094)

在 Web 控制台中，用户注册向导在为其生成的证书创建标识名 (Distinguished Name, DN) 时，将使用一些您在“新用户详细信息”页面中指定的可选值（“国家/地区”、“省/自治区/直辖市”以及“城市”）。但该向导将只使用您在“用户验证详细信息”页面中指定的一个必需值，而忽略所有其他值。（它使用的唯一值是“名称”值。）

解决方法

要在证书 DN 中包括“城市”、“省/自治区/直辖市”或“国家/地区”，请在“新用户详细信息”页面以及“用户验证详细信息”页面中指定这些值。

Service Registry 重新安装后配置失败 (6313327)

如果您使用 Java Enterprise System 卸载程序卸载 Service Registry，则重新安装并执行安装后配置时，配置脚本运行失败并显示以下错误消息：

域注册表已存在。请指定其他域。

问题在于卸载程序并不停止或删除 Registry 的 Application Server 域。必须手动执行该任务。

解决方法

在重新安装 Service Registry 之前，请先停止 Registry 的 Application Server 域，然后删除该域。有关详细信息，请参见《Service Registry 3 2005Q4 管理指南》中的“重新安装 Service Registry”。

使用 -alias 选项时，管理工具运行失败 (6313791)

如果您尝试使用管理工具执行需要管理员权限的任务，则将出现堆栈追踪和 NoClassDefFoundError。出现该错误的原因是管理工具 JAR 文件的清单类路径中缺少文件。

解决方法

无

创建使用无效概念的 ExtrinsicObject 或 ExternalLink 后出现错误 (6318002)

在 Web 控制台中，如果您创建了一个 ExtrinsicObject 并选择了不属于 ExtrinsicObject 的概念的概念，则创建看上去成功了，但实际上出现了错误。当您创建了 ExternalLink 并选择了不属于 ExternalLink 的概念的概念时，也会出现该问题。

在服务器日志中，这些错误显示为 NullPointerException。

如果概念是属于 RegistryObject 的另一个子概念，则主要影响是搜索新对象时找不到新对象。如果概念是属于 ClassificationScheme 而不是 ObjectType，则将损坏数据库。当您重新启动服务器时，出现运行时错误 (InvocationTargetException)。

对象类型概念必须是 ExtrinsicObject 或 ExternalLink 概念中的子概念，但 Web 控制台并不强制此要求。

解决方法

使用管理工具查找使用了错误概念的对象。使用 select 命令查找对象，并使用 rm 删除它们。该任务的步骤如下。

  1. 按《Service Registry 3 2005Q4 管理指南》中的“停止并重新启动 Registry 的 Application Server 域”所述重新启动 Service Registry。
  2. 按《Service Registry 3 2005Q4 管理指南》中的“启动管理工具”所述以 Registry 管理员或损坏对象的拥有者身份启动管理工具。
  3. 转至数据库中的顶层位置：admin> cd /。
  4. 使用 select 命令列出要删除的对象。

    5. 如果您是以 Registry 管理员身份启动的该工具，则使用以下命令（全部在一行）：

  1. 使用 rm 命令删除对象。指定要删除的每个对象的 URN。
  1. 再次运行 select 命令验证这些对象是否已不在 Registry 中。

删除 AuditableEvent 造成已创建的对象出现异常 (6323057)

如果您删除了 AuditableEvent，而其“受影响对象”列表中包含您拥有的一个或多个对象，则将损坏受影响对象的审计追踪。尤其是删除您自己的 User 对象的已创建事件时，会出现严重问题。例如，您删除该事件后，每当您执行 FindAllMyObjects 搜索时，都会出现运行时异常。

在单击“应用”按钮之前尝试查看系统信息库项导致出现错误 (6324423)

在 Web 控制台中，如果您创建了一个 ExtrinsicObject 并添加了一个系统信息库项，则在您单击“保存”或“应用”按钮之前，只要您上载文件，“查看系统信息库项内容”链接就变为活动状态。如果您在单击“应用”之前单击该链接，则将出现错误 404 消息。在该链接成为有效链接之前，不应变为活动状态。

解决方法

请勿在单击“应用”之前尝试查看系统信息库项。

执行发布操作时，ClassificationScheme 显示保持不变 (6297023)

在 Web 控制台中，如果在发布对象（如 ExtrinsicObject 或 ExternalLink）时选择了 ClassificationScheme 中的概念，则下次发布其他对象时，会在同一位置打开 ClassificationScheme 窗口，即使该对象属于不同的对象类型也是如此。

类似地，如果您按分类执行搜索，再执行一些关闭“搜索”表单的其他操作（例如发布操作），然后再打开“搜索”表单，则 ClassificationScheme 的显示与关闭“搜索”表单时相同。

一些搜索返回意外的结果 (6312083)

在 Web 控制台中，按名称搜索人员或用户对象时，无法返回数据库中任何预定义的用户，或具有定义的“人名”（不是“名称”）的任何人员或用户。此外，搜索其名称包含特定数目字符的对象（例如使用搜索字符串 "__" 查找两个字符的名称）时，返回许多其名称包含非指定数目字符的对象。

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

在 Web 控制台中，由于选择上载第三方证书选项而使验证失败，从而导致用户注册失败。注册失败，并出现以下错误消息：“由于验证失败而导致操作失败。验证失败的原因是您的 Web 浏览器中未装入客户机证书。”

解决方法

使用 Registry 生成的证书来创建用户帐户。按照《Service Registry 3 2005Q4 用户指南》中的说明进行操作。

如何报告问题和提供反馈

如果您的 Sun Java System Service Registry 出现问题，请通过以下方式与 Sun 用户支持
联系：

为了便于我们更好地帮助您解决问题，当您联系客户支持部门时请提供以下信息：

Sun 欢迎您提出意见

Sun 致力于提高其文档的质量，并十分乐意收到您的意见和建议。

为了共享您的意见，请访问 http://docs.sun.com，并单击 "Send Comments"（发送意见）。在联机表单中，请提供完整的文档标题和文件号码。文件号码是一个七位或九位的数字，可以在书的标题页或文档的顶部找到。

在您提出意见时，可能需要在表单中输入英文版书名和文件号码，本书的英文版文件号码和书名为：819-4279，《Sun Java System Service Registry 2005Q4 Release Notes for Microsoft Windows》。

其他 Sun 资源

可以在以下位置找到有用的 Sun Java System 信息：

版权所有 © 2006 Sun Microsystems, Inc.保留所有权利。

对于本文档中介绍的产品，Sun Microsystems, Inc. 对其所涉及的技术拥有相关的知识产权。需特别指出的是（但不局限于此），这些知识产权可能包含在 http://www.sun.com/patents 中列出的一项或多项美国专利，以及在美国和其他国家/地区申请的一项或多项其他专利或待批专利。

SUN 专有/机密。

美国政府权利－商业软件。政府用户应遵循 Sun Microsystems, Inc. 的标准许可协议，以及 FAR（Federal Acquisition Regulations，即“联邦政府采购法规”）的适用条款及其补充条款。

必须依据许可证条款使用。

本发行版可能包含由第三方开发的内容。

本产品的某些部分可能是从 Berkeley BSD 系统衍生出来的，并获得了加利福尼亚大学的许可。

Sun、Sun Microsystems、Sun 徽标、Java 和 Solaris 是 Sun Microsystems, Inc. 在美国和其他国家/地区的商标或注册商标。所有的 SPARC 商标的使用均已获得许可，它们是 SPARC International, Inc. 在美国和其他国家/地区的商标或注册商标。