部署一个主题 WAR 文件到 IBM WebSphere Portal V6.1

Loc Dang, IT 专家, IBM

Loc Dang 是 IBM Software Services for Lotus 的一名 IT 专家。他也是 ISSL 的 Portal Practice 中的一员，有着超过 9 年的 WebSphere Application Server 和 WebSphere Portal 从业经验。您可以通过 locdang@us.ibm.com 联系他。

Michael Fitzgerald, IT 专家, IBM

Mike Fitzgerald 是 IBM Software Services for Lotus 的一名 IT 专家。他也是 ISSL 的 Portal Practice 中的一员，有着超过 6 年的各种风格 WebSphere Portal 的从业经验，您可以通过 maf@us.ibm.com 联系他。

简介： 本文旨在显示门户管理员如何在 IBM® WebSphere® Portal V6.1 环境下创建和部署一个主题 WAR 文件。附有一个样例主题 WAR 文件。

简介

随着 WebSphere Portal V6.1 的出现，许多管理功能已经改变。一个关键的变化涉及如何处理主题和皮肤。它们不再是文件系统构件。现在它们可以作为一个 WAR 文件导出和导入。此功能使得管理主题和皮肤、在不同版本之间迁移的任务有所不同。门户管理员现在必须对创建 WAR 文件很熟悉。本文采用逐步的方法来帮助有经验的管理员理解如何利用这个新特性。

要使用这个新特性，需要满足以下先决条件：

• 理解 IBM WebSphere Application Server 和 WebSphere Portal V6.1 目录结构
• 理解 WebSphere Portal 管理控制台的基本功能
• 理解基本操作系统命令

本文包括两个样例文件，可在下载部分找到：

• sample_DeployYourTheme.xml 是 WebSphere Portal V6.1 中一个用于导入和创建主题的样例文件。参考 “导入主题” 小节，更进一步理解导入主题的方式。
• MyTheme.war 是 WebSphere Portal V6.1 的一个样例主题。参考 “创建一个主题 WAR 文件” 小节，进一步理解如何创建 WAR 文件。

创建一个主题 WAR 文件

部署主题 WAR 文件的第一步是创建一个主题 WAR 文件。这个创建过程是一个样例过程。其中一个方法是创建一个目录，并将其命名为 /home/MyTheme，接下来，向其中复制一个已存主题，这有一个有用的 UNIX® 命令可以处理这一任务：

cd /wps.war/themes/html/Portal
tar cf . - | (cd /home/MyTheme; tar xvfBp -)

这个命令递归检查 /html/Portal 子文件，并将每一项复制到 /home/MyTheme。

现在您可以进行改变，识别您的个性化主题。如果您想看看并感受一下您的定制主题，它看起来更像 web 2.0。那么将源目标从 /Portal 改为 /Portal2。

在以下步骤列表中您可以省略步骤 14。

如果想要从头开始创建您的主题，按照下列步骤操作：

1. 创建一个名为 MyTheme 的目录。
2. 在 MyTheme 目录下，创建两个其他目录，themes 和 WEB-INF：
   
   MyTheme/themes
   MyTheme/WEB-INF
