Sun Java logo     上一页      目录      索引      下一页     

Sun logo
Sun Java Enterprise System 2005Q4 升级指南 

第 17 章
Portal Server

本章介绍如何将 Portal Server 升级到 Java ES 2005Q4（发行版本 4）：Sun Java System Portal Server 6.3.1 2005Q4。其中概括介绍了 Java ES 发行版本 4 所支持的不同升级途径的升级问题和过程。本章内容涵盖了 Solaris 和 Linux 操作系统上的升级：

Portal Server 升级概述

本节将在以下方面对 Portal Server 进行介绍，这些方面会对升级到 Java ES 2005Q4（发行版本 4）产生影响：

关于 Java ES 发行版本 4 Portal Server

Java ES 发行版本 4 Portal Server 在功能上与发行版本 3 相同，但包含了自发行版本 3 以来所做的错误修复。

Portal Server 升级指导说明

表 17-1 显示了所支持的升级至 Java ES 发行版本 4 的 Portal Server 升级途径。此表既适用于 Solaris，也适用于 Linux 操作系统。

表 17-1  升级到 Java ES 发行版本 4：Sun Java System Portal Server 6.3.1 2005Q4 的途径 

Java ES 发行版本

Portal Server 版本

常规方法

必需的重新配置

发行版本 3

Sun Java System Portal Server 6.3.1 2005Q1

直接升级：
通过应用修补程序执行。对此有一些限制（参见过程说明）。

无

发行版本 2

Sun Java System Portal Server 6.3 2004Q2

直接升级：
执行方式是通过应用修补程序升级到发行版本 4，重新配置软件，然后重新部署到 Web 容器。

配置数据

发行版本 1

Sun ONE Portal Server 6.2 (2003Q4)

不直接升级：
但可通过以下方式执行：首先升级到发行版本 3，然后通过应用修补程序升级到发行版本 4。对此有一些限制（参见过程说明）。

配置数据

Java ES 以前的发行版本

 

不直接升级。

 

Portal Server 数据

下表显示了可能受 Portal Server 软件升级影响的数据类型。

表 17-2  Portal Server 数据用途 

数据类型

位置

用途

配置数据

PortalServerConfig-base/

Portal Server 的配置。

Web 容器配置

Web Server：
server.policy 和 server.xml 文件，位于
WebServer-base/https-hostname/config

Application Server（Java ES 发行版本 3 和 4）：
server.policy 和 domain.xml 文件，位于
AppServer8Config-base/domains/domainName/config

Application Server （Java ES 发行版本 2）：
server.policy 和 server.xml 文件，位于
AppServer7Config-base/domains/domainName/config

Portal Server Web 容器实例的配置。

自定义数据

PortalServerConfig-base/desktop

自定义模块的 JAR 文件。

自定义的 Portal Server 桌面样例。

目录模式

服务配置

用户数据

Directory Server

Portal Server 依赖于服务配置（如门户桌面）和存储在目录中的用户配置文件数据。

动态应用程序数据

无

Portal Server 并不永久存储应用程序数据（如会话状态）。

兼容性问题

发行版本 4 Portal Server 的接口没有任何变化。Portal Server 组件（包括移动访问组件）与早期版本向后兼容。

Portal Server 组件依赖性

Portal Server 对其他 Java ES 组件的依赖性会影响升级和重新配置 Portal Server 软件的过程。例如，Portal Server 接口或功能上的变化可能要求 Portal Server 所依赖组件的升级版本。是否需要升级此类组件取决于具体的升级途径。

Portal Server 对以下 Java ES 组件具有依赖性：

从 Java ES 发行版本 3 升级 Portal Server

本节包含将 Portal Server 从 Java ES 2005Q1（发行版本 3）升级到 Java ES 2005Q4（发行版本 4）的有关信息。

注

对于 Portal Server 已部署于 Application Server Web 容器中且在升级到发行版本 4 之前已从发行版本 2 升级到发行版本 3 的特殊情况，本节不适用。当前不支持上述升级途径。

本节涵盖了以下主题：

简介

将 Java ES 发行版本 3 Portal Server 升级至发行版本 4 时，请考虑升级过程中的以下方面：

发行版本 3 Portal Server 的升级

本节介绍如何在 Solaris 和 Linux 平台上将 Portal Server 从 Java ES 发行版本 3 升级至 Java ES 发行版本 4。如果其中某个主题取决于具体平台的过程，则该主题将指明所适用的操作系统。本节包括以下主题：

升级前的任务

升级 Portal Server 之前，应执行下述任务。

检验当前版本信息

可使用以下命令检验 Portal Server 的当前版本：

升级 Portal Server 依赖项

