Service Registry 3.1 发行说明

Previous: 索引

第 1 章 Service Registry 3.1 发行说明

Service Registry 是 ebXML Registry：一种联合注册表和系统信息库，用于管理标准元数据和可扩展元数据所描述的所有类型的电子内容。它提供了面向服务的体系结构 (Service Oriented Architecture, SOA) 及其他内容和元数据的联合、安全的信息管理。它支持 ebXML Registry 3.0 和 UDDI 3.0 注册表协议。

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 (JAXR) 的现有客户机均应更改为使用新端口值。javax.xml.registry.queryManagerURL 和 javax.xml.registry.lifeCycleManagerManagerURL 属性将为 JAXR 客户机指定此端口值。如果已在属性文件中定义这些属性，则无需重新编译客户机。

Service Registry 的新软件包名称和安装路径名

已重命名 Service Registry 软件包，如表 1–1 所示。

表 1–1 Service Registry 软件包名称更改


软件包说明	Java ES 4 软件包名称	Java ES 5 软件包名称
Solaris 操作系统上的部署软件包	`SUNWsoar-server`	`SUNWsrvc-registry-deploy`
Linux 和 HP-UX 系统上的部署软件包	`sun-soarserver`	`sun-srvc-registry-deploy`
Solaris 操作系统上的开发软件包	`SUNWsoar-sdk`	`SUNWsrvc-registry-dev`
Linux 和 HP-UX 系统上的开发软件包	`sun-soarsdk`	`sun-srvc-registry-dev`

还更改了 Service Registry 的安装路径名，如表 1–2 所示。

表 1–2 Service Registry 安装路径名更改