3. 从初始主题位置复制 WebSphere Portal dojo 目录及其内容，粘贴到 MyTheme/theme 目录：
   
   cp –r /wps.war/themes/dojo MyTheme/themes/
   MyTheme/themes/dojo/*
4. 在 themes 目录下创建一个 HTML 目录：
   
   MyTheme/themes/html
5. 复制初始 WebSphere Portal 主题的 psw 目录到 HTML 目录：
   
   cp –r /wps.war/themes/html/psw MyTheme/themes/html/
   MyTheme/themes/html/psw
6. 在 HTML 目录下创建 MyTheme 目录：
   
   MyTheme/themes/html/MyTheme
7. 将您的新主题插入到最新创建的 MyTheme 目录。
   
   

   注意：
   

   • 如果此刻您没有一个主题，复制初始 WebSphere Portal 主题到最新创建的 MyTheme 目录：
     
     cp –r /wps.war/themes/html/Portal/* MyTheme/theme/html/MyTheme
   • 最好从初始 WebSphere Portal 主题启动，并进行修改。

8. 在 MyTheme/WEB-INF 目录下，创建文件 web.xml： MyTheme/WEB-INF/web.xml
9. web.xml 必须包含清单 1 中显示的信息。
   
   
   
   清单 1. 样例 web.xml
   

   <?xml version="1.0" encoding="UTF-8"?> MyTheme

   
   

   注意：如果代码是从 WebSphere Portal Information Center 复制的，确认您已经删除了每行开头部分的所有空格。如果空格未被删除，在 WAR 文件被安装之后，WebSphere Application Server 确定 web.xml 文件中出现错误。

10. 通过使用您的主题替换 MyTheme 变量来更新 web.xml 文件。
11. 在 WEB-INF 目录下创建 tld 目录：
    
    MyTheme/WEB-INF/tld
12. 将所有 tld 文件从初始 wps.war 文件复制到最新创建的 tld 目录：
    
    cp –r /wps.war/WEB-INF/tld* MyTheme/WEB-INF/tld
    
    MyTheme/WEB-INF/tld/portal-v6-core.tld
    MyTheme/WEB-INF/tld/portal-v6-dynamicui.tld
    MyTheme/WEB-INF/tld/portal-v6-fmt.tld
    MyTheme/WEB-INF/tld/portal-v6-logic.tld
    MyTheme/WEB-INF/tld/portal-v6-navigation.tld
    MyTheme/WEB-INF/tld/portal-v6-showtools.tld
    MyTheme/WEB-INF/tld/portal-v6-skin.tld
    MyTheme/WEB-INF/tld/portal-v6-theme-ext.tld
    MyTheme/WEB-INF/tld/portal-v601-web20.tld
13. 将您定制的 tld 文件放在 MyTheme/WEB-INF/tld 目录下。
14. 将 MThemey 目录下的文件压缩成一个 ZIP 文件，名为 MyTheme.zip，其中包含以下文件：
    
    themes/html/MyTheme/*
    themes/html/psw/*
    themes/dojo/*
    WEB-INF/web.xml
    WEB-INF/tld/*
15. 将 MyTheme.zip 重命名为 MyTheme.war。

在 WebSphere Portal V6.1 上部署主题

部署主题 WAR 文件的第二个步骤就是将主题 WAR 文件部署到门户服务器。可通过以下步骤完成这项任务：

1. 打开浏览器，设置 WebSphere Application Server 管理控制台 URL：
   
   http://:/admin 例如：
   
   http://MyHostName.raleigh.ibm.com:10027/admin
2. 选择 Applications - Install New Application，如图 1 所示。
   
   
   
   图 1. WebSphere Application Server 控制台左导航面板
   
   
   
3. 在 “Preparing for the application installation” 窗口，选择 Local 文件系统，单击 Browse 并浏览 MyTheme.war。在 Context 根字段输入 /MyTheme。单击 Next。见图 2。
   
   
   
   图 2. 准备应用程序安装
   
   
   
4. 在图 2 所示的 Install New Application 窗口，选择步骤 1：选择安装选项，然后在 Application Name 字段删除应用程序名中的 “_war”。默认文件名是 WAR 文件的第一部分，并将 “_war” 附加在其后。单击 Next。见图 3。
   
   
   
   图 3. 选择安装选项
   
   
   
5. 在 Install New Application 窗口，选择步骤 2：映射模型到服务器，在 Clusters 和 Servers 字段选择 WebSphere Portal 服务器和门户集群（如果有集群），并选择 MyTheme 模式。单击 Apply，然后单击 Next。见图 4。
   
   
   
   图 4. 映射模式到服务器
   
   
   
6. 选择步骤 3 ：为 web 模型映射虚拟主机，选择 web 模型，并在 Virtual 主机字段选择 default_host。单击 Next。见图 5。
   
   
   
   图 5. 为 Web 模型映射虚拟主机
   
   
   
7. 在此窗口显示步骤 4 ：摘要，确认显示在安装选项摘要中的所有信息是正确的。单击 Finish。见图 6。
   
   
   
   图 6. 摘要
   
   
   
8. 在图 7 所示的安装消息窗口中，单击 Save 链接，将这些选项保存到主配置文件。返回主 WebSphere Application Server 管理控制台。
   
   
   
   图 7. 安装消息
   
   
   
9. 在管理控制台中，选择 Applications - Enterprise Applications 打开标题为 Enterprise Applications 的窗口，如图 8 所示。
   
   
   
   图 8. WebSphere Application Server 管理控制台的左导航面板
   
   
   
10. 在图 9 所示的 Enterprise Applications 窗口中，选择紧挨着应用程序 MyTheme 的输入框，单击 Start。
    
    
    
    图 9. Enterprise Applications
    
    
    

导入主题

使用以下步骤将您的主题导入 WebSphere Portal 服务器，要想使这个过程变得简单，一个方法是使用 XML 文件。下面将演示此方法，首先创建一个 XML 文件，我们已经包含了样例代码，您可以用来做参考。见清单 2。

1. 创建一个名为 DeployYourTheme.xml 的文件。
2. 输入清单 2 中所示的代码。
   
   
   清单 2. 部署主题的样例 XML 文件
   

   <?xml version="1.0" encoding="UTF-8"?> <!-- Sample for deploying themes and skins in an XML script. Note that this created only the database entries; you still need to provide the rendering JSPs under the resource root directories specified in the XML. --&gt NoSkinA skin with no skinMyTheme <!-- There's only one skin that can be combined with this theme. --&gt

   
   
3. 修改 DeployYourTheme.xml 文件，更改 MyTheme 以及您主题的名称来使其和文件的其余部分保持一致。
4. 打开一个浏览器并为 WebSphere Portal 设置 URL：
   
   http://:/wps/portal 例如：
   
   http://MyHostName.example.com:10040/wps/portal
5. 用一个管理 ID 登录 WebSphere Portal 网站，如图 10 所示。
   
   
   
   图 10. WebSphere Portal Login 屏幕
   
   
   
6. 在标题栏选择 Administration 选项卡。如图 11 所示。
   
   
   
   图 11. WebSphere Portal Welcome 页面
   
   
   
7. 选择 Portal Settings - Import XML，如图 12 所示。
   
   
   
   图 12. WebSphere Portal Administration 选项卡
   
   
   
8. 单击 Browse，找出文件 DeployYourTheme.xml。
9. 单击 Import。
10. 选择 Portal User Interface - Themes and Skins，如图 13 所示。
    
    
    
    图 13. WebSphere Portal Themes and Skins 管理页面
    
    
    
11. 在 Themes 部分，选择 MyTheme 并单击 Edit 按钮。
12. 在图中显示的 All 皮肤部分，默认选择 IBM – portal。见图 14。
    
    
    
    图 14. Themes and Skins 编辑页面
    
    
    
13. 单击将 IBM 皮肤移到窗口右面，主题的这部分标题为 Skins。
14. 在右选择框选择 IBM。
15. 默认选择 Set，提示时单击 OK。

您已经创建一个新主题，将其转换成一个 WAR 文件，将 WAR 导入 WebSphere Application Server 并启动 Enterprise Application（WAR 文件）。启动 Enterprise Application（ WAR 文件）之后，就可以使用 XML 文件将主题导入 WebSphere Portal，然后启用 WebSphere Portal 来使用最新添加的主题。以下步骤将指导您完成 WebSphere Portal 中主题的测试过程。

测试新的主题

测试新主题的步骤是最简单的。

1. 用一个管理 ID 登录 WebSphere Portal 网站，如图 10 所示。
2. 在标题栏选择 Administration 选项卡，如图 11 所示。
3. 选择 Portal User Interface - Manage Pages，如图 15 所示。
   
   
   
   图 15. WebSphere Portal Administration Manage Pages 窗口
   
   
   
4. 在显示窗口中，选择 Content Root。
5. 在显示窗口中, 单击 New Page，如图 16 所示。
   
   
   
   图 16. 选择 Content Root 之后出现 Manage Pages 窗口
   
   
   
6. 如图 17 所示，在 Page Properties 中，完成以下步骤：
   
   • 在 Title 字段，输入 NewPage。
   • 在 Theme 字段，从下拉菜单选择 MyTheme。
   
   
   图 17. 最新创建页面的 Page Properties 窗口
   
   
   
7. 单击 OK。页面创建之后，您要返回到 Administrative 选项卡的 Manage Pages 页面。见图 18。
   
   
   
   图 18. WebSphere Portal Administrative 选项卡 – Manage Pages
   
   
   
8. 在标题栏选择 More。
9. 在图 19 中，您可以看到 NewPage 的 Page Menu，选项 New Page。
   
   
   
   图 19. 选择 More 之后的 WebSphere Portal 页面
   
   
   

图 20 显示您刚才创建的最新页面（NewPage），使用新主题（MyTheme）。

图 20. 显示 NewPage 窗口的 WebSphere Portal

结束语

在本文中，我们介绍了在 WebSphere Portal V6.1 中创建、部署、安装和使用一个主题（作为 WAR 文件）的必要步骤。在以下参考网站，我们也提供了 WebSphere Portal Server Information Center 中这部分的链接，讨论主题和皮肤的性能指南。对于想要创建并设计主题和皮肤的人来说是 “必读” 的。

致谢

我们感谢 Shannon Pixley 给我们提供 web.xml 文件，感谢 Morgan Johnsonfor 为我们提供主题样例。

原文链接：http://www.ibm.com/developerworks/cn/websphere/library/techarticles/1006_fitzgerald/1006_fitzgerald.html

来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/14789789/viewspace-673757/，如需转载，请注明出处，否则将追究法律责任。

转载于:http://blog.itpub.net/14789789/viewspace-673757/