通常建议将计算机系统（以及计算环境）中的所有 Java ES 组件均升级到 Java ES 发行版本 4。但是，Portal Server 仅对 Mobile Access Core (MA Core) 共享组件具有硬性升级依赖性。因此，Portal Server 所依赖的其他 Java ES 发行版本 3 组件的升级是可选的。

但是，如果选择升级 Portal Server 所依赖的所有组件，则它们应按以下顺序升级，并且应在升级 Portal Server 之前进行。您可以跳过任何可能已经升级的依赖组件。

  1. 共享组件。  升级 Java ES 共享组件中提供了将 Java ES 共享组件升级到发行版本 4 的说明。
  2. Directory Server。  第 4 章“Directory Server 和 Administration Server”中提供了将 Directory Server 升级至发行版本 4 的说明。
  3. Web 容器软件。  第 6 章“Web Server”和第 9 章“Application Server”中分别提供了升级 Web Server 或 Application Server 的说明。

    4. 注

    升级诸如来自 WebLogic 和 WebSphere 的第三方 Web 容器可能导致 Portal Server 中断，因为在容器升级时会改写为了支持 Portal Server 而对这些容器所做的自定义设置。

    在此情况下，必须为升级后的 Web 容器环境重新安装和重新配置 Portal Server。

  4. Access Manager (Access Manager SDK)。  第 11 章“Access Manager”中提供了将 Access Manager 升级至发行版本 4 的说明。
备份发行版本 3 Portal Server 配置信息

将 Portal Server 升级至发行版本 4 时，无需重新配置 Portal Server 软件。但是，为安全起见，可以备份存储配置信息的下列目录：

获取所需的配置信息和密码

必须以超级用户身份登录才能执行升级。如果要将 Web Server 用作 Web 容器，则无需任何配置信息。但如果要将 Application Server 用作 Web 容器，则将需要 Application Server 管理员用户 ID 和密码。

升级发行版本 3 Portal Server (Solaris)

本节讨论影响 Portal Server 升级过程的一些注意事项，随后对升级过程本身加以说明。

升级注意事项 (Solaris)

将 Portal Server 软件升级至 Java ES 发行版本 4 时，应考虑以下注意事项：

升级过程 (Solaris)

下述过程适用于要进行升级的计算机中的 Portal Server。

  1. 根据表 17-4，获取所需的修补程序。

    2. 若未指明使用某个特定修订版本，始终应使用可用的最新修补程序修订版本。

    可从以下网址将修补程序下载到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  2. 以 root 身份登录，或成为超级用户。

    3. su -

  3. 通过停止其 Web 容器，停止 Portal Server。

    4. Web Server：
    WebServer-base/https-instanceName/stop

    Application Server：
    AppServer8-base/bin/asadmin stop-domain domainName

  4. 升级 MA Core 共享组件以及您希望升级的任何其他共享组件（如果尚未执行此操作）。

    5. 参见升级 Portal Server 依赖项。

  5. 应用表 17-4 中相应的 Portal Server 修补程序。

    6. 确保先应用 Portal Server 核心修补程序，然后再应用两个 Portal Server 本地化修补程序。

    patchadd patch_ID

  6. 确认修补程序升级成功：

    7. showrev -p | grep patch_ID

    输出应返回在步骤 5 中应用的修补程序 ID 的版本。

  7. 通过重新启动其 Web 容器，重新启动 Portal Server。

    8. Web Server：
    WebServer-base/https-instanceName/start

    Application Server：
    AppServer8-base/bin/asadmin start-domain --user admin_ID
         --password     password domainName

  8. 将 Portal Server Web 应用程序重新部署到 Web 容器。

    9. PortalServer-base/bin/deploy redeploy

    redeploy 命令会将内容从 PortalServer-base/web-src 重新部署至 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，应首先对 /web-src 进行 Portal Server Web 应用程序的任何自定义设置，然后再将其部署至 /web-apps。运行 deploy 命令之前，应在 /web-src 中复制可能在 /web-apps 下所做的任何更改，否则，此类更改将会被改写。

  9. 停止并重新启动 Web 容器。

    10. 虽然并非在所有情况下都需要重新启动 Web 容器，但这样做可确保 Portal Server 在干净的状态下启动。

升级发行版本 3 Portal Server (Linux)

本节讨论影响 Portal Server 升级过程的一些注意事项，随后对升级过程本身加以说明。

升级注意事项 (Linux)

除 Linux 发行版本 4 的升级修补程序与 Solaris 的修补程序不同外，在 Linux 平台上将 Portal Server 软件升级到 Java ES 发行版本 4 的注意事项与在 Solaris 平台上相同（参见升级注意事项 (Solaris)）。

下表显示了 Linux 操作系统的发行版本 4 的 Portal Server 升级修补程序：

表 17-5  用于在 Linux 上升级 Portal Server 的修补程序1 

说明

修补程序 ID 和 RPM 名称

Portal Server 核心组件

