快速安装 WebSphere Portal V5 和 Portlet 开发环境

文档选项 未显示需要 JavaScript 的文档选项

级别： 初级

Ashwin Manekar (amaneka@us.ibm.com), 解决方案测试工程师，WebSphere Platform Solution Test, IBM Corporation，Raleigh

2003 年 11 月 01 日

WebSphere Portal 家族包括许多产品和组件，可以满足多种业务需要。请参考 WebSphere Portal InfoCenter 来计划您的 portal 环境。

©IBM版权所有，2003年。保留所有权利。

引言

WebSphere Portal 家族包括许多产品和组件，可以满足多种业务需要。请参考 WebSphere Portal InfoCenter 来计划您的 portal 环境。

本文讲解了如何安装 IBM® WebSphere® Portal V5.0（带有一个健壮的数据库（IBM DB2® V8.1），具有扩展的安全性，使用 LDAP directory（IBM Directory ServerV5.1），运行在单个 Windows 节点上）。本文为需要这些特定配置的用户提供了快速安装和配置的入门指导。如果您需要关于下面所描述的任何特定配置的附加信息，或者您需要安装一个不同的配置，请参见 WebSphere PortalInfoCenter 的 Planning和 Installing部分。

本文是为那些想要在 WebSphere Portal 上开发和配置 portlet 的软件开发人员准备的。本文描述了如何安装和配置 WebSphere Studio Application Developer V5.0，并且说明了如何设置 portlet 开发环境。

回页首

软件清单

您需要下列产品来完成本文档中的所有任务：

• Microsoft® Windows 2000 Server 或 Professional，带有 Service Pack 2 或 3
• IBM DB2 V8.1，带有 Fixpack 1（以下称为 DB2）
• IBM Directory Server V5.1（以下称为 Directory Server）
• IBM WebSphere Portal V5.0（以下称为 WebSphere Portal），它包括 WebSphere Application Server（以下称为 Application Server）
• IBM WebSphere Studio Application Developer 5.01（以下称为 Application Developer）

回页首

硬件清单

您需要下面的硬件配置。

存储

下列磁盘空间需求都是估计的：

端口绑定

WebSphere Portal 和相关的应用程序需要下列端口：

• 443（标准 HTTPS 端口）
• 523（DB2 Administration Server）
• 8008（IBM HTTP Server Administration 端口）
• 50000（DB2 实例连接端口）
• 50001（DB2 实例中断端口）
• 50002（DB2 Control Server）
• 55555（WAS 数据库端口）

要检查端口的可用性，可以使用 netstat 命令。在命令提示符下，键入： netstat 。在本地地址栏中，第五个编号是端口号。例如，在编号 0.0.0.0:80 中，端口号为 80 。

访问权限

使用本地 Windows 用户 id 来设置此环境。本地 Windows用户 id 在管理员组中，并且分配以下权限给该账户：

• 作为操作系统的一部分
• 作为服务进入系统

对于数据库管理员，使用具有以下附加权限的账号：

• 本地定义
• 属于本地管理员组
• 能够创建一个令牌对象
• 能够增加限额
• 能够代替流程级令牌

回页首

安装和配置

要安装和配置环境，您需要完成下列任务：

1. 安装 DB2。
2. 安装 Directory Server。
3. 安装 WebSphere Portal。
4. 配置 WebSphere Portal for DB2。
5. 配置 WebSphere Portal for Directory Server。
6. 设置用于 portlet 开发的 Application Developer

每个任务应该遵循的步骤如下：

安装 DB2 8.1

根据 DB2 文档提供的说明来安装 DB2 和所需的 fixpack。
重要： WebSphere Portal 没有使用 OLAP Starter 工具包；因此，不安装OLAP Starter 工具包。

1. 安装 DB2 8.1。
2. 安装 DB2 8.1 Fixpack 1。

安装 IBM Directory Server 5.1

因为 WebSphere Portal 安装不包括 LDAP 服务器，所以您需要另外安装 LDAP 服务器。

1. 插入 IDS 5.1 的 CD，进入安装目录。
2. 双击 \IDS51\ids_ismp\setup.exe 。
3. 选择 Typical.
4. 为安装选择默认组件：
1. Client SDK
2. Web Admin 5.1
3. Server 5.1
5. 输入 DB2 管理员用户 id 和密码（用于进入 DB2 系统）。
6. 在安装之后，重新启动系统。LDAP 服务器的 Directory Configuration 管理工具被激活。如果没有显示工具，则选择 Start -> Programs -> IBM Directory Server 5.1 -> Directory Configuration。

配置目录服务器

如果您与下面的配置有关的其他帮助，请选择 Start -> Programs -> IBM Directory Server 5.1 ->Getting Started。

