IBM Portal 6.0 部署定制的主题和外表

部署定制的主题和外表

因为将主题和外表 JSP 作为主 IBM^®WebSphere^®Portal Express 企业应用程序的一部分进行管理，所以它们是 WebSphere Portal Express EAR 文件的一部分。添加新的主题和外表时，必须更新和重新部署 WebSphere Portal Express EAR 文件。若未执行此操作会导致随后更新 EAR 文件时删除定制主题和外表。

要更新和重新部署具有新的主题和外表的 EAR 文件，请按本部分中的指示信息操作。

注： 将定制主题和外表部署到受管单元或集群中时，必须在 Deployment Manager 管理的主配置中对它们进行更新。

• 在生产环境中部署主题和外表
• 在开发和测试环境中部署主题和外表

<!-- -->

在生产环境中部署主题和外表

此方法不需要启用自动 JSP 重新装入，且不影响门户网站的运行时性能。因此建议在生产环境中部署主题和外表。

注： 在开始该任务前，请确保满足以下所有要求：

1. WebSphere Application Server 的管理服务器已启动：
   • 如果门户网站在基本应用程序服务器节点中运行，请确保管理服务器正在运行。缺省名称为 server1。
   • 如果门户网站在 Network Deployment（ND）单元中运行，请确保 Deployment Manager（DM）和所有节点代理程序正在运行。
2. 使用 WebSphere Application Server 管理用户标识登录。

要在生产环境中部署主题与外表，请继续执行以下操作：

1. 根据网络配置导出 WebSphere Portal Express EAR 文件 wps.ear。如果有集群环境，则必须从 WebSphere Application Server Network Deployment 机器中导出 WebSphere Portal Express EAR。
   1. 在命令行中，转至目录 was_profile_root/bin。
   2. 调用 wsadmin 命令以将 wps.ear 导出到临时目录（确保在一行上输入所有命令）：
      • Windows： wsadmin.bat -useradmin_user_id -password admin_password -c "$AdminApp export wpsdirectory/wps.ear"
      • Linux： ./wsadmin.sh -useradmin_user_id -passwordadmin_password -c '$AdminApp export wpsdirectory/wps.ear'
      • i5/OS：wsadmin -profileName profile_root -user admin_user_id -password admin_password -c '$AdminApp export wps directory/wps.ear'

      其中：

      • profile_root 是安装 WebSphere Portal Express 的 WebSphere Application Server 概要文件的名称，例如 wp_profile。
      • admin_user_id 是管理员的用户标识
      • admin_password 是管理员密码。
      • directory 是临时目录
2. 创建 /wps_expanded 子目录。使用 EARExpander 工具展开已导出的 EAR 文件的内容（确保在一行上输入所有命令）：
   • Windows： EARExpander.bat -ear directory\wps.ear -operationDir directory\wps_expanded -operation expand
   • Linux： ./EARExpander.sh -ear directory/wps.ear -operationDir directory/wps_expanded -operation expand
   • i5/OS：EARExpander -ear directory/wps.ear -operationDir directory/wps_expanded -operation expand
3. 将已更新的主题和外表 JSP 放置到展开的 EAR 中的正确目录。例如：
   • HTML 主题放入 directory/wps_expanded/wps.war/themes/html
   • HTML 外表放入 directory/wps_expanded/wps.war/skins/html
4. 从最初导出 wps.ear 文件的目录中删除原始文件。
5. 使用 EARExpander 命令将 EAR 目录折叠回到 EAR 文件中：
   • Windows：EARExpander.bat -ear directory\wps.ear -operationDir directory\wps_expanded -operation collapse
   • Linux： ./EARExpander.sh -ear directory/wps.ear -operationDir directory/wps_expanded -operation collapse
   • i5/OS： EARExpander -ear directory/wps.ear -operationDir directory/wps_expanded -operation collapse
6. 使用 wsadmin 命令更新 WebSphere Portal Express EAR。
   注： 如果有受管单元（无论是否带集群），请在 Deployment Manager 机器上执行这一步。
   • Windows：wsadmin.bat -user admin_user_id -password admin_password -c "$AdminApp install directory/wps.ear {-update -appname wps -nodeployejb}"
   • Linux： ./wsadmin.sh -user admin_user_id -password admin_password -c '$AdminApp install directory/wps.ear {-update -appname wps -nodeployejb}'
   • i5/OS：wsadmin -profileName profile_root -user admin_user_id -password admin_password -c '$AdminApp install directory/wps.ear {-update -appname wps -nodeployejb}'

   其中：

   • admin_user_id 是管理员的用户标识
   • admin_password 是管理员密码。
   • directory 是临时目录
7. 重新启动 WebSphere_Portal 服务器。在集群配置中，重新启动集群。

注：对集群配置的更新必须在 Deployment Manager 上进行，并且必须与集群中的其他节点重新同步。如果对集群中的个别节点进行更新，则当 Deployment Manager 上的主配置再次与节点重新同步时，由于节点上的更改被覆盖，因此更新将丢失。然而，当在节点上运行配置任务时，您可以在节点上启动这些任务，但必须修改主配置（从节点至 Deployment Manager 的远程连接）。

<!-- -->

在开发和测试环境中部署主题和外表

因为此方法使您能快速调试和测试更新过的主题和外表而不要求您重新启动 WebSphere Portal Express，所以它适合于开发和测试环境。

1. 使应用程序服务器能自动检查新的 JSP（如启用自动 JSP 重新装入中所述）。
2. 将更新过的主题和外表直接放到以下目录中：
   • Windows：was_profile_root\installedApps\cellname\wps.ear\wps.war
   • Linux：was_profile_root/installedApps/cellname/wps.ear/wps.war
   • i5/OS：app_server_root/installedApps/cellname/wps.ear/wps.war
   在集群环境中，将更新过的主题和外表放在每个节点上的此目录下。
3. 调试、更新和测试更新过的主题和外表。
4. 若主题和外表按设计的那样工作，并且不需要进一步的更改，则应该将更新过的主题和外表合并到 wps.ear 文件中，以防止旧的 wps.ear 文件意外覆盖它们。
   1. 对以下目录中的主题和外表文件进行的所有更改进行备份：
      • Windows：was_profile_root\installedApps\cellname\wps.ear\wps.war
      • Linux：was_profile_root/installedApps/cellname/wps.ear/wps.war
      • i5/OS：app_server_root/installedApps/cellname/wps.ear/wps.war
   2. 如果在步骤 1 中启用了自动 JSP 重新装入，则禁用它。
   3. 按照在生产环境中部署主题和外表中的指示信息，重新部署具有更新过的主题和外表的 wps.ear 文件。
   4. 验证主题和外表是否如预期那样工作。