118952-12

  • sun-portal-core-6.3-25.12.i386.rpm

以及用于 Portal 桌面和 Portal Server 移动访问的许多其他 RPM。

Portal Server 本地化版本

119426-07

  • sun-portal-core-Locale-6.3-24.i386.rpm

以及用于 Portal Server 移动访问、配置、标识和其他组件的许多其他 RPM。

Portal Server
本地化配置程序

118116-08

  • sun-portal-l10n-configurator-6.3-24.i386.rpm

1修补程序修订版本号是升级到 Java ES 发行版本 4 所需的最低版本号。如果有较新的修订版本可用，请用较新版本替代该表中所示的版本。

升级过程 (Linux)

下述过程适用于要进行升级的计算机中的 Portal Server。

注意

在 Linux 上从 Java ES 发行版本 3 升级至 Java ES 发行版本 4 无法回滚。

  1. 使用表 17-5 中的修补程序号和 RPM 名称，获取所需的修补程序。使用此信息获取 RPM 的版本号。

    2. 可从以下网址将修补程序下载到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  2. 以 root 身份登录，或成为超级用户。

    3. su -

  3. 通过停止其 Web 容器，停止 Portal Server。

    4. Web Server：
    WebServer-base/https-instanceName/stop

    Application Server：
    AppServer8-base/bin/asadmin stop-domain domainName

  4. 升级 MA Core 共享组件以及您希望升级的任何其他共享组件（如果尚未执行此操作）。

    5. 参见升级 Portal Server 依赖项。

  5. 应用表 17-5 中用于 Portal Server 核心修补程序的 RPM。

    6. cd /tmp

    其中，/tmp 是步骤 1 中修补程序的下载目录。

    ./update

    更新脚本会安装 RPM 并确保因应用了修补程序而产生正确的配置变化。

  6. 确认修补程序升级成功：

    7. rpm -qa | grep sun-portal-core-6.3-25

    应返回 RPM 的升级修订版本号。

  7. 应用表 17-5 中用于两个 Portal Server 本地化修补程序的 RPM。

    8. rpm -Fvh --replacefiles sun-portal-*-Locale-6.3-24.i386.rpm
    rpm -Fvh --replacefiles
         sun-portal-l10n-configurator-6.3-24.i386.rpm

  8. 确认修补程序升级成功：

    9. rpm -qa | grep sun-portal-l10n-configurator-6.3-24

    应返回 RPM 的升级修订版本号。

  9. 通过重新启动其 Web 容器，重新启动 Portal Server。

    10. Web Server：
    WebServer-base/https-instanceName/start

    Application Server：
    AppServer8-base/bin/asadmin start-domain --user admin_ID
         --password     password domainName

  10. 将 Portal Server Web 应用程序重新部署到 Web 容器。

    11. PortalServer-base/bin/deploy redeploy

    redeploy 命令会将内容从 PortalServer-base/web-src 重新部署至 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，应首先对 /web-src 进行 Portal Server Web 应用程序的任何自定义设置，然后再将其部署至 /web-apps。运行 deploy 命令之前，应在 /web-src 中复制可能在 /web-apps 下所做的任何更改，否则，此类更改将会被改写。

  11. 停止并重新启动 Web 容器。

    12. 虽然并非在所有情况下都需要重新启动 Web 容器，但这样做可确保 Portal Server 在干净的状态下启动。

检验升级

通过确认是否已正确应用升级修补程序来检验 Portal Server 到发行版本 4 的升级。升级过程 (Solaris) 和升级过程 (Linux) 中包括此检验的步骤。

此外，还可使用以下命令：

参见表 17-3 确认输出值。

除了对修补程序升级进行这些测试外，还可以检验先前正常运行的程序是否仍然正常，以及是否确实修复了所关注的错误。

升级后的任务

除升级过程 (Solaris) 和升级过程 (Linux) 中所述的步骤之外，没有任何升级后的任务。

升级回滚 (Solaris)

本节介绍影响 Portal Server 升级回滚过程的一些注意事项，随后对升级回滚过程本身加以说明。

回滚注意事项 (Solaris)

升级至发行版本 4 的 Portal Server 的升级回滚过程几乎就是升级至发行版本 4 的相反过程。该过程将回滚重新配置并删除修补程序。