1. 单击 Administrator DN/password。验证管理员专有名和密码。在进入您将用 Web Admin 工具创建的服务器时，会用到管理员专有名和密码。
2. 单击 Configure Database。如果这是第一次安装 Directory Server，则选择创建一个新的 LDAP数据库，然后设置用户 id 和密码来访问数据库实例。如果数据库已经存在，您就可以重新配置它。
3. 单击 Manage Suffixes。在导入 LDIF 文件之前，添加任何需要的前缀。
4. 单击 Import LDIF data。定位并选择特定于您的环境的 LDIF 文件，然后选择 Import。将 LDIF 文件中的条目添加到 LDAP 中。如果您没有 LDIF 文件，您可以跳过这一步。
5. 关闭 Directory Configuration tool。
6. 通过键入： <IDS_ROOT>\appsrv\bin\startserver server1 ，从命令提示符启动 Directory Server WebAdmin 服务器。
7. 通过在 Web 浏览器中打开此 URL： http://localhost:9082/IDSWebApp/IDSjsp/Login.jsp ，打开 Directory Management 工具。
8. 使用用户 id： superadmin ，密码： secret ，进入系统。在您进入系统之后，您就可以更改此用户 id 和密码。
9. 在 Console Administration 中，单击 Manage console servers。
10. 添加 localhost: 作为服务器。 提示：您可以指定服务器 IP 地址和主机名来代替 localhost: （如果您愿意的话）。
11. 如果您想配置 SSL，则检查 SSL。
12. 退出系统，再进入系统（使用您为 LDAP hostname配置的服务器）。使用您在安装时设置的用户 id 和密码（参见上面的步骤2）。
    （ cn=root, pw=****** ）
13. 单击 Directory Management，然后单击 Manage entries。您可以看到您用 Directory Configuration 工具设置的后缀的条目。

安装 WebSphere Portal V5.0

要安装 WebSphere Portal，请遵循下列步骤：

1. 插入 WebSphere Portal for Multiplatforms Version 5.0 CD，或进入安装目录。
2. 双击 \WP50MP\cdSetup\install.bat 。
3. 选择默认设置。
4. 将 WebSphere Application Server 和 IBM HTTP Server 设置为作为 services运行。
5. 单击 Next以安装产品。安装过程至少要花两个小时。

配置 WebSphere Portal for DB2 8.1

WebSphere Portal 默认使用 Cloudscape 数据库。要改为使用 DB2，您需要专门配置它。

要使用远程 DB2 服务器，您必须手工创建 WebSphere Portal 所需的数据库。请参考 WebSphere Portal InfoCenter 中的 Creating databases and users for DB2主题。

要使用本地 DB2 服务器，请遵循下面的步骤来创建所需的数据库：

1. 在命令提示符下，将当前目录更改为： [ WPS_ROOT ]\config
2. 通过运行下列命令： wpsconfig database-transfer-export ，导出当前的数据库数据。
3. 为了正确地更改为 [ WPS_ROOT ]\config\wpconfig.properties 文件，请参考 WebSphere Portal InfoCenter 中的 Configuring WebSphere Portal for DB2主题。
4. 确保系统用户 id 有权创建数据库。然后运行下列命令来创建数据库： wpsconfig create-local-database-db2 。
5. 在创建好了数据库之后，输入下列命令来执行配置任务： wpsconfig database-transfer-import 。此配置大约要花30分钟。
   
6. 在导入数据库表之后，进行 reorg 检查以提高性能。连接到每个数据库并且根据 DB2 的提示运行下列命令：

   reorgchk update statistics on table all terminate db2rbind [ database_name ] -l db2rbind.out -u [ admin ] -p [ password ]

   
   
7. 启动服务器： startServer WebSphere_Portal 。

配置 WebSphere Portal for IDS 5.1

对于与 WebSphere Portal 一起使用的 IBM Directory Server，您必须通过下列步骤来配置 portal 环境：

1. 为了正确地更改为 [ WPS_ROOT ]\config \wpconfig.properties 文件，请参考 WebSphere Portal InfoCenter 的 Configuring WebSphere Portal for IBM Directory Server主题。
    
2. 使用下列命令，停止服务器 server1和 WebSphere_Portal：

   WAS_ROOT\bin\stopServer server1 WAS_ROOT\bin\stopServer WebSphere_Portal

   
   
3. 输入下列命令来执行适当的配置任务： wpsconfig validate-ldap 。
    
4. 如果您已经安装了 Application Server 作为 WebSphere Portal 安装的一部分，则输入下列命令： wpsconfig enable-security-ldap 。
    
5. 停止，再重新启动该服务器：

   stopServer WebSphere_Portal ?user wpsbind ?password wpsbind stopServer server1 ?user wpsbind ?password wpsbind startServer server1 startServer WebSphere_Portal

   
   

设置用于 portlet 开发的 Application Developer 5.0.1