描述	Java ES 4 路径名	Java ES 5 路径名
Solaris 操作系统上的基本安装目录	`/opt/SUNWsoar`	`/opt/SUNWsrvc-registry`
Linux 和 HP-UX 系统上的基本安装目录	`/opt/sun/SUNWsoar`	`/opt/sun/srvc-registry`
Solaris 操作系统上的域和数据安装目录	`/var/opt/SUNWsoar`	`/var/opt/SUNWsrvc-registry`
Linux 和 HP-UX 系统上的域和数据安装目录	`/var/opt/sun/SUNWsoar`	`/var/opt/sun/srvc-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 的非标准扩展。这些 API 扩展将用于 JAXR 规范的将来版本中，可能加入将来的 JAXR 标准。

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

默认路径和文件名

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

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


占位符	描述	默认值
`ServiceRegistry-base`	表示 Service Registry 的安装基目录。	Solaris 操作系统：`/opt/SUNWsrvc-registry` Linux 和 HP-UX 系统：`/opt/sun/srvc-registry`
`RegistryDomain-base`	表示 Service Registry 的 Application Server 域和 Service Registry 数据库所在的目录。	Solaris 操作系统：`/var/opt/SUNWsrvc-registry` Linux 和 HP-UX 系统：`/var/opt/sun/srvc-registry`
`Ant-base`	表示 Java ES 版的 Ant 工具所在的目录。	Solaris 操作系统：`/usr/sfw/bin/` Linux 和 HP-UX 系统：`/opt/sun/share/bin`

硬件和软件要求

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

安装 Service Registry 的要求大多与安装 Sun Java System Application Server 的要求相同。表 1–4 是除了 Application Server 磁盘空间要求以外的额外磁盘空间要求。

表 1–4 支持的操作系统


操作系统	最小内存	建议的内存	最小磁盘空间	建议的磁盘空间	JVM
Sun Solaris 9, 10 (SPARC, x86)	640 MB	1 GB	80 MB 可用空间	120 MB 可用空间	J2SE 1.4.2_10、J2SE 5_09
Redhat Enterprise Linux 3.0 U1, 4.0	640 MB	1 GB	65 MB 可用空间	100 MB 可用空间	J2SE 1.4.2_10、J2SE 5_09
HP-UX 11i (11.11) v1	640 MB	1 GB	65 MB 可用空间	100 MB 可用空间	J2SE 5_03

修补程序和所需的固件级别

除了 Java Enterprise System 所记录的，无其他修补程序。

Service Registry 3.1 文档

可在 http://docs.sun.com/coll/1314.2 和 http://docs.sun.com/coll/1383.2 中获得 Service Registry 文档集。要了解 Service Registry，请参阅下表中列出的书。

表 1–5 Service Registry 文档


文档标题	内容
《Service Registry 3.1 发行说明》	包含有关 Service Registry 的最新信息（包括已知问题）。
《Service Registry 3.1 Administration Guide》	该文档介绍了如何在安装后配置 Service Registry 以及如何使用 Registry 附带的管理工具，还介绍了如何执行其他管理任务。
《Service Registry 3.1 User’s Guide》	该文档介绍了如何使用 Service Registry Web 控制台来搜索 Service Registry 并向其发布数据。
《Service Registry 3.1 Developer’s Guide》	该文档介绍了如何使用 Java API for XML Registries (JAXR) 来搜索 Service Registry 并向其发布数据。

文档标题	内容
《Sun Java Enterprise System 5 Release Notes for UNIX》《Sun Java Enterprise System 5 Release Notes for Microsoft Windows》	包含有关 Java ES 的最新信息（包括已知问题）。此外，发行说明集 (`http://docs.sun.com/coll/1315.2` 和 `http://docs.sun.com/coll/1396.2`) 中还列出了各组件自身的发行说明。
《Sun Java Enterprise System 5 Technical Overview》	介绍 Java ES 的技术和概念基础。介绍组件、体系结构、过程和功能。
《Sun Java Enterprise System Deployment Planning Guide》	介绍如何规划和设计基于 Java ES 的企业部署解决方案。介绍部署规划和设计的基本概念和原理，讨论解决方案的生命周期，并提供规划基于 Java ES 的解决方案时可以使用的高级示例和策略。
《Sun Java Enterprise System 5 Installation Planning Guide》	帮助您开发 Java ES 部署中硬件、操作系统和网络方面的实施规范。介绍诸如在安装和配置规划中组件与地址之间的依赖性等问题。
《Sun Java Enterprise System 5 Installation Guide for UNIX》《Sun Java Enterprise System 5 Installation Guide for Microsoft Windows》	指导您完成 Java ES 的安装过程，还说明了如何在安装后配置组件以及如何验证这些组件是否运行正常。
《Sun Java Enterprise System 5 Installation Reference for UNIX》	给出有关配置参数的其他信息，提供在配置规划中使用的工作表，并且列出参考材料（例如 Solaris 操作系统和 Linux 操作环境中的默认目录和端口号）。
《Sun Java Enterprise System 5 Upgrade Guide for UNIX》《Sun Java Enterprise System 5 Upgrade Guide for Microsoft Windows》	提供有关从先前安装的版本升级到 Java ES 5 的说明。
《Sun Java Enterprise System 5 Monitoring Guide》	提供有关为每个产品组件设置 Monitoring Framework 以及使用 Monitoring Console 查看实时数据和创建监视规则的说明。
《Sun Java Enterprise System Glossary》	定义 Java ES 文档中使用的术语。

此发行版中修复的错误

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

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


错误号	描述
6290339	无法检索`组织 (Organization)` 对象的`电子邮件地址 (EmailAddress)` 对象
6297023	执行发布操作时，`分类方案 (ClassificationScheme)` 显示保持不变
6298088	外部对象不支持多字节文件名
6298946	尝试在`组织 (Organization)` 对象之间创建引用会导致错误
6301689	将新的系统信息库项目添加到外部对象时丢失内容版本注释
6303812	重复的用户名会导致不明确的错误消息
6305138	UDDI 资源包未本地化
6305210	如果应用服务器域使用非英语语言环境，则 Registry 将无法使用英语语言环境
6307262	按名称查询会检索到每个标准`分类方案 (ClassificationScheme)` 的多个副本
6312083	某些搜索返回意外的结果
6312094	注册向导在创建证书标识名时会忽略必填值
6312531	尝试为`外部链接 (ExternalLink)` 和`服务绑定 (ServiceBinding)` 对象设置 URI 失败
6313327	Service Registry 重新安装后配置失败
6313372	联机帮助字符串中包含错误的法语翻译
6313791	使用 `-alias` 选项时，管理工具操作失败
6316300	在非默认语言环境中创建的对象没有名称
6317212、6317242、6317489、6317568、6322668 和 6325023	对于非英语语言环境，Web 控制台包含未本地化字符串
6318002	使用无效概念创建`外部对象 (ExtrinsicObject)` 或`外部链接 (ExternalLink)` 后出现错误
6323057	删除对象创建的`可审计事件 (AuditableEvent)` 时会导致异常
6324423	在单击“应用”按钮之前尝试查看系统信息库项目会导致错误
6324437	已确定的搜索结果中的对象在后续搜索中重复出现
6325095	资源管理器显示错误的数据
6325116	使用 `-locale` 选项时，管理工具未正确启动
6329272	重新安装 Service Registry 会删除现有系统信息库数据库
6330540	在服务器重新启动后立即登录会导致异常
6331538	无法将`分类节点 (ClassificationNode)` 添加到现有节点中