回滚过程 (Solaris)
  1. 以 root 身份登录，或成为超级用户。

    2. su -

  2. 通过停止其 Web 容器，停止 Portal Server。

    3. Web Server：
    WebServer-base/https-instanceName/stop

    Application Server：
    AppServer8-base/bin/asadmin start-domain --user admin_ID
         --password     password domainName

  3. 删除表 17-4 中的修补程序。

    4. patchrm patch_ID

  4. 通过重新启动其 Web 容器，重新启动 Portal Server。

    5. Web Server：
    WebServer-base/https-instanceName/start

    Application Server：
    AppServer8-base/bin/asadmin start-domain domainName
         --user admin_ID --password password

  5. 将 Portal Server Web 应用程序重新部署到 Web 容器。

    6. PortalServer-base/bin/deploy redeploy

    redeploy 命令会将内容从 PortalServer-base/web-src 重新部署至 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，应首先对 /web-src 进行 Portal Server Web 应用程序的任何自定义设置，然后再将其部署至 /web-apps。运行 deploy 命令之前，应在 /web-src 中复制可能在 /web-apps 下所做的任何更改，否则，此类更改将会被改写。

  6. 停止并重新启动 Web 容器。

    7. 虽然并非在所有情况下都需要重新启动 Web 容器，但这样做可确保 Portal Server 在干净的状态下启动。

多实例升级

在一些部署体系结构中，Portal Server 被部署在多个计算机系统上，以提供可伸缩性和提高可用性。例如，您可以在多台计算机上运行 Portal Server 组件，并使用一个负载平衡器来分配负载。

就 Portal Server 负载平衡的实例而言，可执行滚动升级，期间您可依序升级各个 Portal Server 实例而不中断服务。在升级每个 Portal Server 实例时，其他实例仍可保持运行。可按发行版本 3 Portal Server 的升级中所述升级每个实例。

从 Java ES 发行版本 2 升级 Portal Server

本节包含将 Portal Server 从 Java ES 2004Q2（发行版本 2）升级到 Java ES 2005Q4（发行版本 4）的有关信息。

鉴于发行版本 2 Portal Server 升级的复杂性和可能出现的相当长的停机时间，您可能会选择在另一台计算机上执行平行升级，而不是在生产系统上进行就地升级。此种方法对于只容许有限停机时间的业务攸关或复杂的 Portal Server 解决方案较为可取。升级过程的持续时间还取决于重新实现和测试任何必要的 Portal Server 自定义内容所需的时间。

另外，为适应特定的升级方案，可能有必要对本节中的说明进行修改或调整。在此情况下，建议在执行升级时向 Sun Microsystems 支持服务寻求帮助。

本节包含有关从发行版本 2 升级到发行版本 4 的以下主题：

简介

将 Java ES 发行版本 2 Portal Server 升级至发行版本 4 时，请考虑升级过程中的以下方面：

发行版本 2 Portal Server 的升级

本节介绍如何在 Solaris 和 Linux 平台上将 Portal Server 从 Java ES 发行版本 2 升级至 Java ES 发行版本 4。如果其中某个主题取决于具体平台的过程，则该主题将指明所适用的操作系统。本节包括以下主题：

升级前的任务

升级 Portal Server 之前，应执行下述任务。

检验当前版本信息

可使用以下命令检验 Portal Server 的当前版本：

参见表 17-3 确认输出值。

升级 Portal Server 依赖项

Java ES 发行版本 4 不支持发行版本 2 和发行版本 4 的共享组件在一台计算机上共存。

因此，必须将 Portal Server 所依赖的所有本地 Java ES 发行版本 2 组件全部升级到发行版本 4。在升级计算机上 Portal Server 所依赖的所有本地组件时，应按以下顺序升级，并且全部应在升级 Portal Server 之前进行。请注意，对于特定升级方案有特殊的要求。

  1. 共享组件。  升级 Java ES 共享组件中提供了将 Java ES 共享组件升级到发行版本 4 的说明。
  2. Directory Server。  Portal Server 很少依赖于本地 Directory Server。但是在第 4 章“Directory Server 和 Administration Server”中依然提供了将 Directory Server 升级到发行版本 4 的说明。
  3. Web 容器软件。  Portal Server 可在 Web Server 或 Application Server 所提供的 Web 容器中运行。
    • Web Server：按照从 Java ES 发行版本 2 升级 Web Server 中的过程升级到发行版本 4 Web Server。
    • Application Server：不按照从 Java ES 发行版本 2 升级 Application Server 中的过程，而是通过使用 Java ES 安装程序执行 Application Server 的全新安装，将其升级到发行版本 4 Application Server。安装发行版本 4 Application Server 8 之前，请务必从发行版本 2 Application Server 7 中获取管理端口和服务器实例端口。

      • 注

      升级诸如来自 WebLogic 和 WebSphere 的第三方 Web 容器可能导致 Portal Server 中断，因为在容器升级时会改写为了支持 Portal Server 而对这些容器所做的自定义设置。

      在此情况下，必须为升级后的 Web 容器环境重新安装和重新配置 Portal Server。

  4. Access Manager (Access Manager SDK)。  Portal Server 可以与 Access Manager 在相同或不同的 Web 容器中运行。
备份发行版本 2 Portal Server 配置信息