Application Developer 提供了一种开发环境，可以用于创建 portlet 应用程序，并且通过把它们部署到 WebSphere Portal Test environment 中来测试它们。

要设置这种 portlet 开发环境，请遵循下列步骤：

1. 从 WebSphere Application Developer 5.0 CD 安装 Application Developer 5.0。
2. 启动 Application Developer。通过使用 Help -> Software Updates -> New Updates来升级为 Application Developer 5.01。
3. 要将 Application Server 5.0 运行时升级到 Application Server 5.0.1 运行时，请参考 Help ->Software Updates ->Update Manager。
   • 展开 Sites to Visit。
   • 展开 IBM WebSphere Studio Application Developer Fixes。
   • 展开 Version 5.0 fixes。
   • 单击 Application Server Fixpacks 5.0.1。
   • Select More Infoin the resulting window and follow the instructions.
4. 双击 [ Application Developer_ROOT ]\runtimes\base_v5\ptf\wteInstall.bat。
5. 安装 Application Server 5 interim fixes：
   • 复制 \WP50MP\CD1-6 to [ Application Developer_ROOT ]\runtimes\base_v5 的 fixes 目录。
   • 运行 [ Application Developer_ROOT ]\runtimes\base_v5\fixes\updateWizard.bat 。
   • 选择 Specify product information，然后指定 [ Application Developer_ROOT ]\runtimes\base_v5 。
   • 选择 Install fixes。
   • 选择 PQ73644, PQ76567, WAS_Dynacache_05-08-2003_5.0.1_cumulative_fix and WAS_CM_08-12-2003_5.0.2-5.0.1_cumulative_Fix。
6. 从 \WP50MP\cdSetup\PortalToolkit 启动 Portal Toolkit 安装程序。或者，从 http://www.ibm.com/websphere/portal/toolkit/ 下载该工具包的最新版本，然后启动安装程序。
7. 选择 Portal ToolKit，完成安装。
8. 然后，重新启动服务器，选择 WebSphere Portal 5.0 Test Environment，完成它的安装。对于 WebSphere Portal 5 安装程序，请指定 \WP50MP\CD 2\wps\install.bat 。
   提示：您可以在一个步骤中安装该工具包和测试环境；然而，如果是在相同的机器上，安装将失败，因为没有足够的可用资源。
    
9. 启动 Application Developer。在系统提示您是否打开 Update Manager 时，单击 Yes。检查显示的更改，然后单击 Finish。
10. 重新启动 Application Developer。

回页首

疑难解答

如果您在安装过程中遇到问题，请使用 控制面板（Control Panel）中的 添加/删除程序（Add/Remove Programs）来卸载软件。下面是您在重新安装时应该遵循的提示：

1. 检查注册表（Start ->Run ->regedit），追踪失败了的安装。搜索尝试安装的目录。例如，在本例中 WebSphere Portal Test Environment安装失败，就搜索 Application Developer_ROOT\runtimes\portal_v50。
2. 安装不需要的文件夹。
3. 检查条目是否从 C:\WINNT\vpd.properties 文件中删除。如果条目存在，则重命名该文件。

回页首

术语

IDS_ROOT

IBM Directory Server 的安装目录（例如， C:\Program Files\IBM\LDAP ）

WPS_ROOT

WebSphere Portal version 5.0 的安装目录（例如， C:\WebSphere\PortalServer ）

WAS_ROOT

Application Server 的安装目录（例如， C:\WebSphere\AppServer ）

Application Developer_ROOT

WebSphere Studio Application Developer 的安装目录（例如， C:\Application Developer5 ）

WP50MP

WebSphere Portal Version 5.0 Multiplatform CD.

回页首

结束语

您已经安装了 WebSphere Portal V5.0（带有 DB2 V8.1，具有扩展的安全性，使用 Directory Server 5.1 LDAP 目录，运行在单个 Windows 节点上）。现在您可以着手开发和测试您自己的 portal 了。

本文讲解了如何安装 IBM® WebSphere® Portal V5.0，它带有一个健壮的数据库（IBM DB2® V8.1），具有扩展的安全性，使用 LDAP directory（IBM Directory ServerV5.1），运行在单个 Windows 节点上。

参考资料

1. WebSphere Portal Product Documentation Info Center
   http://www.ibm.com/websphere/developer/zones/portal/proddoc.html

关于作者

		Ashwin Manekar is 是一名测试工程师，他在IBM 的 WebSphere Solution 测试部门（在美国北卡罗莱那州罗利市）工作。Ashwin 获得了北卡罗来纳大学（在美国北卡罗来纳州夏洛特市）的计算机科学硕士学位。您可以通过 amaneka@us.ibm.com 与 Ashwin 联系。

对本文的评价

太差！ (1) 需提高 (2) 一般；尚可 (3) 好文章 (4) 真棒！(5) 建议？

回页首