已知问题和错误

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

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

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

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

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

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

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

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)`“详细信息”区域不相同

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

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

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

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

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

6407195：大多数管理工具命令忽略 `lcd` 设置

问题摘要：如果使用管理工具 lcd 命令设置当前本地目录，则 cp 命令将接受相对于此目录的路径名称参数。但是，其他大多数命令（例如 add user、import 和 keystoreMover）并非如此。对于这些命令，需要指定绝对路径名称。

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

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

解决方法：可以删除具有如下名称的文件。字符 ????? 表示 5 位数字。

CanonicalXMLValidationService_OutputFile?????.xml
InvocationControlFile_WSDLValidation?????.xslt

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

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

6479361：“查找所有对象”的结果显示不应包括调用者的用户 (User) 对象

问题摘要：用户在 Web 控制台中选择并执行“查找所有对象”查询时，结果显示包括执行查询的用户的用户 (User) 对象以及该用户所拥有的所有其他对象。如果用户无意中删除了该对象，则出现的严重问题将导致：该用户将无法再对自己发布的对象执行任何操作，而且必须再次执行用户注册才能发布更多对象。“查找所有对象”查询不应显示该用户 (User) 对象。仅 GetCallersUser 查询应显示该对象。

解决方法：切勿删除您自己的用户 (User) 对象。

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

问题摘要：当用户在 Web 控制台中创建任意类型的对象时，“设置或更改状态”按钮没有变灰。但是，无法设置或更改尚未创建的对象的状态。如果用户单击此按钮，则会显示错误消息，指出找不到对象。

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

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

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

在 Web 控制台中，修改对象之后，“状态”下拉式菜单中的文本从“已提交”更改为“选择状态” （错误 6501767）。

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

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

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

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

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

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

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

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

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

执行以下步骤：

如《Service Registry 3.1 Administration Guide》中的“To Use the Application Server Admin Console”中所述，登录应用服务器管理控制台。
展开“配置”节点。
展开服务器节点 server-config (Admin Config)。
单击“JVM 设置”。
单击“JVM 选项”选项卡。
单击“添加 JVM 选项”。
在文本字段中，键入以下内容（所有内容都位于一行中）：

在 Solaris OS 和 HP-UX 上：-Djava.io.tmpdir=/var/tmp

在 Windows 上：-Djava.io.tmpdir=c:\DOCUME~1\ADMINI~1\LOCALS~1\Temp
单击“保存”。
按照《Service Registry 3.1 Administration Guide》中的“To Stop and Restart the Application Server Domain for the Registry”的说明进行操作。

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

6507387：如果启用了版本更新，则尝试将现有`服务 (Service)` 添加到`组织 (Organization)` 中将失败

问题摘要：如果启用了版本更新，并且使用 JAXR 提供器创建向其中添加现有服务 (Service) 对象的组织 (Organization) 对象，然后保存组织 (Organization)，则程序将失败，并出现堆栈追踪。

6513883：在 HP-UX 系统上，使用 Internet Explorer 6 进行用户注册时将失败

问题摘要：如果在 HP-UX 系统的 Web 控制台中使用 Internet Explorer 6 执行用户注册，则在访问生成的证书时将会出现问题。具体而言，如果您注册并下载生成的证书，然后将其导入 Internet Explorer 6 中，则只能登录 Service Registry 一次，而后续的登录尝试都将失败。将在服务器日志文件中显示声明失败。

解决方法：在 HP-UX 系统上使用其他浏览器（例如 Firefox）来访问 Web 控制台。

兼容性问题

本节介绍了与兼容性相关的以下问题：

使用期限即将终止的功能

用户注册机制

此发行版的 Service Registry 依赖其自身的用户管理和验证机制。计划在将来的发行版中将 Registry 更新为基于 SAML 的机制（如 ebXML Registry 标准中所指定，此组件是该标准中的一个实现）。

与兼容性相关的错误

Service Registry 3.1 中的下列错误与兼容性相关。

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 上。

6463868：使用 JDK 1.6 的客户机程序或服务器会导致错误

问题摘要：如果在 JDK 1.6 环境中运行 JAXR 客户机程序，或将 Service Registry 部署在正在运行 JDK 1.6 的系统上，则程序执行查询或发布操作时，将导致运行时错误。根本问题在于 JDK 1.6 使用 1.3 版的 SOAP with Attachments API for Java (SAAJ)，而 Application Server 使用 1.2 版。

解决方法：需要两种类型的解决方法，一种用于客户机系统，一种用于服务器。

如果客户机运行 JDK 1.6 而服务器运行 JDK 1.5，请执行执行客户机系统解决方法中的步骤。
如果客户机运行 JDK 1.5 而服务器运行 JDK 1.6，请执行执行服务器系统解决方法中的步骤。
如果客户机和服务器都在运行 JDK 1.6，请执行这两种解决方法的步骤。

执行客户机系统解决方法

如果客户机系统在运行 JDK 1.6，则需要客户机系统解决方法。该解决方法包括以下任务：

如果 SAAJ 1.3 JAR 文件还不存在，则将其添加到类路径
在 Ant 构建文件中为客户机程序设置四个系统属性

请确保您的类路径包括以下 JAR 文件：

在 Solaris 操作系统上：

/usr/share/lib/saaj-api.jar
/usr/share/lib/saaj-impl.jar

在 Linux 和 HP-UX 系统上：

/opt/sun/share/lib/saaj-api.jar
/opt/sun/share/lib/saaj-impl.jar

例如，如果您的 Linux 系统的 Ant 目标包括如下设置，则类路径正确：

<path id="classpath">
  <fileset dir="/opt/sun/share/lib">
    <include name="*.jar"/>
  </fileset>
  ...
</path>

将以下 <sysproperty> 标记添加到 build.xml 文件中的 <java> 目标中：

<sysproperty key="javax.xml.soap.MessageFactory" 
   value="com.sun.xml.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1Impl"/>
<sysproperty key="javax.xml.soap.MetaFactory" 
   value="com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl"/>
<sysproperty key="javax.xml.soap.SOAPConnectionFactory" 
   value="com.sun.xml.messaging.saaj.client.p2p.HttpSOAPConnectionFactory"/>
<sysproperty key="javax.xml.soap.SOAPFactory" 
   value="com.sun.xml.messaging.saaj.soap.ver1_1.SOAPFactory1_1Impl"/>

执行服务器系统解决方法

服务器系统解决方法包括以下任务：

将 SAAJ 1.3 JAR 文件置于 Application Server lib 目录中
添加两个 JVM 选项以设置系统属性
停止并重新启动 Application Server

更改到 Application Server lib 目录。

在 Solaris 操作系统上：cd /opt/SUNWappserver/appserver/lib

在 Linux 和 HP-UX 系统上：cd /opt/sun/appserver/lib

在 Application Server lib 目录中建立两个 SAAJ JAR 文件的备份副本。例如：
cp saaj-api.jar saaj-api.jar.v1.2 cp saaj-impl.jar saaj-impl.jar.v1.2

将 SAAJ 1.3 JAR 文件复制到 Application Server lib 目录中。

在 Solaris 操作系统上：

cp /usr/share/lib/saaj-api.jar .
cp /usr/share/lib/saaj-impl.jar .

在 Linux 和 HP-UX 系统上：

cp /opt/sun/share/lib/saaj-api.jar .
cp /opt/sun/share/lib/saaj-impl.jar .

如《Service Registry 3.1 Administration Guide》中的“To Use the Application Server Admin Console”所述，登录 Application Server 管理控制台。

展开“配置”节点。

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

单击“JVM 设置”。

单击“JVM 选项”选项卡。

单击“添加 JVM 选项”。

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

-Djavax.xml.soap.MessageFactory=com.sun.xml.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1Impl

再次单击“添加 JVM 选项”。

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

-Djavax.xml.soap.MetaFactory=com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl

单击“保存”。

按照《Service Registry 3.1 Administration Guide》中的“To Stop and Restart the Application Server Domain for the Registry”的说明进行操作。

6475651：Application Server 升级后，Java ES 2005Q4 Service Registry 登录失败

问题摘要：如果已安装并使用先前版本的 Service Registry（从 Java ES 2005Q4），并且现在已升级到 Java ES 5 版本的 Application Server，但未升级到 Java ES 5 版本的 Service Registry，则尝试使用先前通过 Web 控制台创建的同一证书时会导致登录失败。

解决方法：编辑 web.xml 文件和 Service Registry 的安全策略文件。

要停止 Registry 的 Application Server 域并编辑 web.xml 文件，请执行以下步骤：

更改到 Service Registry 安装目录：

在 Solaris 操作系统上：cd /opt/SUNWsoar/install

在 Linux 和 HP-UX 系统上：cd /opt/sun/SUNWsoar/install
停止 Registry 的 Application Server 域：

Ant-base/ant -f build-install.xml appserver.domain.stop
更改到目录 RegistryDomain-base /domains/registry/applications/j2ee-modules/soar/WEB-INF/。
在文本编辑器中打开文件 web.xml。
在 </web-resource-collection> 标记后的 <security-constraint> 标记内，插入以下内容：
```
<auth-constraint>
  <role-name>have.client.cert</role-name>