将 Portal Server 升级到发行版本 4 时，必须重新配置 Portal Server 软件。为安全起见，可以备份存储配置信息的下列目录：

获取所需的配置信息和密码

必须以超级用户身份登录才能执行升级。如果使用 Web Server 作为 Web 容器，无需任何管理员密码。但如果使用 Application Server 作为 Web 容器，则需要 Application Server 管理员用户 ID 和密码。

升级发行版本 2 Portal Server (Solaris)

本节讨论影响 Portal Server 升级过程的一些注意事项，随后对升级过程本身加以说明。

升级注意事项 (Solaris)

将 Portal Server 软件升级至 Java ES 发行版本 4 时，应考虑以下注意事项：

升级过程（Solaris：Web Server）

下述过程适用于要进行升级的计算机中的 Portal Server。

  1. 根据表 17-6，获取所需的修补程序。

    2. 确保下载恰如表 17-6 中所示的修补程序修订版本，但 Portal Server 修复除外，对于这些修复可能有较新的修补程序可用。

    可从以下网址将修补程序下载到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  2. 以 root 身份登录，或成为超级用户。

    3. su -

  3. 通过停止其 Web 容器，停止 Portal Server。

    4. WebServer-base/https-instanceName/stop

  4. 升级所有共享组件、Web 容器和 Access Manager（或 Access Manager SDK）（如果尚未执行此操作）。

    5. 参见升级 Portal Server 依赖项。

  5. 启动 Directory Server 和 Access Manager（如果它们尚未运行）。
  6. 应用表 17-6 中相应的 Portal Server 修补程序。

    7. 确保按照表 17-6 中所示从上到下的顺序应用修补程序。

    patchadd patch_ID

  7. 确认修补程序升级成功：

    8. showrev -p | grep patch_ID

    输出应返回在步骤 7 中应用的修补程序 ID 的版本。

  8. 重新配置 Portal Server 软件：

    9. ksh

    $ cd PortalServer-base/lib
    $ ./upgradePS04Q205Q1

  9. 通过重新启动其 Web 容器，重新启动 Portal Server。

    10. WebServer-base/https-instanceName/start

  10. 将 Portal Server Web 应用程序重新部署到 Web 容器。

    11. PortalServer-base/bin/deploy redeploy

    redeploy 命令会将内容从 PortalServer-base/web-src 重新部署至 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，应首先对 /web-src 进行 Portal Server Web 应用程序的任何自定义设置，然后再将其部署至 /web-apps。运行 deploy 命令之前，应在 /web-src 中复制可能在 /web-apps 下所做的任何更改，否则，此类更改将会被改写。

  11. 停止并重新启动 Web 容器。

    12. 虽然并非在所有情况下都需要重新启动 Web 容器，但这样做可确保 Portal Server 在干净的状态下启动。

升级过程（Solaris：Application Server）

