test

Sun Java System Communications Services 2005Q4 发行说明

安装、升级和配置

如果从 Application Server 7.x（Java ES 发行版 2）升级至 Application Server 8.x（Java ES 发行版 4），然后再升级至 Delegated Administrator 6 2005Q4（Java ES 发行版 4），则 Delegated Administrator 将无法重新部署至已升级的 Application Server。(6319257)

升级至 Application Server 8.x 后，应用程序（例如 Delegated Administrator）将自动重新部署至非 DAS server1 实例。为保持兼容性，非 DAS 实例将与先前版本的 Application Server 运行在同一端口上。

但是，Delegated Administrator 使用 deploydir 命令部署至 Application Server。在 Application Server 8.x 中，deploydir 命令仅对 DAS 实例有效。无法将 Delegated Administrator 部署至非 DAS 实例中。

解决方法

升级至 Application Server 8.x 后，采取以下步骤：

  1. 修改以下 Access Manager 配置属性文件：


    /opt/SUNWam/lib/AMConfig.properties

    将下面一行：


    com.sun.identity.webcontainer=IAS7.0

    替换为


    com.sun.identity.webcontainer=IAS8.1

  2. 运行 Delegated Administrator 配置程序之前，从升级的 Application Server 的 server1 实例中取消对 /commcli 和 /da Web 应用程序的部署。运行以下命令：


    /opt/SUNWappserver/appserver/bin/asadmin undeploy 
--secure=false --user admin --password xxxx
--target server1 commcli
    		 

    /opt/SUNWappserver/appserver/bin/asadmin undeploy 
--secure=false --user admin --password xxxx
--target server1 da

  3. 运行 Delegated Administrator 配置程序 config-commda。系统提示输入 Access Manager 主机和端口时，为 DAS 服务器实例指定端口。

    指定 DAS 服务器实例，即使 Access Manager 运行在非 DAS server1 实例中。

    当 config-commda 程序询问部署 Delegated Administrator 控制台和 Delegated Administrator 服务器的位置时，指定 DAS 服务器信息，而不要指定 server1 信息。

    如果已配置了带有 server1 端口的 Delegated Administrator（如果已运行 config-commda），则在下列两个文件中修改端口信息（以指定 DAS 端口）：


    /opt/SUNWcomm/config/cli-usrprefs.properties

/var/opt/SUNWcomm/da/WEB-INF/class/com/sun/comm/da/resource/
daconfig.properties

  4. 运行 config-commda 后，登录到 Application Server 控制台。将 JVM 设置中的 classpath-prefix 和 classpath-suffix 条目的所有 Access Manager 库路径从 server1 实例复制到服务器实例中。该任务可以通过将 server1 domain.xml 文件中的路径复制到服务器 domain.xml 文件中完成。

Delegated Administrator 配置程序允许您在“域分隔符”字段中输入无效值。(6310711)

在配置程序 config-commda 中，您可以在“域分隔符”字段中输入无效字符（例如 ^）。不能使用带有无效的域分隔符字符的登录 ID 登录 Delegated Administrator 控制台。

解决方法：

编辑 daconfig.properties 文件中 commadminserver.domainseparator 属性的值，该文件位于以下默认路径：


/var/opt/SUNWcomm/da/WEB-INF/classes/
com/sun/comm/da/resources/daconfig.properties

使用有效值，例如 @、- 或 _。

升级至 Access Manager 7.0 而没有升级至 Delegated Administrator 6 2005Q4（Java ES 发行版 4）将导致用户创建失败。(6294603)

升级至 Java Enterprise System 发行版 4 时，如果将 Access Manager 从版本 6.x 升级至 7.0 但没有将 Delegated Administrator 升级至版本 6 2005Q4（Java ES 发行版 4），则带有邮寄或日历服务的用户创建将失败。

解决方法：

  1. 更新 UserCalendarService.xml 文件，该文件默认情况下位于以下目录中：


    /opt/SUNWcomm/lib/services/UserCalendarService.xml

    在 UserCalendarService.xml 文件中，将 mail、icssubcribed 和 icsfirsday 属性标记为可选属性，而非必需属性。

  2. 在 Access Manager 中，运行 amadmin 命令删除现有的 xml 文件，如下所示：


    amadmin -u amadmin -w netscape -r UserCalendarService

  3. 在 Access Manager 中，添加更新的 xml 文件，如下所示：


    amadmin -u amadmin -w netscape  
-s /opt/SUNWcomm/lib/services/UserCalendarService.xml

  4. 重新启动 Web 容器。

如果目录中部署了大量的组织，Delegated Administrator 配置程序 (config-commda) 可能会运行缓慢。(6219610)

如果目录中包含大量的组织（50000 或更多），Delegated Administrator 配置程序 (config-commda) 可能需要很长时间才能完成。Access Manager 相关管理任务的执行速度将降低。

解决方法

创建 ou 属性的 pres,eq 索引。

当使用 config-commda 程序重新配置 Delegated Administrator 时，resource.properties 文件中的值将被覆写。(6218713)

如果再次运行 config-commda 程序以配置现有的、已配置的 Delegated Administrator 安装，resource.properties 文件中的属性将重置为其默认值。

例如，如果先前将以下属性设置为这些值：

jdapi-wildusersearchresults=50

jdapi-wildorgsearchresults=10

然后运行 config-commda，这些属性将重置为其默认值，如下所示：

jdapi-wildusersearchresults=-1

jdapi-wildorgsearchresults=-1

仅当您更改了 Delegated Administrator 配置（如果启用了插件或修改了 resource.properties 文件中的任何属性值）才会涉及该问题。

解决方法

如果需要升级 Delegated Administrator 或因其他原因而需要重新运行 config-commda 程序，可以采取以下步骤保存现有配置：

  1. 备份 resource.properties 文件。

    resource.properties 文件默认情况下位于以下路径：


    da_base/data/WEB-INF/classes/sun/comm/cli/server/servlet/
resource.properties

  2. 运行 config-commda 程序。

  3. 编辑由 config-commda 程序创建的新的 resource.properties 文件，如下所示：

    （新文件位于上述“1. 备份 resource.properties 文件”中所示的默认路径中。）

    a. 打开新的 resource.properties 文件。

    b. 打开 resource.properties 文件的备份。

    c. 查找在备份中自定义的属性。将这些自定义值应用到新 resource.properties 文件的相应属性中。

不要简单使用整个备份覆写新的 resource.properties 文件。新文件可能包含为支持此发行版的 Delegated Administrator 而创建的新属性。