</auth-constraint>
```

在 </security-constraints> 标记后，插入以下内容：

<error-page>
  <error-code>400</error-code>
  <location>/registry/thin/AuthenticateError.jsp</location>
</error-page>
<security-role>
  <description>all subjects who have client certificates</description>
  <role-name>have.client.cert</role-name>
</security-role>

保存并关闭 web.xml 文件。

要编辑安全策略文件并重新启动域，请执行以下步骤：

更改到以下目录：

在 Solaris 操作系统上：cd /var/opt/SUNWsoar/domains/registry/config

在 Linux 和 HP-UX 系统上：cd /var/opt/sun/SUNWsoar/domains/registry/config
在文本编辑器中打开文件 server.policy。

向此文件中添加以下授权：

grant codeBase "file:${com.sun.aas.instanceRoot}/applications/j2ee-modules/soar/WEB-INF/lib/-"{
       permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
};

grant codeBase "file:${com.sun.aas.instanceRoot}/generated/jsp/j2ee-modules/soar/-" {
      permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
};

保存并关闭 server.policy 文件。
重新启动 Registry 的 Application Server 域：

Ant-base/ant -f build-install.xml appserver.domain.start
打开 Web 浏览器，转至 URL http://localhost:6060/soar。现在，您应可以登录和发布。

6491246：在 HP-UX 平台上升级失败

问题摘要：如果在 HP-UX 系统上已安装并使用先前版本的 Service Registry（从 Java ES 2005Q4），并且现在已升级到 Java ES 5 版本的 Service Registry，则安装将失败，并显示错误消息，指出 HADB（High Availability Database，高可用性数据库）出现问题。出现的问题就是 HADB 软件包的安装位置并不是 Java ES 5 安装程序所视为的默认位置。

如果卸载Application Server的 Java ES 2005Q4 版本，然后安装 Service Registry 和Application Server的 Java ES 5 版本，也会出现此问题。

解决方法：如果已卸载Application Server，必须删除 sun-hadb 软件包，然后才能进行重新安装。

如果要直接从 Service Registry 的 Java ES 2005Q4 版本升级到 Java ES 5 版本，则步骤较为复杂：

删除 sun-hadb 软件包。
安装 Service Registry 和Application Server的 Java ES 5 版本。

按如下所示编辑文件 /opt/sun/appserver/config/asenv.conf：

将行

AS_ANT="/opt/sun/share/lib/ant/bin"

更改为

AS_ANT="/opt/sun/bin"

将行

AS_ANT_LIB="/opt/sun/share/lib/ant/lib"

更改为

AS_ANT_LIB="/opt/sun/share/lib"

添加以下两行：

AS_DERBY_INSTALL="/opt/sun/javadb"
AS_MFWK_HOME=/opt/sun/mfwk/share

在目录 /opt/sun/appserver/lib 中，创建名为 endorsed 的子目录。
将文件 /opt/sun/javadb/lib/derby.jar 复制到目录 /opt/sun/appserver/lib/endorsed 中。

本地化问题

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

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

问题摘要：在 Web 控制台中，切换浏览器语言环境并重新设置语言后，某些标签仍以先前的语言显示。

解决方法：单击“注销”或“结束会话”，然后重新启动会话或再次登录。

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

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

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

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

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

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

解决方法：可以在联机手册中找到所缺少的章节，但仅有英文版；请参见《Service Registry 3.1 User’s Guide》中的第 4 章 “Troubleshooting”。

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

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

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

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

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

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

6509544：某些错误消息没有翻译

问题摘要：某些错误消息尚未翻译成非英语语言环境。例如，当您尝试在不指定系统信息库项目的情况下创建外部对象，或者在尝试修改不属于自己的对象时，所看到的错误消息只进行了部分翻译。

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

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

6510540：重定向页面中有一行没有翻译为日文

问题摘要：在 Web 控制台中，在您登录注册表时出现的重定向页面中，最后一行没有翻译为日文。

6515105：在某些语言环境中缺少用户注册文本字段

问题摘要：在法语、德语和西班牙语语言环境下，在 Web 控制台的“用户注册向导”中，“新用户详细信息”表单中缺少“省/自治区/直辖市”的文本字段。

文档问题

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

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

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

解决方法：可以通过联机方式在《Service Registry 3.1 User’s Guide》中找到完整的“前言”部分（英文）。

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

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

解决方法：可以从《Service Registry 3.1 User’s Guide》中的“Using the Explore Tab”中找到正确的文档。

Previous: 索引

第 1 章 Service Registry 3.1 发行说明

Service Registry 3.1 中的新增功能

新的 Service Registry 的访问端口

Service Registry 的新软件包名称和安装路径名

新配置目标名称

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

特定于实现的 API

默认路径和文件名

硬件和软件要求

修补程序和所需的固件级别

Service Registry 3.1 文档

相关书籍

此发行版中修复的错误

已知问题和错误

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

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

6248418：添加分类 (Classification)、外部标识符 (ExternalIdentifier) 或插槽 (Slot) 产生的负面影响为删除外部链接 (ExternalLink)

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

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

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

6407195：大多数管理工具命令忽略 lcd 设置

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

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

6479361：“查找所有对象”的结果显示不应包括调用者的用户 (User) 对象

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

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

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

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

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

6507387：如果启用了版本更新，则尝试将现有服务 (Service) 添加到组织 (Organization) 中将失败

6513883：在 HP-UX 系统上，使用 Internet Explorer 6 进行用户注册时将失败

兼容性问题

使用期限即将终止的功能

用户注册机制

与兼容性相关的错误

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

6463868：使用 JDK 1.6 的客户机程序或服务器会导致错误

执行客户机系统解决方法

执行服务器系统解决方法

6475651：Application Server 升级后，Java ES 2005Q4 Service Registry 登录失败

6491246：在 HP-UX 平台上升级失败

本地化问题

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

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

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

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

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

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

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

6509544：某些错误消息没有翻译

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

6510540：重定向页面中有一行没有翻译为日文

6515105：在某些语言环境中缺少用户注册文本字段

文档问题

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

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

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

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

6248418：添加`分类 (Classification)`、`外部标识符 (ExternalIdentifier)` 或`插槽 (Slot)` 产生的负面影响为删除`外部链接 (ExternalLink)`

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

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

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

6407195：大多数管理工具命令忽略 `lcd` 设置

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

6507387：如果启用了版本更新，则尝试将现有`服务 (Service)` 添加到`组织 (Organization)` 中将失败

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