下述过程适用于要进行升级的计算机中的 Portal Server。

  1. 根据表 17-6，获取所需的修补程序。

    2. 确保下载恰如表 17-6 中所示的修补程序修订版本，但 Portal Server 修复除外，对于这些修复可能有较新的修补程序可用。

    可从以下网址将修补程序下载到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  2. 以 root 身份登录，或成为超级用户。

    3. su -

  3. 确保 Portal Server 不再在其发行版本 2 的 Application Server 实例中运行。

    4. AppServerConfig7-base/domains/domainName/instanceName/bin/stopserv

    在上述命令及后续步骤中采用了以下约定：

    • 默认的 domainName 为 domain1
    • 默认的 instanceName 为 server1
  4. 升级所有共享组件、Web 容器和 Access Manager（或 Access Manager SDK）（如果尚未执行此操作）。

    5. 参见升级 Portal Server 依赖项。

  5. 确保已升级的 Access Manager 未在其发行版本 4 的 Application Server 实例中运行。

    6. AppServer8-base/bin/asadmin stop-domain domainName

  6. 确保 Access Manager 配置文件

    7. AccessManagerConfig-base/config/AMConfig.properties

    包含以下属性值：

    com.iplanet.am.notification.url=
        http://    hostName:port/amserver/notificationservice
    com.sun.identity.webcontainer=IAS8.1
    com.iplanet.am.cookie.encode=true

    其中，hostName:port 为托管 Access Manager 实例的计算机和端口。

  7. 应用表 17-6 中相应的 Portal Server 修补程序。

    8. 确保按照表 17-6 中所示从上到下的顺序应用修补程序。

    patchadd patch_ID

  8. 确认修补程序升级成功：

    9. showrev -p | grep patch_ID

    输出应返回在步骤 7 中应用的修补程序 ID 的版本。

  9. 确保 Portal Server 配置文件

    10. PortalServerConfig-base/PSConfig.properties

    包含以下属性值，这些属性值引用了 Application Server 的 Domain Administration Server (DAS) 实例：

    DEPLOY_TYPE=SUNONE8 DEPLOY_INSTANCE_DIR=AppServer8Config-base/domains/domainName
    DEPLOY_DOMAIN=AppServer8Config-base/domains/domainName
    DEPLOY_PRODUCT_DIR=AppServer8Config-base/domains/domainName
    DEPLOY_ADMIN_PROTOCOL=https
    DEPLOY_ADMIN_PORT=    DAS_adminPort （例如，默认值 = 4848）
    DEPLOY_ADMIN_HOST=DAS_hostName
     LOAD_BALANCER_URL=http://DAS_hostName:DAS_hostPort/portal
    DEPLOY_DOCROOT=    AppServer8Config-base/domains/domainName/docroot
    PS_PORT=    DAS_hostPort （例如，默认值 = 80）
    DEPLOY_DIR=AppServer8-base
     PS_PROTOCOL=http

    假定分配给全新安装的发行版本 4 Application Server 8 的端口值与分配给所安装的发行版本 2 Application Server 7 的端口值相同，并且这些端口值是默认端口值，则上面所示的默认值将适用。

  10. 按如下所示修改 PSconfig.properties 文件：

    11. DEPLOY_INSTANCE=temporary_instanceName

    其中，temporary_instanceName 是一个未使用的临时值。

  11. 确保 DAS 正在运行。

    12. AppServer8-base/bin/asadmin start-domain --user admin_ID
         --password password domainName

  12. 执行以下命令：

    13. cd PortalServer-base/bin
    ./multiserverinstance

    multiserverinstance 脚本询问的许多问题使用步骤 9 中所示文件 PSConfig.properties 中设置的值作为默认值，以下说明假设这些默认值是正确的。

    按如下所示回答 multiserverinstance 脚本所问的问题：

    1. 为 Create a new portalserver instance（创建新的 portalserver 实例）选择选项 1。
    2. 为 Sun Java System Application Server 8.1 选择选项 3。
    3. Where is the Web Container installed?（Web 容器安装在何处？）按回车键。
    4. What is the domain name?（域名是什么？）按回车键。
    5. What is the domain (DAS) path?（域 (DAS) 路径是什么？）输入第 4 个问题中显示的那个默认值。
    6. What is the Web Container instance path?（Web 容器实例的路径是什么？）输入第 5 个问题中所输入的那个值。
    7. What is the Web Container administrator?（Web 容器管理员是什么？）按回车键。
    8. What is the Web Container administration port?（Web 容器管理端口是什么？）按回车键。
    9. Is the Web Container administration port secure?（Web 容器管理端口是否安全？）按回车键。
    10. Instance name?（实例名？）输入值 server。
    11. Instance port?（实例端口？）输入在 PSConfig.properties 文件中为 PS_PORT 值输入的那个值。
    12. Is the instance port secure?（实例端口是否安全？）按回车键。
    13. What is the Web Container document root directory?（Web 容器文档根目录是什么？）按回车键。
    14. What is the Application Server administration password?（Application Server 管理密码是什么？）输入密码。
    15. What is the Identity Server administration password?（Identity Server 管理密码是什么？）输入密码。

  13. 按如下所示修改 PSconfig.properties 文件：

    14. DEPLOY_INSTANCE=server

    其中，值 server 为 DAS 实例的默认实例名。

  14. 重新启动 DAS。

    15. AppServer8-base/bin/asadmin stop-domain domainName

    AppServer8-base/bin/asadmin start-domain --user admin_ID
         --password password domainName

  15. 部署 Portal Server Web 应用程序。

    16. cd PortalServer-base/bin
    ./deploy redeploy

    忽略指示 deploy.log 中可能有错误的消息。

    redeploy 命令会将内容从 PortalServer-base/web-src 重新部署至 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，应首先对 /web-src 进行 Portal Server Web 应用程序的任何自定义设置，然后再将其部署至 /web-apps。运行 deploy 命令之前，应在 /web-src 中复制可能在 /web-apps 下所做的任何更改，否则，此类更改将会被改写。

  16. 重新配置 Portal Server 软件：

    17. ksh

    $ cd PortalServer-base/lib
    $ ./postinstall_PortletSamples
    $ ./upgradePS04Q205Q1

    忽略 upgradePS04Q205Q1 脚本所发出的与 CLI137 相关的错误以及与（取消）部署相关的错误。

  17. 重新启动 DAS。

    18. AppServer8-base/bin/asadmin stop-domain domainName

    AppServer8-base/bin/asadmin start-domain --user admin_ID
         --password password domainName

    虽然并非在所有情况下都需要重新启动 Web 容器，但这样做可确保 Portal Server 在干净的状态下启动。

  18. 更新 Portal Server 显示配置文件。
    1. 执行以下命令：

      2. PortalServer-base/bin/dpadmin list -g -u amadminDN
           -w amadminPassword /tmp/GlobalDP.xml

      其中，amadminDN 的值可在 AccessManagerConfig-base/config/AMConfig.properties 文件的属性 com.sun.identity.authentication.super.user 中找到。

    2. 打开文件 /tmp/GlobalDP.xml 进行编辑
    3. 将下面的值：

      4. org.apache.xalan.xsltc.trax.TransformerFactoryImpl
      修改为
      com.sun.org.apache.xalan.internal.xsltc.trax.
           TransformerFactoryImpl

    4. 将出现的所有以下值：

      5. Sun JavaTM System Portal Server 6 2004Q2
      修改为
      Sun JavaTM System Portal Server 6 2005Q4

    5. 执行以下命令：

      6. PortalServer-base/bin/dpadmin modify -g -u amadminDN
           -w amadminPassword /tmp/GlobalDP.xml

      其中，amadminDN 的值与步骤 a 中的值相同。

升级发行版本 2 Portal Server (Linux)

本节讨论影响 Portal Server 升级过程的一些注意事项，随后对升级过程本身加以说明。

升级注意事项 (Linux)

除 Linux 发行版本 4 的升级修补程序与 Solaris 的修补程序不同外，在 Linux 平台上将 Portal Server 软件升级到 Java ES 发行版本 4 的注意事项与在 Solaris 平台上相同（参见升级注意事项 (Solaris)）。

下表显示了 Linux 操作系统的发行版本 4 的 Portal Server 升级修补程序：

表 17-7  在 Linux 上将 Portal Server 升级到发行版本 4 的修补程序 

说明

修补程序 ID 和 RPM 名称

Portal Server 核心组件

118020-16

sun-portal-module-6.3-25.i386.rpm

其中，module 是约 70 个不同软件模块的任意一个

Mobile Access 核心组件

119529-02

  • sun-mobileaccess-1.0-25.2.i386.rpm
  • sun-mobileaccess-config-1.0-25.2.i386.rpm

Portal Server 修复

118952-15（或更高版本）

  • sun-portal-core-6.3-xx.y.i386.rpm
  • sun-portal-configurator-6.3-xx.y.i386.rpm
  • sun-portal-mobileaccess-6.3-xx.y.i386.rpm
  • sun-portal-desktop-6.3-xx.y.i386.rpm
  • sun-portal-sample-6.3-xx.y.i386.rpm
  • sun-portal-mobileaccess-config-6.3-xx.y.i386.rpm

升级过程（Linux：Web Server）

下述过程适用于要进行升级的计算机中的 Portal Server。

  1. 使用表 17-7 中的修补程序号和 RPM 名称，获取所需的修补程序。使用此信息获取 RPM 的版本号。

    2. 可从以下网址将修补程序下载到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  2. 以 root 身份登录，或成为超级用户。

    3. su -

  3. 通过停止其 Web 容器，停止 Portal Server。

    4. WebServer-base/https-instanceName/stop

  4. 升级所有共享组件、Web 容器和 Access Manager（或 Access Manager SDK）（如果尚未执行此操作）。

    5. 参见升级 Portal Server 依赖项。

  5. 启动 Directory Server 和 Access Manager（如果它们尚未运行）。
  6. 应用表 17-7 中用于 Portal Server 的 RPM。
    1. cd /tmp

      2. 其中，/tmp 是步骤 1 中修补程序的下载目录。

    2. 解压缩 118020 修补程序文件，阅读自述文件并运行以下脚本：

      3. ./upgradeportalrpms

      upgradeportalrpms 脚本会安装 RPM，同时确保由修补程序所引起的配置变化是正确的。

    3. 解压缩 119529 修补程序文件，然后从解压缩修补程序时所创建的目录内运行 ./update 脚本。
    4. 解压缩 118952 修补程序文件，然后从解压缩修补程序时所创建的目录内运行 ./update 脚本。
  7. 确认修补程序升级成功：

    8. rpm -qa | grep sun-portal
    rpm -qa | grep sun-mobileaccess

    应返回 RPM 的新版本号。

  8. 重新配置 Portal Server 软件：

    9. ksh

    $ cd PortalServer-base/lib
    $ ./upgradePS04Q205Q1

  9. 按如下所示编辑 PortalServer-base/export/deploy.import 文件：

    10. 如果存在以下内容：

    %JATO_LIB_DIR%/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
    %JATO_LIB_DIR%/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar

    替换为：

    /usr/share/lib/jato/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
    /usr/share/lib/jato/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar

    换言之，就是用 /usr/share/lib/jato 替换 %JATO_LIB_DIR%

  10. 通过重新启动其 Web 容器，重新启动 Portal Server。

    11. WebServer-base/https-instanceName/start

  11. 将 Portal Server Web 应用程序重新部署到 Web 容器。

    12. PortalServer-base/bin/deploy redeploy

    redeploy 命令会将内容从 PortalServer-base/web-src 重新部署至 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，应首先对 /web-src 进行 Portal Server Web 应用程序的任何自定义设置，然后再将其部署至 /web-apps。运行 deploy 命令之前，应在 /web-src 中复制可能在 /web-apps 下所做的任何更改，否则，此类更改将会被改写。

  12. 停止并重新启动 Web 容器。

    13. 虽然并非在所有情况下都需要重新启动 Web 容器，但这样做可确保 Portal Server 在干净的状态下启动。

升级过程（Linux：Application Server）

下述过程适用于要进行升级的计算机中的 Portal Server。

  1. 根据表 17-7，获取所需的修补程序。

    2. 确保下载恰如表 17-7 中所示的修补程序修订版本，但 Portal Server 修复除外，对于这些修复可能有较新的修补程序可用。

    可从以下网址将修补程序下载到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  2. 以 root 身份登录，或成为超级用户。

    3. su -

  3. 确保 Portal Server 不再在其发行版本 2 的 Application Server 实例中运行。

    4. AppServerConfig7-base/domains/domainName/instanceName/bin/stopserv

    在上述命令及后续步骤中采用了以下约定：

    • 默认的 domainName 为 domain1
    • 默认的 instanceName 为 server1
  4. 升级所有共享组件、Web 容器和 Access Manager（或 Access Manager SDK）（如果尚未执行此操作）。

    5. 参见升级 Portal Server 依赖项。

  5. 确保已升级的 Access Manager 未在其发行版本 4 的 Application Server 实例中运行。

    6. AppServer8-base/bin/asadmin stop-domain domainName

  6. 确保 Access Manager 配置文件

    7. AccessManagerConfig-base/config/AMConfig.properties

    包含以下属性值：

    com.iplanet.am.notification.url=
        http://    hostName:port/amserver/notificationservice
    com.sun.identity.webcontainer=IAS8.1
    com.iplanet.am.cookie.encode=true

    其中，hostName:port 为托管 Access Manager 实例的计算机和端口。

  7. 应用表 17-7 中用于 Portal Server 的 RPM。
    1. cd /tmp

      2. 其中，/tmp 是步骤 1 中修补程序的下载目录。

    2. 解压缩 118020 修补程序文件，阅读自述文件并运行以下脚本：

      3. ./upgradeportalrpms

      upgradeportalrpms 脚本会安装 RPM，同时确保由修补程序所引起的配置变化是正确的。

    3. 解压缩 119529 修补程序文件，然后从解压缩修补程序时所创建的目录内运行 ./update 脚本。
    4. 解压缩 118952 修补程序文件，然后从解压缩修补程序时所创建的目录内运行 ./update 脚本。
  8. 确认修补程序升级成功：

    9. rpm -qa | grep sun-portal
    rpm -qa | grep sun-mobileaccess

    应返回 RPM 的新版本号。

  9. 按如下所示编辑 PortalServer-base/export/deploy.import 文件：

    10. 如果存在以下内容：

    %JATO_LIB_DIR%/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
    %JATO_LIB_DIR%/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar

    替换为：

    /usr/share/lib/jato/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
    /usr/share/lib/jato/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar

    换言之，就是用 /usr/share/lib/jato 替换 %JATO_LIB_DIR%

  10. 按升级过程（Solaris：Application Server）下的步骤 9 到步骤 18 进行操作。

检验升级

通过确认是否已正确应用升级修补程序来检验 Portal Server 到发行版本 4 的升级。升级过程 (Solaris) 和升级过程 (Linux) 中包括此检验的步骤。

此外，还可使用以下命令：

参见表 17-3 确认输出值。

除了对修补程序升级进行这些测试外，还可以检验先前正常运行的程序是否仍然正常，以及是否确实修复了所关注的错误。

升级后的任务

除升级过程（Solaris：Application Server）和升级过程（Linux：Web Server）中所述的步骤之外，没有任何升级后的任务。

升级回滚

Portal Server 从发行版本 2 到发行版本 4 的升级无法回滚。

多实例升级

在一些部署体系结构中，Portal Server 被部署在多个计算机系统上，以提供可伸缩性和提高可用性。例如，您可以在多台计算机上运行 Portal Server 组件，并使用一个负载平衡器来分配负载。

就 Portal Server 负载平衡的实例而言，可执行滚动升级，期间您可依序升级各个 Portal Server 实例而不中断服务。在升级每个 Portal Server 实例时，其他实例仍可保持运行。可按发行版本 2 Portal Server 的升级中所述升级每个实例。



上一页      目录      索引      下一页     

文件号码 819-3457。 版权所有 2005 Sun Microsystems, Inc. 保留所有权利。