IBM Rational Web Developer for Windows and Linux V6.0 安装指南
第 1 章 简介
第 2 章 Rational Web Developer 的安装需求
第 3 章 IBM Rational Software Development Platform
第 4 章 安装和卸载 Rational Web Developer for Windows
迁移、升级和共存问题
从 CD-ROM 进行安装
从电子映像安装
创建网络安装映像
调用静默安装
设置本地映像
以静默方式将缺省功能部件安装到缺省目录中
以静默方式安装至另一个目录
以静默方式安装其它 Rational Web Developer 功能部件
启动 Rational Web Developer
卸载 Rational Web Developer
以静默方式卸载 Rational Web Developer
已知问题与局限性
从失败的安装恢复
未能安装 WebSphere Application Server V6.0 集成测试环境
在 Windows Server 2003 上未能卸载 WebSphere Application Server V6.0 集成测试环境
取消安装合并安装的产品然后再次尝试安装,可能无法正确地安装该产品。
第 5 章 安装和卸载 Rational Web Developer for Linux
迁移、升级和共存问题
从 CD-ROM 进行安装
从电子映像安装
创建网络安装映像
调用静默安装
设置本地映像
以静默方式将缺省功能部件安装到缺省目录中
以静默方式安装至另一个目录
以静默方式安装其它 Rational Web Developer 功能部件
增加可用文件句柄数
启动 Rational Web Developer
卸载 Rational Web Developer
以静默方式卸载 Rational Web Developer
已知问题与局限性
磁盘局限性
未能安装 WebSphere Application Server V6.0 集成测试环境
取消安装合并安装的产品然后再次尝试安装,可能无法正确地安装该产品。
第 6 章 安装代理控制器
硬件先决条件
受支持的平台
受支持的 JVM
查找安装文件
将代理控制器安装在工作站(AIX、HP-UX、Linux、Windows 或 Solaris)上
卸载代理控制器的先前版本
安装代理控制器
静默安装代理控制器
在 Windows 工作站上启动和停止代理控制器
在非 Windows 工作站上启动和停止代理控制器
在 Windows 工作站上卸载代理控制器
在非 Windows 工作站上卸载代理控制器
在 OS/400(iSeries)上安装代理控制器
卸载代理控制器的先前版本
安装代理控制器
在 OS/400(iSeries)上启动和停止代理控制器
在 OS/400(iSeries)上卸载代理控制器
在 OS/390(z/OS)上安装代理控制器
卸载代理控制器的先前版本
安装代理控制器
在 OS/390(z/OS)上启动和停止代理控制器
在 OS/390(z/OS)上卸载代理控制器
使用代理控制器安全功能
已知问题与局限性
代理控制器在非 Windows 平台上可能无法启动
安装和卸载期间的其它错误
第 7 章 安装 Rational Web Developer 以便在小组环境中工作
受支持的软件
IBM Rational ClearCase
IBM Rational ClearQuest
第 8 章 将 WebSphere Application Server 5.x 作为集成测试环境安装
第 9 章 安装更新
第 10 章 版权和声明
安装指南提供了有关安装和卸载 Rational(R) Web Developer、可选功能部件以及随 Rational Web Developer 提供的其它产品的指示信息。
有关从 WebSphere(R) Studio 进行迁移的信息,请参阅《迁移指南》。
有关产品问题和局限性的信息,请参阅自述文件。
有关文档更新和故障诊断信息,请参阅 http://www.ibm.com/developerworks/rational。
在安装 Rational Web Developer 之前,必须安装下列硬件:
- 至少使用 Intel(R) Pentium(R) III 800 MHz 处理器(建议使用更高配置)
- 至少具有 768 MB RAM(建议提供 1 GB RAM)。
- 磁盘空间:
- 要安装完整的 Rational Web Developer,将需要 3.0 GB 磁盘空间。对于开发的资源,将需要其它磁盘空间。注意:如果不安装可选功能部件和运行时环境,则磁盘空间需求会减少。
- 如果下载电子映像来安装 Rational Web Developer,则还需要额外的磁盘空间。
- 如果文件系统为 FAT32 而不是 NTFS,则需要更多空间。
- TEMP 目录中将需要 500 MB。
- 显示器分辨率:
在安装 Rational Web Developer 之前,必须安装以下软件:
- 下列其中一个操作系统:
- Windows(R) XP Professional(具有 Service Pack 1 和 2)
- Windows 2000 Professional(具有 Service Pack 3 和 4)
- Windows 2000 Server(具有 Service Pack 3 和 4)
- Windows 2000 Advanced Server(具有 Service Pack 3 和 4)
- Windows Server 2003 Standard Edition
- Windows Server 2003 Enterprise Edition
- Red Hat Enterprise Linux(R) Workstation V3.0(所有 service pack)
- SuSE Linux Enterprise Server (SLES) V9(所有 service pack)
- 上面列示的 Windows 和 Linux 操作系统支持 Rational Web Developer 支持的所有本地语言。
- 如果正在使用 Linux,则您将需要 GTK V2.2.1 或更高版本。
- 您将需要 Web 浏览器来查看自述文件和安装指南。如果正在使用 Linux,则必须先安装 Mozilla 1.4 GTK2 才能运行 Rational Web Developer。Mozilla 1.5 GTK2 或 Mozilla 1.6
GTK2 还可与 SWT 3.0 配合使用。此外,从 SWT 3.1 V3104 开始可以使用
Mozilla 1.7 GTK2 或更高版本。安装在系统上的 Mozilla 的版本随 Linux 分发的不同而不同。
- 要查看与联机帮助一起提供的某些导览和教程,将需要 Macromedia Flash Player。对于 Windows,您将需要版本 6.0r65 或更高版本;对于 Linux,您将需要版本 6.0r69 或更高版本。
- 有关受支持的数据库服务器、Web 应用程序服务器和其它软件产品的信息,请参阅联机帮助和自述文件。
- 如果想要对应用程序进行概要分析,则应确保已安装 Java(TM) 运行时环境(JRE)1.3 或更高版本。
IBM(R) Rational Software Development Platform 是一个公共开发环境,可与下列产品共享:
- Rational Web Developer
- Rational Application Developer
- Rational Software Architect
- Rational Software Modeler
- Rational Functional Tester
- Rational Performance Tester
如果您安装以上任何产品,Rational Software Development Platform 都将作为该产品的一部分进行自动安装。如果安装多个产品,则开发平台只会安装一次。以上所有产品都具有相同的用户界面(称为工作台),并且每个产品都是通过添加插件来向工作台中添加功能。插件是一种软件模块,用于向现有程序或应用程序添加功能。
启动一同安装在 Windows 上的 Rational 软件产品
打开开始菜单时,无论您安装的是什么产品,顶层菜单始终是 IBM Rational。
根据已安装的产品数,您将从顶层菜单获得一个或多个子文件夹(一个子文件夹对应一个产品)。例如,如果已安装 Rational Functional Tester 和 Rational Application Developer,则对于每个产品都将存在一个子文件夹。这些子文件夹将包含指向特定于产品的信息(例如,自述文件)的链接,以及用户界面的启动点。启动点将具有该产品的名称(例如,Rational Application Developer),但实际上它将启动公共用户界面。
还可以通过单击 IBM Rational 菜单下面的 Rational Software Development Platform 选项来启动公共用户界面。
启动一同安装在 Linux 上的 Rational 软件产品
当在 Red Hat Enterprise Linux 中执行操作时,可在编程下面的主菜单中找到产品启动点。具有产品名称(例如,Rational Web Developer)的启动点和 Rational Software Development Platform 启动点将启动公共用户界面。要找到特定于产品的信息(例如,自述文件),浏览至 Rational Software Development Platform 的安装目录中特定于产品的目录(例如,对于 Rational Web Developer 为 rwd_prod)。
当在 SuSE Linux Enterprise Server(SLES)中执行操作时,可在 IBM Rational 下面的主菜单中找到产品启动点。具有产品名称(例如,Rational Web Developer)的启动点和 Rational Software Development Platform 启动点将启动公共用户界面。要找到特定于产品的信息(例如,自述文件),浏览至 Rational Software Development Platform 的安装目录中特定于产品的目录(例如,对于 Rational Web Developer 为 rwd_prod 目录)。
迁移和共存
下表说明了尝试在同一机器上安装 Rational Software Development Platform 共用的多个产品时将发生的各种情况。(在下表中,纵轴表示已经安装的产品,而横轴表示您正在尝试安装的产品):
| 尝试安装
| Rational Software Modeler
| Rational Web Developer
| Rational Application Developer
| Rational Software Architect
| Rational Functional Tester
| Rational Performance Tester
|
| Rational Software Modeler
| 不适用
| 共享
| 共享
| 升级
| 共享
| 共享
|
| Rational Web Developer
| 共享
| 不适用
| 升级
| 升级
| 共享
| 共享
|
| Rational Application Developer
| 共享
| 阻止
| 不适用
| 升级
| 共享
| 共享
|
| Rational Software Architect
| 阻止
| 阻止
| 阻止
| 不适用
| 共享
| 共享
|
| Rational Functional Tester
| 共享
| 共享
| 共享
| 共享
| 不适用
| 共享
|
| Rational Performance Tester
| 共享
| 共享
| 共享
| 共享
| 共享
| 不适用
|
定义:
- 阻止 - 如果阻止您安装产品(例如,如果您已经安装了 Rational Software Architect 并且还想尝试安装 Rational Application Developer),则在安装了第一个产品之后不能安装第二个产品。当您尝试安装的产品所提供的功能比当前已经安装的产品更少时,就会发生这种情况。
- 升级 - 如果安装的产品不仅包含当前产品的所有功能,并且还具有其它功能(例如,如果已经安装了 Rational Web Developer 并且还想安装 Rational Application Developer),则会升级为具有更强功能的产品。第一个产品将被卸载掉,但是用户界面和包含在第一个产品中所执行工作的工作空间将保留下来。
- 共享 - 当发生此情况时,多个产品将共享用户界面的安装。第二个产品将继承现有产品的功能,而不必安装另一个用户界面。因此举例来说,如果您安装 Rational Performance Tester,然后安装 Rational Application Developer,则它们将共享同一用户界面并且该用户界面将包含 Rational Performance Tester 和 Rational Application Developer 提供的所有功能。
卸载
- 已升级的产品 - 当升级产品时,现有产品会被除去并且将替换为功能更高级的产品。如果随后卸载新升级的产品,则将从系统中除去整个产品。例如,如果您安装了 Rational Application Developer,然后升级至 Rational Software Architect,稍后选择卸载 Rational Software Architect,则将卸载所有插件(包括公共用户界面)- 您将不会还原至 Rational Application Developer。为了替换 Rational Application Developer,您必须重新安装它。
- 共享产品 - 如果在共享方案中安装了两个或多个产品,用户界面会一直保留,直到卸载最后一个产品为止。例如,如果安装了 Rational Application Developer 和 Rational Performance Tester,然后卸载了 Rational Application Developer,则 Rational Performance Tester(和用户界面)将仍然保留在系统中。
- 注:
- 用户界面安装在第一个基于 Rational Software Development Platform 的产品的安装目录中。在安装任何其它产品时都不会再次安装用户界面,因此,如果升级第一个产品,则由于首次安装目录仍然包含用户界面内容,不应在升级完成后除去该目录。
本节包含有关在 Windows 上安装 Rational Web Developer 的信息。可以从 CD-ROM 或者从您下载的电子映像来安装 Rational Web Developer。尽管提供了安装向导,但是您还可以如本文档中稍后所概述的那样,从命令提示符处安装 Rational Web Developer 或执行静默安装。
还可以采用交互式控制台方式来运行安装程序,这种方式可能更适合需要辅助功能的人员。“辅助功能方式”命令行选项:
-accessibility
由于使用屏幕阅读器程序,使运行时控制台方式向导更友好。要以控制台方式运行,请从第一张 Rational Web Developer 安装 CD 上的 \setup 目录运行以下命令:
setup.exe -is:javaconsole -log @NONE -accessibility
遵循提示来完成安装。注意,在指定 -accessibility 选项时,-is:javaconsole 选项至关重要。如果不指定此选项,则安装程序将被挂起。-log @NONE 选项将关闭记录,因此,日志信息将不会列示在命令提示符窗口中。如果在安装期间遇到任何问题,则您可能想除去此选项以便收集日志信息。
不能从 WebSphere Studio Site Developer 或 WebSphere Studio Application Developer V4.x.x 或 5.0.x 迁移至 Rational Web Developer。但是,Rational Web Developer 可以与这两个产品中的任何一个共存。如果您愿意,可以采用手工方式将工作空间、工件和项目从 Rational ClearCase(R)、Clear Case LT 和 CVS 迁移至 Rational Web Developer。
可以从 WebSphere Studio 5.1.x 迁移至 Rational Web Developer,也可以选择共存。有关更多迁移信息,请参阅 Rational Web Developer 的《迁移指南》。
有关 IBM Rational Software Development Platform 和基于此开发平台的其它产品之间共存的更多信息,请参阅第 3 章, "IBM Rational Software Development Platform"。
如果具有先前版本的“代理控制器”或从 Hyades 数据收集引擎派生的任何软件,则先停止它并接着卸载,并清除任何剩余的文件,然后才安装此版本的“代理控制器”。有关更多信息,请参阅第 6 章, "安装代理控制器"。
在安装产品之前,请检查下列各项:
- 除安装产品所需的空间之外,环境变量 TEMP 或 TMP 必须指向至少具有 500 MB 可用空间的有效临时目录。
要从第一张产品安装 CD 安装 Rational Web Developer,请遵循下列步骤:
- 在开始安装过程之前,请阅读"迁移、升级和共存问题"。
- 确保正在使用的用户标识不包含双字节字符。
- 将 CD 插入 CD 驱动器。
- 如果系统上启用了自动运行,则将自动打开安装启动板程序。如果系统禁用了自动运行,则从第一张安装 CD 的根目录运行 launchpad.exe 以显示“Rational Web Developer 安装启动板”窗口。
提示:
- 可以不使用启动板,而是通过从第一张安装 CD
上的 \setup 目录运行 setup.exe 来直接进入 Rational Web Developer 安装向导。
- 如果要在不使用图形界面的情况下从命令提示符处安装 Rational Web Developer,则从第一张安装 CD 上的 \setup 目录运行以下命令:
setup.exe -console
- 注:
- 通过控制台方式取消 Rational Web Developer 的安装是受限制的。一旦开始安装 Rational Web Developer,就不能取消安装。可在执行安装过程的准备步骤期间取消安装,但是不支持在开始将文件复制至硬盘驱动器之后取消安装。按 Ctrl+C 将强制安装过程结束,但建议不要这样做。
- 从 Rational Web Developer 安装启动板中,选择安装 IBM Rational Web Developer V6.0。
- 等待安装向导打开,然后单击下一步以继续安装。
- 遵循屏幕上有关各项任务(例如,阅读许可协议和指定目标安装目录)的指示信息。
- 在“功能部件”窗口中,可以选择要安装的 Rational Web Developer 功能部件。可以返回至安装向导并稍后安装可选功能部件。
- 缺省情况下,安装程序将安装“集成开发环境”和可选的 WebSphere Application Server V6.0 作为运行时环境以供测试。
- 如果您想安装除英语之外的受支持本地语言的用户界面和文档,请选择安装语言包。缺省情况下,如果系统语言环境为英语,则没有选中此功能部件。如果系统语言环境是受支持的一种其它本地语言,则选中了此功能部件。
受支持的本地语言包括巴西葡萄牙语、法语、德语、意大利语、日语、韩国语、简体中文、西班牙语以及繁体中文。
注意:如果选择安装可选的“语言包”功能部件,然后在复制文件之后的很短时间内又取消安装,则后续安装将出现一些异常。在后续安装期间,即使没有安装语言包中的那些文件,“语言包”功能部件也会在“功能部件”面板上显示为已安装状态。可以选择重新安装“语言包”功能部件,而且相应的文件将被复制到磁盘。这种情况下,在安装结束时您可能会接收到一条消息:替换文件期间发生了一个或多个错误。可以安全地忽略此错误消息。
- 缺省情况下,不安装“企业生成语言”(EGL)功能部件。EGL 是一种功能强大的高级语言,可用于创建复杂的商业应用程序。它能够处理基础技术(例如,数据库存取、消息队列和 J2EE)的各个复杂方面,以便应用程序开发者可以集中精力处理业务逻辑。要安装
EGL 插件,选择企业生成语言(EGL)复选框。
- 缺省情况下,不安装用于开发 Eclipse 插件的示例。这些示例适用于一些开发者,他们想要通过创建自己的插件工具来扩展工作台。要安装用于开发 Eclipse 插件的示例,请选择用于开发 Eclipse 插件的示例复选框。
- 单击下一步以显示 Rational Web Developer 安装的总结信息。
- 注:
- 显示的磁盘空间需求是所有文件需要的总字节数。实际需要的磁盘空间可能会大很多。特别是,当磁盘被格式化为 FAT32 时,由于 FAT32 使用磁盘分块结构,许多小文件在使用磁盘空间时效率可能会很低。
- 单击下一步以安装 Rational Web Developer。
- 如果在安装临近结束时接收到有关注册许可证出现问题的警告,则遵循下列步骤:
- 转至安装目录中的 \logs 子目录。
- 使用文本编辑器打开 license.log。
- 如果 license.log 包含下列两行中的其中一行:
486604803 所需的许可证已到期
486604805 所有许可证的开始日期都还没有到
确保正确设置了系统时钟,然后启动 Rational Web Developer。
- 安装程序会花一些时间来安装开发环境并初始化 Eclipse。最终您会看到一条确认安装已完成的消息。单击下一步以完成安装。
- 下一个屏幕将包含一条消息,它将建议您使用 Rational Product Updater 来检查已安装的功能部件是否有更新。(有关更多信息,请参阅第 9 章, "安装更新"。)单击完成以关闭安装窗口。
- 如果计划开发将在其它应用程序服务器上运行的应用程序,则可以选择与 Rational Web Developer 一起安装其它的运行时测试环境。有关更多信息,请参阅第 8 章, "将 WebSphere Application Server 5.x 作为集成测试环境安装"。
- 在可以使用 Rational Web Developer 的概要分析、运行时分析和记录功能部件来远程收集数据之前,必须先在本地主机和远程主机上安装“代理控制器”。有关详细信息,请参阅第 6 章, "安装代理控制器"。
- 注:
-
有关需要下载的电子映像的描述,请参阅产品自述文件。
在安装产品之前,请检查下列各项:
- 环境变量 TEMP 或 TMP 必须指向至少具有 500 MB
可用空间的有效临时目录。这是除安装产品所需空间之外的可用空间。
- 必须具有大约 3 GB 的磁盘空间来存储整组可下载映像,另外还必须具有 4 GB 的磁盘空间用来解压缩这些映像。
要下载并创建电子安装映像:
- 将所有必需部件和想要的可选部件下载到同一个临时目录中。如果以后需要任何可选部件,则在尝试安装之前,下载其它可选部件并重新运行解压缩工具。
- 启动位于临时目录中的 extractor.exe 文件。这将启动创建安装映像的向导。
- 遵循向导中的指示信息来指定想要在何处创建映像以及想要包括哪些功能部件。
- 在创建了映像之后,如果您想要立即安装产品,则单击完成。或者,可以清除启动安装向导复选框并稍后通过从创建安装映像的目录启动
disk1\launchpad.exe 来运行安装程序。
- 遵循"从 CD-ROM 进行安装"一节中描述的指示信息。
可以在网络驱动器上放置安装映像的副本,以便用户可以通过网络进行安装。
要从网络驱动器运行安装程序,必须使用下载的 Rational Web Developer 电子映像或按下面所述复制各 CD 的内容。
大约需要 4 GB 磁盘空间在磁盘上存储 CD 内容。要从 CD 复制文件:
- 将第一张 Rational Web Developer 安装 CD 插入 CD 驱动器。
- 在网络驱动器上创建一个您想用来存储映像的临时目录(例如,network_drive:\install_image)。
- 在临时目录下,创建名为 disk1 的子目录。此子目录必须名为 disk1,并且它必须是小写的。
- 将第一张安装 CD 上的所有文件和目录复制到临时目录中的 disk1 子目录中。
- 重复步骤 3 和 4 并将其它两张 CD 的内容复制到名为 disk2 和 disk3 的子目录中。
这些文件都是核心安装文件。如果想要以下任一可选功能部件的安装文件:
- 代理控制器
- WebSphere V5.x 测试环境
则将相应的 CD 的内容复制到临时目录中。
注意(R):
如果您不想与安装向导进行交互,则可以用静默方式运行 Rational Web Developer 安装程序。
在静默安装 Rational Web Developer 之前,必须设置本地映像:
- 在开始安装过程之前,请阅读"迁移、升级和共存问题"。
- 确保正在使用的用户标识不包含双字节字符。
- 按"创建网络安装映像"中所述创建本地或网络安装映像。如果只想安装 Rational Web Developer,则只需要复制前三张 CD 中的信息。
在缺省情况下,以静默方式安装 Rational Web Developer 时将安装下列功能部件:
- 集成开发环境
- WebSphere Application Server V6.0(用于测试的运行时环境)
- 语言包(如果系统语言环境不是英语的话)
要以静默方式将 Rational Web Developer 以及缺省情况下选择的功能部件一起安装到缺省目录 system_drive:\Program Files\IBM\Rational\SDP\6.0 中:
- 如果您尚未复制映像,则按"设置本地映像"中所述进行复制。
- 从命令行切换至您在上一节中创建的临时目录中的 \disk1\setup 目录(例如,network_drive:\install_image\disk1\setup)。
- 运行以下命令:
setup.exe -silent
- 完成 Rational Web Developer 的静默安装可能要花一些时间。要确定何时完成安装,您可以定期查看缺省安装目录中的 \logs 目录。如果
license.log 文件出现,则表示静默安装已完成。
通过更改 installLocation 参数,可以将 Rational Web Developer 安装到另一目录。例如,如果要让“d:\my softdev”作为安装目录,遵循刚才描述的步骤并运行以下命令:
setup.exe -silent -P installLocation="d:\my softdev"
(在此示例中,只安装缺省功能部件。)
Rational Web Developer 提供了以静默方式安装所有缺省功能部件的响应文件样本。此响应文件名为 responsefile.txt,它位于 \disk1\util 目录中。如果要更改响应文件以安装其它功能部件,建议首先生成 responsefile.txt 的备份副本。
可以更新响应文件以安装一个或多个可选的 Rational Web Developer 功能部件。下表显示了响应文件选项以及它们在响应文件中的对应条目。
表 1. 响应文件选项列表。
| 功能部件
| 响应文件条目
|
| 产品安装目录
| 安装位置
|
| WebSphere Application Server V6.0
| feature_was6_win32.active
|
| 语言包
| feature_lang_pack_rwd_win32.active
|
| 企业生成语言(EGL)
| feature_egl_win32.active
|
| 用于开发 Eclipse 插件的示例
| feature_examples_win32.active
|
要以静默方式安装任何可选功能部件:
- 将 responsefile.txt 复制为新文件,例如 myresponsefile.txt。
- 编辑响应文件的副本。
- 找到包含上表所示的安装功能部件名称的行。例如,如果要安装用于开发 Eclipse
插件的示例,则要在响应文件中找到下一行:响应文件中的 # -P feature_examples_win32.active=<value> 这一行。
- 对这一行进行下列更改:
- 除去第一列中的 #。
- 将 <value> 更改为 true。
在此示例中,此行将更改为:
-P feature_examples_win32.active=true
- 保存更改。
- 如果您尚未复制映像,则按"设置本地映像"中所述进行复制。
- 从命令行切换至您在上一节中创建的临时目录中的 \disk1\setup 目录(例如,network_drive:\install_image\disk1\setup)。
- 在运行响应文件时,添加 -options 参数以及响应文件的标准名称,如下所示:
setup.exe -silent -options "Your_directory\myresponsefile.txt"
其中 Your_directory 是响应文件所在的标准目录名。
- 注:
- 要验证是否正在使用响应文件,首先在不带 -silent
选项的情况下运行此命令(即,在运行 silent 安装之前),然后验证是否正在安装向导中注册您的设置。如果情况不是这样,则说明响应文件设置或命令语法存在问题。
- 完成 Rational Web Developer 的静默安装可能要花一些时间。要确定何时完成安装,您可以定期查看安装目录中的 \logs 子目录。如果
license.log 文件出现,则表示静默安装已完成。
要启动 Rational Web Developer:
- 选择开始 > 程序 > IBM Rational > IBM Rational Web Developer 6.0 > Rational Web Developer。还可以选择开始 > 程序 > IBM Rational > Rational Software Development Platform 以启动产品。
- 第一次启动 Rational Web Developer 时,将打开一个对话框,并且已指定了缺省的 workspace 目录。缺省情况下,您的工作内容将存储在一个名为 workspace 的目录中,该目录位于 C:\Documents and Settings\youruserid\IBM\rationalsdp6.0 中。如果要将工作保存在其它地方,则可以更改工作空间的名称和位置。
- 缺省情况下,将此项用作缺省工作空间,并且不再询问复选框被清除。如果保持缺省值,则每次启动 Rational Web Developer 时,就会打开一个对话框,它将允许您切换工作空间。您可能需要保持此缺省值,例如,如果您选择为不同的项目保留不同的工作空间。
提示:如果选择了将此项用作缺省工作空间,并且不再询问复选框,则此对话框将不再打开,并且 Rational Web Developer 将使用来自先前会话的工作空间启动。在窗口 > 首选项 > 工作台 > 启动和关闭页面中启动产品之后可以更改缺省值。
- 单击确定。在创建工作空间结构时,将有一些延迟。
工作台会首先打开至一系列欢迎页面,它们显示产品概述和有关新增内容的信息,以及指向教程、样本和外部
Web 资源的链接。请花点时间了解这些选项。另外,还要注意“帮助”菜单中提供的信息资源。
要卸载 Rational Web Developer:
- 关闭 Rational Web Developer。
- 打开“控制面板”,然后打开“添加/删除程序”窗口。选择 IBM Rational Web Developer 6.0 并单击更改/删除以进行卸载。
- 将自动删除任何插件或功能部件目录中的所有文件,包括位于任何这些目录中的用户数据和第三方插件。不会删除包含您的工作的工作空间目录。其它一些保留下来的目录有:
- 保留了 \eclipse\configuration 目录,以防您由于发生问题而卸载 Rational Web Developer 并打算重新安装到同一个目录中。
- 如果第三方插件链接至您的产品,则可能保留 \eclipse\links 目录,以防由于发生问题而卸载 Rational Web Developer 并打算重新安装到同一个目录中。
- 保留了 \logs 目录,以保留安装生成的任何日志文件的历史记录。该目录可能包含一些信息,可用来对遇到的安装相关问题进行故障诊断。
如果尝试部分卸载 Rational Web Developer 的一个或多个必需功能部件,则您将接收到与此类似的错误消息:
选择无效:
无法卸载 ide_required:没有为卸载设置根目录
要解决此问题,选择产品卸载复选框。将重新初始化卸载面板,以便可以完全卸载 Rational Web Developer,或者清除对不想卸载的功能部件的选择。
要以静默方式卸载 Rational Web Developer,从命令提示符转至安装目录并输入:
rwd_prod\_uninst\uninstall.exe -silent
本节讨论有关 Rational Web Developer 的 Windows 安装和卸载的已知问题和局限性。有关影响产品实际使用的问题和局限性的信息,请参阅自述文件或联机帮助。
如果安装失败,则必须除去任何已安装的 Rational Web Developer 文件。如果您打算安装 Rational Web Developer 的目录是空的,则表示安装过程除去了所有已安装的文件,并且可以删除空目录。
如果您在安装 Rational Web Developer 时选择了安装 WebSphere Application Server V6.0 集成测试环境,
但是安装失败了,则您将看到以下消息:
未能安装 WebSphere Application Server V6.0 集成测试环境。IBM Rational Software Development Platform 仍然会运行,但是
WebSphere Application Server V6.0 集成测试环境可能不可用。
有关 WebSphere Application Server V6.0 的对安装进行故障诊断的信息,参阅 http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html。
注意,缺省情况下,WebSphere Application Server V6.0 集成测试环境安装在 Rational Web Developer 安装目录的 \runtimes\base_v6 子目录中。
在 Windows Server 2003 上,如果已经安装和配置了“终端服务器”,则当您卸载 Rational Web Developer 时可能不会除去“WebSphere Application Server V6.0 集成测试环境”。要除去它,从该产品的安装目录(例如,C:\Program Files\IBM\Rational\SDP\6.0)中运行以下命令:
\runtimes\base_v6\_uninst\uninstall.exe -silent
如果在已经开始将文件复制到系统中之后取消安装,并且您是安装到已经存在另一个
Software Development Platform 产品的机器上,则后来继续安装该产品时就会失败。虽然有可能未产生任何错误,但是新安装的产品可能将无法使用。即使存在该产品的“开始”菜单项,但是可能不存在期望的帮助菜单和产品菜单。在该产品中,您可能会看到已经注册了一些插件,但是未提供新产品。
如果在取消合并安装之后仍然遇到这些问题,则需要根据实际情况执行下列其中一项操作:
- 如果您在开始复制文件之前就取消了安装,则可以重新开始安装,而无须遵循下面描述的任何变通方法。
- 变通方法取决于您处于安装过程中的哪个阶段。如果第二次时尚未开始安装,则可以编辑以下列表中适合于您的系统的文件:
- 对于 Windows 2000 和 Windows 2000 Server:C:\winnt\IBM\RAT60\.spdinst\cdi_ref.properties
- 对于 Windows XP 和 Windows 20003 Server:C:\Windows\IBM\RAT60\.spdinst\cdi_ref.properties
- 对于 Red Hat 3.0 和 SLES 9.0:/etc/IBM/RAT60/.spdinst/cdi_ref.properties
除去等号(=)后面具有用来表示安装产品的 3 字母代码的任何内容。这些代码为如下所示:
- rpt = Rational Performance Tester
- rsm= Rational Software Modeler
- rsa= Rational Software Architect
- rad= Rational Application Developer
- rwd= Rational Web Developer
- rft= Rational Functional Tester
在编辑了文件之后,重新开始安装,并且在开始复制文件之后不要取消安装。
- 如果您已经完成了产品的安装,则必须先运行卸载然后再重新安装,并且在开始复制文件之后不要取消安装。
本节包含有关在 Linux 上安装 Rational Web Developer 的信息。可以从 CD-ROM 或者从您下载的电子映像来安装 Rational Web Developer。尽管提供了安装向导,但是您还可以如本文档中稍后所概述的那样,从命令提示符处安装 Rational Web Developer 或者执行静默安装。
安装说明:
- 还可以采用交互式控制台方式来运行安装程序,这种方式可能更适合需要辅助功能的人。“辅助功能方式”命令行选项:
-accessibility
由于使用屏幕阅读器程序,使运行时控制台方式向导更友好。要以控制台方式运行,请在一行上输入以下命令:
CD_device/setup/setup.bin -is:javaconsole -log @NONE -accessibility
其中,在缺省情况下,CD_device 在 SuSE 上是 /media/cdrom,而在 Red Hat 上是 /mnt/cdrom。遵循提示来完成安装。注意,在指定 -accessibility 选项时,-is:javaconsole 选项至关重要。如果不指定此选项,则安装程序将被挂起。-log @NONE 选项将关闭记录,因此,日志信息将不会列示在控制台窗口中。如果在安装期间遇到任何问题,则您可能想除去此选项以便收集日志信息。
要点 - 在使用此产品之前:
- Rational Web Developer 要求运行大量文件,导致系统对它分配大量的文件句柄。每个正在运行的 Rational Web Developer 工具都需要更多文件句柄。这样很容易超出每个进程
1024 个文件句柄的缺省限制,从而导致工具发生故障并且可能会丢失工作空间。为了避免此故障,在使用该产品之前,建议用户让系统管理员增加可供 Rational Web Developer 用户使用的文件句柄的数目。有关如何增加句柄数目的指示信息,请参阅"增加可用文件句柄数"。
可以从 WebSphere Studio V5.1.x 迁移至 Rational Web Developer,也可以选择与 Rational Web Developer 共存。有关更多迁移信息,请参阅 Rational Web Developer 的《迁移指南》。
不能从 WebSphere Studio Site Developer 或 WebSphere Studio Application Developer V4.x.x 或
5.0.x 迁移至 Rational Web Developer。然而,Rational Web Developer 可以与这两个产品中的任何一个共存。如果您愿意,可以采用手工方式将工作空间、工件和项目从 Rational ClearCase、Clear Case LT 和 CVS 迁移至 Rational Web Developer。
有关 IBM Rational Software Development Platform 和基于此开发平台的其它产品之间共存的更多信息,请参阅第 3 章, "IBM Rational Software Development Platform"。
如果具有先前版本的“代理控制器”或从 Hyades 数据收集引擎派生的任何软件,则先停止它并接着卸载,并清除任何剩余的文件,然后才安装此版本的“代理控制器”。有关更多信息,请参阅第 6 章, "安装代理控制器"。
在安装产品之前,请检查:
- 除安装产品所需的空间之外,环境变量 TEMP 或 TMP 指向至少具有 500 MB 可用空间的有效临时目录。
- 终端会话用来安装产品的 umask 设置被设为 0022。此设置使产品可供 root 用户之外的用户使用。要设置此变量,作为 root 用户登录、启动终端会话并输入
umask 0022。
- 注:
- 如果系统启用了自动运行,则在尝试安装产品之前务必将 umask 设置的值设置为 0022。如果 umask 设置未设置为
0022,则不要从系统自动打开的启动板来安装产品。应当关闭启动板,然后使用下列步骤从安装 CD 中安装产品。
要从产品安装 CD 安装 Rational Web Developer,请遵循下列步骤:
- 在开始安装过程之前,请阅读"迁移、升级和共存问题"。
- 作为 root 用户登录。
- 启动终端会话。
- 输入 umask 0022,以便产品可供 root 用户之外的用户使用。
- 将 CD 插入 CD 驱动器。
在安装期间,需要插入下一张 CD。如果不能打开 CD-ROM 插入下一张 CD,则检查:
- 是否存在将 CD_device 作为当前工作目录的终端,其中 CD_device 缺省情况下在
SuSE 上为 /media/cdrom,而在 Red Hat 上为 /mnt/cdrom。
- 除了安装程序之外,是否有另一个应用程序正在使用 CD-ROM。如果确实如此,则停止该应用程序。
如果插入下一张 CD 时仍有问题,则遵循下列步骤:
- 如果安装程序仍在运行中,则单击取消。
- 作为 root 用户登录。
- 如果机器上还没有安装 Linux 分发 CD 中的 psmisc RPM 包,则安装它。
- 启动安装程序。
- 如果问题仍然存在,则从另一个终端输入 /sbin/fuser CD_device 以显示使用 CD-ROM 的进程。
- 要获取进程的详细信息,请输入:ps <process_id>
- 如果 CD-ROM 尚未安装,则通过输入以下命令安装它:
mount CD_device
- 输入 CD_device/launchpad.bin 来显示“Rational Web Developer 安装启动板”窗口。
提示:
- 从 Rational Web Developer 安装启动板中,选择安装 IBM Rational Web Developer V6.0。
- 等待安装向导打开,然后单击下一步以继续安装。
- 遵循屏幕上有关各项任务(例如,阅读许可协议和指定目标安装目录)的指示信息。
- 在“功能部件”窗口中,可以选择要安装的 Rational Web Developer 功能部件。
- 缺省情况下,安装程序将安装“集成开发环境”和可选的 WebSphere Application Server V6.0 作为运行时环境以供测试。
- 如果您想安装除英语之外的受支持本地语言的用户界面和文档,请选择安装语言包。缺省情况下,如果系统语言环境为英语,则没有选中此功能部件。如果系统语言环境是受支持的一种其它本地语言,则选中了此功能部件。
受支持的本地语言包括巴西葡萄牙语、法语、德语、意大利语、日语、韩国语、简体中文、西班牙语以及繁体中文。
注意:如果选择安装可选的“语言包”功能部件,然后在复制文件之后的很短时间内又取消安装,则后续安装将出现一些异常。在后续安装期间,即使没有安装语言包中的那些文件,“语言包”功能部件也会在“功能部件”面板上显示为已安装状态。可以选择重新安装“语言包”功能部件,而且相应的文件将被复制到磁盘。这种情况下,在安装结束时您可能会接收到一条消息:替换文件期间发生了一个或多个错误。可以安全地忽略此错误消息。
- 缺省情况下,不安装“企业生成语言”(EGL)功能部件。EGL 是一种功能强大的高级语言,可用于创建复杂的商业应用程序。它能够处理基础技术(例如,数据库存取、消息队列和 J2EE)的各个复杂方面,以便应用程序开发者可以集中精力处理业务逻辑。要安装
EGL 插件,选择企业生成语言(EGL)复选框。
- 缺省情况下,不安装用于开发 Eclipse 插件的示例。这些示例适用于一些开发者,他们想要通过创建自己的插件工具来扩展工作台。要安装用于开发 Eclipse 插件的示例,请选择用于开发 Eclipse 插件的示例复选框。
- 单击下一步以显示 Rational Web Developer 安装的总结信息。
- 单击下一步以继续安装 Rational Web Developer。
- 当要求插入下一张 CD 时,请遵循下列步骤:
- 要打开 CD-ROM,请输入:eject CD_device
- 将下一张 CD 插入 CD-ROM。
- 如果未启用自动安装,则通过输入以下命令安装 CD-ROM:mount CD_device
- 单击确定以继续进行安装。
- 如果在安装临近结束时接收到有关注册许可证出现问题的警告,则遵循下列步骤:
- 转至安装目录的 /logs 子目录。
- 使用文本编辑器打开 license.log。
- 如果 license.log 包含下列两行中的其中一行:
486604803 所需的许可证已到期
486604805 所有许可证的开始日期都还没有到
确保正确设置了系统时钟,然后启动 Rational Web Developer。
- 安装 Rational Web Developer 之后,单击下一步以完成安装。
- 下一个屏幕将包含一条消息,它将建议您使用 Rational Product Updater 来检查已安装的功能部件是否有更新。(有关更多信息,请参阅第 9 章, "安装更新"。)单击完成以关闭安装窗口。
- 如果计划开发将在其它应用程序服务器上运行的应用程序,则可以选择与 Rational Web Developer 一起安装其它的运行时测试环境。有关更多信息,请参阅第 8 章, "将 WebSphere Application Server 5.x 作为集成测试环境安装"。
- 在可以使用 Rational Web Developer 的概要分析、运行时分析和记录功能部件来远程收集数据之前,必须先在本地主机和远程主机上安装“代理控制器”。有关详细信息,请参阅第 6 章, "安装代理控制器"。
- 注:
- 安装 Rational Web Developer 之后,随时可以通过从安装
CD 的 /setup 目录重新运行 setup.bin 来添加可选的功能部件。在启动了 Rational Web Developer 安装程序的情况下,可以选择要添加的可选功能部件。(在功能部件选择面板上,先前安装的功能部件旁边的括号中会列示已安装。)
-
如果您重新运行安装程序以添加其它功能部件并选择在运行完成之前取消修改,则可能接收到以下错误:
安装期间发生错误 - 用户已取消安装
在此状态下尝试卸载产品时,可能接收到以下错误:
找不到合适的 JVM。请使用选项 -is:javahome <JAVA HOME DIR> 再次运行程序。
要解决此问题,必须再次重新运行安装程序以完成先前取消的修改,然后继续卸载产品。
有关需要下载的电子映像的描述,请参阅产品自述文件。
在安装产品之前,请检查下列各项:
- /tmp 至少需要有 500 MB 可用空间。
- 必须具有大约 3 GB 的磁盘空间来存储整组可下载映像,另外还必须具有 4 GB 的磁盘空间用来解压缩这些映像。
要下载并创建电子安装映像:
- 将所有必需部件和想要的可选部件下载到同一个临时目录中。如果以后需要任何可选部件,则在尝试安装之前,下载其它可选部件并重新运行解压缩工具。
- 通过输入以下命令来修改对位于此临时目录中的 extractor.bin 文件的许可权:
chmod +x extractor.bin
- 通过输入 ./extractor.bin 来执行该文件
- 遵循向导中的指示信息来指定想要在何处创建映像以及想要包括哪些功能部件。
- 在创建了映像之后,如果您想要立即安装产品,则单击完成。或者,可以清除启动安装向导复选框并稍后通过从创建安装映像的目录启动
disk1/launchpad.bin 来运行安装程序。
- 遵循"从 CD-ROM 进行安装"一节中描述的指示信息。
可以在网络驱动器上放置安装映像的副本,以便用户可以通过网络进行安装。
要从网络驱动器运行安装程序,必须使用下载的 Rational Web Developer 电子映像或按下面所述复制各 CD 的内容。
大约需要 4 GB 磁盘空间在磁盘上存储 CD 内容。要从 CD 复制文件:
- 作为 root 用户登录。
- 在网络驱动器上创建一个您想用来存储映像的目录(例如,install_image)。
- 将第一张 Rational Web Developer 安装 CD 插入 CD 驱动器。
- 在临时目录下,创建名为 disk1 的子目录。此子目录必须名为 disk1 并且它必须是小写的。
- 将第一张安装 CD 上的所有文件和目录复制到临时目录中的 disk1 子目录中。
- 重复步骤 3、4 和 5 以将其它两张 CD 的内容复制到名为 disk2 和 disk3 的子目录中。
这些文件都是核心安装文件。如果想要下列任一可选功能部件的安装文件:
- 代理控制器
- WebSphere V5.x 测试环境
则将相应的 CD 的内容复制到临时目录中。
- 注:
- 如果在通过网络安装映像进行安装期间机器进入待机方式,则安装可能失败。
如果您不想与安装向导进行交互,则可以用静默方式运行 Rational Web Developer 安装程序。
在静默安装 Rational Web Developer 之前,必须复制本地映像:
- 在开始安装过程之前,请阅读"迁移、升级和共存问题"。
- 按"创建网络安装映像"中所述创建本地或网络安装映像。如果只想安装 Rational Web Developer,则只需要复制前三张 CD 中的信息。
在缺省情况下,以静默方式安装 Rational Web Developer 时将安装下列功能部件:
- 集成开发环境
- WebSphere Application Server V6.0(用于测试的运行时环境)
- 语言包(如果系统语言环境不是英语的话)
要以静默方式将 Rational Web Developer 以及缺省情况下选择的功能部件安装到缺省目录 /opt/IBM/Rational/SDP/6.0 中:
- 作为 root 用户登录。
- 如果您尚未复制映像,则按"设置本地映像"中所述进行复制。
- 从命令行切换至您在上一节中创建的临时目录中的 disk1/setup 目录(例如,/tmp/install_image/disk1/setup)。
- 运行以下命令:
./setup.bin -silent
- 完成 Rational Web Developer 的静默安装可能要花一些时间。要确定何时完成安装,您可以定期查看安装目录中的 /logs 子目录。如果
license.log 文件出现,则表示静默安装已完成。
通过更改 installLocation 参数,可以将 Rational Web Developer 安装到另一目录。例如,如果要让“/my_softdev”作为安装目录,遵循刚才描述的步骤并运行以下命令:
./setup.bin -silent -P installLocation="/my_softdev"
在此示例中,只安装缺省功能部件。
Rational Web Developer 提供了响应文件样本。此响应文件名为 responsefile.txt,它位于 /disk1/util 目录中。如果要更改响应文件以安装其它功能部件,建议首先生成 responsefile.txt 的备份副本。
可以更新响应文件以安装一个或多个可选的 Rational Web Developer 功能部件。下表显示了响应文件选项以及它们在响应文件中的对应条目。
表 2. 响应文件选项列表。
| 功能部件
| 响应文件条目
|
| 产品安装目录
| 安装位置
|
| WebSphere Application Server V6.0
| feature_was6_linux.active
|
| 语言包
| feature_lang_pack_rad_linux.active
|
| 企业生成语言(EGL)
| feature_egl_linux.active
|
| 用于开发 Eclipse 插件的示例
| feature_examples_linux.active
|
要以静默方式安装任何可选功能部件:
- 将 responsefile.txt 复制为新文件,例如 myresponsefile.txt。
- 编辑响应文件的副本。
- 找到包含上表所示的安装功能部件名称的行。例如,如果要安装用于开发 Eclipse 插件的示例,则要在响应文件中找到下面这一行:
# -P feature_examples_linux.active=<value>
- 对这一行进行下列更改:
- 除去第一列中的 #。
- 将 <value> 更改为 true。
在此示例中,此行将更改为:
-P feature_examples_linux.active=true
- 保存更改。
- 作为 root 用户登录。
- 如果您尚未复制映像,则按"设置本地映像"中所述进行复制。
- 从命令行切换至您在上一节中创建的临时目录中的 disk1/setup 目录(例如,/tmp/install_image/disk1/setup)。
- 在运行响应文件时,添加 -options 参数以及响应文件的标准名称,如下面的示例所示:
./setup.bin -silent -options "Your_directory/myresponsefile.txt"
其中 Your_directory 是响应文件所在的目录的标准目录名。
- 注:
- 要验证是否正在使用响应文件,首先在不带 -silent
选项的情况下运行此命令(即,在运行 silent 安装之前),然后验证是否正在安装向导中注册您的设置。如果情况不是这样,则说明响应文件设置或命令语法存在问题。
- 完成 Rational Web Developer 的静默安装可能要花一些时间。要确定何时完成安装,您可以定期查看安装目录中的 /logs 子目录。如果
license.log 文件出现,则表示静默安装已完成。
在使用该产品之前,建议用户让系统管理员增加可供 Rational Web Developer 用户使用的文件句柄数,使其超过每个进程 1024 个文件句柄的缺省限制。
使用下列步骤来增加 Linux 上的文件描述符时一定要小心。如果未正确遵循指示信息可能会导致不能正确引导机器。最好是让系统管理员来执行此操作。
要增加文件描述符:
- 作为 root 用户登录。如果您不具有 root 用户访问权,则需要获得 root 用户访问权之后才能继续下一步。
- 切换至 etc 目录。
- 使用 vi 编辑器来编辑 etc 目录中的 initscript 文件。如果此文件不存在,则输入 vi initscript 来创建它。
- 注:
- 如果您决定增加文件句柄数,则机器上一定不能存在空的 initscript 文件,否则,下一次将不能引导机器。
- 在第一行中输入 ulimit -n 4096(此处的关键是数目要远大于 1024,也就是要远大于大多数 Linux 机器上的缺省值)。注意:不要将此值设置得太高,这样会严重影响系统范围内的性能。
- 在第二行中输入 eval exec "$4"。
- 在确保完成了步骤 4 和步骤 5 之后,保存并关闭该文件。
- 注:
- 确保正确遵循了这些步骤,如果未正确执行这些步骤将导致不能引导机器。
- (可选)通过修改 etc/security 目录中的 limits.conf 文件来限制用户或组。缺省情况下,SuSE Linux Enterprise Server (SLES) V9 和 Red Hat Enterprise Linux V3.0 都具有此文件。如果由于某些原因,您不具有此文件,则可能需要考虑在上面的步骤 4 中使用一个更适度的数目(例如,2048)。需要执行此操作,以便大多数用户在每个进程打开的文件数的方面,都具有合理的较低限制。如果您在步骤 4 中使用了一个相对较小的数目,则不是特别需要执行此操作。但是,如果您在步骤 4 中选择了设置一个较大的数目,则不执行此操作就可能会严重影响机器的性能。
以下是一个样本 limits.conf 文件,它将限制所有用户,然后又对其他用户设置了不同的限制。此样本假定您在上面的步骤 4 中使用了 8192 这一数字。
* soft nofile 1024
* hard nofile 2048
root soft nofile 4096
root hard nofile 8192
user1 soft nofile 2048
user1 hard nofile 2048
注意,以上示例中的 * 用来首先设置所有用户的限制。这些限制低于后面的其它限制。root 用户将打开更高数目的可允许描述符,而 user1 的限制将介于这两者之间。在进行修改之前,您务必阅读并理解 limits.conf 文件中所包含的文档。
有关 ulimit 命令的更多信息,请参阅 ulimit 的联机帮助页。
要启动 Rational Web Developer,请遵循下列步骤:
- 要从命令行启动 Rational Web Developer,转至安装目录并运行命令:./rationalsdp.bin。
- 如果正在 Gnome(它是 Red Hat 缺省值)中工作,则产品快捷方式将位于主菜单下面的编程 > Rational Software Development Platform 上。如果正在 KDE(它是 SuSE 缺省值)中工作,则产品快捷方式将为 IBM Rational > Rational Software Development Platform。
- 当您第一次启动 Rational Web Developer 时,将打开一个对话框,并且预先指定了缺省工作空间目录。缺省情况下,您的工作内容将存储在一个名为 workspace 的目录中,该目录位于 $HOME/IBM/rationalsdp6.0 目录中。
- 缺省情况下,将此项用作缺省工作空间,并且不再询问复选框被清除。如果保持缺省值,则每次启动 Rational Web Developer 时,就会打开一个对话框,它将允许您切换工作空间。您可能需要保持此缺省值,例如,如果您选择为不同的项目保留不同的工作空间。
提示:如果选择了将此项用作缺省工作空间,并且不再询问复选框,则此对话框将不再打开,并且 Rational Web Developer 将使用来自先前会话的工作空间启动。在窗口 > 首选项 > 工作台 > 启动和关闭页面中启动产品之后可以更改缺省值。
工作台会首先打开至一系列欢迎页面,它们显示产品概述和有关新增内容的信息,以及指向教程、样本和外部
Web 资源的链接。请花点时间了解这些选项。另外,还要注意“帮助”菜单中提供的信息资源。
要在 Linux 上卸载 Rational Web Developer,请遵循下列步骤:
- 作为 root 用户登录。
- 转至安装目录中的 rwd_prod/_uninst/ 子目录。
- 通过输入下列命令来卸载 Rational Web Developer:./uninstall.bin。如果正在使用文件管理器,则可以单击该文件以启动卸载程序。
- 将自动删除任何插件或功能部件目录中的所有文件或功能部件,包括位于任何这些目录中的用户数据和第三方插件。不会删除包含您的工作的工作空间目录。其它一些保留下来的目录有:
- 保留了 eclipse/.config 目录,以防由于发生问题而卸载 Rational Web Developer 并打算重新安装到同一个目录中。
- 如果第三方插件链接至您的产品,则可能保留 eclipse/links 目录,以防由于发生问题而卸载 Rational Web Developer 并打算重新安装到同一个目录中。
- 保留了 /logs 目录,以保留安装生成的任何日志文件的历史记录。该目录可能包含一些信息,可用来对遇到的安装相关问题进行故障诊断。
如果尝试部分卸载 Rational Web Developer 的一个或多个必需功能部件,则您将接收到与此类似的错误消息:
选择无效:
无法卸载 ide_required:没有为卸载设置根目录
要解决此问题,选择产品卸载复选框。将重新初始化卸载面板,以便可以完全卸载 Rational Web Developer,或者清除对不想卸载的功能部件的选择。
要以静默方式卸载 Rational Web Developer,从命令提示符转至安装目录并输入:
rwd_prod\_uninst\uninstall.bin -silent
本节讨论有关 Rational Web Developer 的 Linux 安装和卸载的已知问题和局限性。有关影响产品实际使用的问题和局限性的信息,请参阅自述文件。
- 不要安装到 Novell NetWare 驱动器。在 Novell NetWare 驱动器上的安装将失败。
如果您在安装 Rational Web Developer 时选择了安装 WebSphere Application Server V6.0 集成测试环境,
但是安装失败了,则您将看到以下消息:
未能安装 WebSphere Application Server V6.0 集成测试环境。IBM Rational Software Development Platform 仍然会运行,但是
WebSphere Application Server V6.0 集成测试环境可能不可用。
有关 WebSphere Application Server V6.0 的对安装进行故障诊断的信息,参阅 http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html。
注意,缺省情况下,WebSphere Application Server V6.0 集成测试环境安装在 Rational Web Developer 安装目录的 /runtimes/base_v6子目录中。
请参阅"取消安装合并安装的产品然后再次尝试安装,可能无法正确地安装该产品。"。
“代理控制器”是一个守护程序,它允许客户机应用程序启动和管理本地或远程应用程序,并为其它应用程序提供有关运行应用程序的信息。必须先单独安装“代理控制器”才能使用下列工具:
- 概要分析工具,用于对应用程序进行概要分析。“代理控制器”与您要对其进行概要分析的应用程序必须安装在同一系统上。
- 记录工具,用于导入远程日志文件。“代理控制器”必须安装并运行在导入日志文件的远程系统上。
- 组件测试工具,用于运行测试用例。必须在运行测试用例的系统上安装“代理控制器”。
- 运行时分析工具,用于探针插入、代码覆盖和泄漏分析。
- 注:
- 此工具在 Rational Web Developer 中不受支持。
- 用于在 WebSphere Application Server V5.0 或 V5.1 上进行远程应用程序测试的工具。(不必为远程发布应用程序而安装“代理控制器”;也不必为发布或测试本地应用程序而安装“代理控制器”。)注意,WebSphere Application Server V6.0 中已内置此功能,所以“代理控制器”在版本 6.0 目标服务器上不是必需的。
注意:
- 强烈建议在防火墙后面安装“代理控制器”。
- 在 z/OS(R) 或 OS/400(R) 上,“代理控制器”不具有网络安全功能。
- 有关使用“代理控制器”的安全方面的更多信息,请参阅与 Rational Web Developer 一起提供的“代理控制器”文档。
- 直到安装该软件之后,才会安装“代理控制器”的联机文档。同时,会将该文档添加至 Rational Web Developer 联机帮助。
- Windows 和 Linux/IA32:至少使用 Intel(R) Pentium(R) II 处理器。建议使用 Pentium III 500 MHz 或更高频率的处理器。
- AIX(R):至少使用 PowerPC(R) 604e 233MHz(IBM RS/6000(R) 7043 43P Series)
- HP-UX:至少使用 PA8500 300MHz(HP Workstation C3000)
- Solaris:至少使用 UltraSPARC-IIi 300MHz(Sun Ultra 10 Workstation)
- OS/400:iSeries(TM)(操作系统所必需的)
- z/OS 和 LINUX/S39:zSeries(R)(操作系统所必需的)
- 至少具有 512 MB RAM(建议提供 768 MB RAM)
- 磁盘空间:
- 显示器分辨率:
- 至少使用 800 x 600 显示器(建议使用 1024 x 768)
Linux 注释:“代理控制器”的 Hyades 数据收集引擎功能部件是使用 libstdc++-libc6.2-2.so.3 共享库编译的。确保此共享库位于 /usr/lib 目录下面。如果它不存在,则必须安装随操作系统安装介质一起提供的
RPM 程序包 compat-libstdc++。
已在下列平台上测试“代理控制器”:
- AIX V4.3.3、V5.1 和 V5.2(在 RS/6000 上)
- HP-UX V11.0 和 V11i(在 PA-RISC 上)
- z/OS V1R4 和 V1R5(在 zSeries 上)
- OS/400 V5R1 和 V5R2(在 iSeries 上)
- Red Hat Linux V7.1、V7.2、V7.3 和 V8.0(在 Intel IA32 上)
- Red Hat Linux Advanced Server V2.1(在 Intel IA32 上)
- Sun Solaris V8 和 V9(在 SPARC 上)
- SuSE Linux V7.2 和 V7.3(在 Intel IA32 上)
- SuSE Linux Enterprise Server (SLES) V7 和 V8(在 Intel IA32 上)
- SuSE Linux Enterprise Server (SLES) V7(在 zSeries 上)
- Windows 2000 Advanced Server (service pack 2)(在 Intel IA32 上)
- Windows 2000 Professional (service pack 2)(在 Intel IA32 上)
- Windows 2000 Server (service pack 2)(在 Intel IA32 上)
- Windows NT(R) 4.0 (service pack 6a)(在 Intel IA32 上)
- Windows Server 2003(在 Intel IA32 上)
- Windows XP Professional(在 Intel IA32 上)
尚未在下列平台上测试“代理控制器”,但是期望在这些平台上运行它:
- AIX V4.33、V5.1.0、V5.2.0 和 V5.3(在 pSeries(R) 上)
- Connectiva Linux Enterprise Edition 1.0(在 zSeries 上)
- Connectiva Linux Enterprise Edition 1.0(在 Intel IA32 上)
- HP-UX 11iv1(在 PA-RISC 上)
- Red Flag Advance Server V4.0 和 V4.1(在 Intel IA32 上)
- Red Hat Linux V7.2(在 zSeries 上)
- RedHat Enterprise Linux 3.0 Update 1(在 zSeries 上)
- RedHat Enterprise Linux 3.0 Update 3(在 zSeries 上)
- SuSE V7.2(在 zSeries 上)
- SuSE Linux V7.1(在 Intel IA32 上)
- SuSE Linux Desktop 9.0(在 Intel IA32 上)
- SuSE Linux Standard Edition 9.0(在 Intel IA32 上)
- SuSE Linux Enterprise Server (SLES) 9(在 Intel IA32 上)
- SuSE Linux Enterprise Server 8.0 和 9.0(在 zSeries 上)
- TurboLinux Enterprise Server v8(在 Intel IA32 上)
- TurboLinux Enterprise Server V8(在 zSeries 上)
- United Linux V1.0(在 Intel IA32 上)
- United Linux V1.0(在 zSeries 上)
- Windows Server 2003 Standard Edition(在 Intel IA32 上)
- Windows Server 2003 Enterprise Edition(在 Intel IA32 上)
- Windows Server 2003 Datacenter Edition(在 Intel IA32 上)
- zOS 2.10(在 zSeries 上)
- z/OS V1R1 至 V1R3 和 V1R6(在 zSeries 上)
- z/OS.e V1R3 至 V1R6(在 zSeries 上)
“代理控制器”不可用于下列平台:
- Linux on iSeries
- Linux on pSeries
总之,“代理控制器”可以使用 JVM V1.4 和更高版本。下面是 JVM 版本(java -fullversion),已对这些版本测试“代理控制器”:
- AIX:J2RE 1.4.1 IBM AIX build ca1411-20040301
- HP-UX:J2RE 1.4.2.03-040401-18:59-PA_RISC2.0
- Linux IA32:J2RE 1.4.1 IBM build cxia321411-20040301;J2RE 1.4.2 IBM。
- Linux for OS/390(R):J2RE 1.4.1 IBM build cx3901411-20040301
- z/OS:J2RE 1.4.1 IBM z/OS Persistent Reusable VM build cm1411-20030930
- OS/400:J2RE 1.4 IBM
- Solaris SPARC:Sun Java(TM) 2 Standard Edition(build 1.4.2_04-b05)
- Windows:IA32 J2RE 1.4.1 IBM Windows 32 build cn1411-20040301a;J2RE 1.4.2 IBM Windows 32;Sun Java(TM) 2 Standard Edition (build 1.4.2_04-b05)
“代理控制器”安装文件位于可选软件磁盘中,即在下面列示的目录中:
- 对于 AIX:/IBM_Agent_Controller/aix
- 对于 HP-UX:/IBM_Agent_Controller/hpux
- 对于 OS/400:/IBM_Agent_Controller/os400
- 对于 Linux/S390:/IBM_Agent_Controller/linux_s390
- 对于 Linux/IA32:/IBM_Agent_Controller/linux_ia32
- 对于 Solaris:/IBM_Agent_Controller/solaris_sparc
- 对于 Windows:\IBM_Agent_Controller\win_ia32
- 对于 z/OS:/IBM_Agent_Controller/os390
如果具有先前版本的“代理控制器”或从 Hyades 数据收集引擎获得的任何软件,则先停止它并接着卸载,并清除任何剩余的文件,然后才安装此版本的“代理控制器”。在卸载之后,可能还会保留下列文件:
Windows:
%RASERVER_HOME%\*.*(代理控制器的安装目录)
%SystemRoot%\system32\piAgent.dll(Windows 的 system32 目录)
%SystemRoot%\system32\LogAgent.dll
%SystemRoot%\system32\hcbnd.dll
%SystemRoot%\system32\hcclco.dll
%SystemRoot%\system32\hccldt.dll
%SystemRoot%\system32\hccls.dll
%SystemRoot%\system32\hcclserc.dll
%SystemRoot%\system32\hcclsert.dll
%SystemRoot%\system32\hcclsm.dll
%SystemRoot%\system32\hcjbnd.dll
%SystemRoot%\system32\hclaunch.dll
%SystemRoot%\system32\hcthread.dll
%SystemRoot%\system32\piAgent.dll
%SystemRoot%\system32\rac.dll
%SystemRoot%\system32\sysperf.dll
Linux、AIX、HP-UX 和 Solaris:
$RASERVER_HOME/*(代理控制器的安装目录)
/usr/lib/libpiAgent.so(或 .sl,在 HP-UX 上)
/usr/lib/libLogAgent.so
/usr/lib/libhcbnd.so
/usr/lib/libhcclco.so
/usr/lib/libhccldt.so
/usr/lib/libhccls.so
/usr/lib/libhcclserc.so
/usr/lib/libhcclsert.so
/usr/lib/libhcclsm.so
/usr/lib/libhcjbnd.so
/usr/lib/libhclaunch.so
/usr/lib/libhcthread.so
- 作为管理员(或 root 用户)登录。
- 对于 Windows:如果正在从 Rational Web Developer 安装 CD 安装“代理控制器”,则从“启动板”窗口选择安装代理控制器(如果禁用自动运行,则从安装 CD 的根目录运行 lauchpad.exe)。继续步骤 5。
- 将目录切换至相应平台的安装介质。
- 运行程序 setup.exe。对于非 Windows 平台,运行 setup.bin。
- 在欢迎屏幕上单击下一步以继续。
- 在继续安装之前,关闭所有 Eclipse 平台。单击下一步以继续。
- 阅读许可协议。
- 选择同意并单击下一步以继续。
- 系统将通知您现有的所有“代理控制器”将被除去。单击下一步以继续。
- 指定“代理控制器”应安装的路径并单击下一步以继续。
- 选择想要安装的“代理控制器”功能部件:
- Hyades 数据收集引擎 - 由 Eclipse 开放式源代码项目提供的框架,用于启动本地或远程 Java 应用程序以及对这些程序进行概要分析。
- IBM Rational 插件 - 必须选择此项以便选择此列表中的其余功能部件。
- 记录 - 基于事件的日志框架,用于对应用程序进行概要分析和跟踪。如果选择了 WebSphere Application Server 的“组件测试”或“远程”支持,则必须选择此项。
- 组件测试 - 对手工测试启用的继承支持。
- 运行时分析 - 用于探针插入、代码覆盖和泄漏分析的功能。
- 注:
- 此功能在 Rational Web Developer 中不受支持并且不会安装。
- 安全性 - 为创建 Eclipse 工作台和“代理控制器”之间的保密数据通信信道而提供的。
- WebSphere Application Server 的远程支持 - 用于与远程 WebSphere Application Server V5.0 或 V5.1 连接的功能(用于诸如部署、管理和性能分析等活动)。注意,WebSphere Application Server V6.0 中已内置了这些功能。
单击下一步以继续。
- 指定 Java 运行时环境(JRE)可执行程序 java.exe 或“代理控制器”应使用的 java 的路径。此处输入的
JRE 将由“代理控制器”用于启动 Java 应用程序。因此,您可能需要更改安装程序预填写的
JRE 路径。
- 注:
- 此时提供的 JRE 将用来运行“代理控制器”,也可被“代理控制器”用来启动 Java 应用程序。然而,可以稍后配置“代理控制器”以将 JRE 分别用于每个这样的功能。有关详细信息,请参阅“代理控制器”帮助主题配置由代理控制器启动的应用程序。
- 可选:如果选择了“WebSphere Application Server 的远程支持”,则指定 IBM WebSphere Application Server V5.0(仅适用于 Windows)和 5.1 的路径。
- 指定哪些主机可以访问“代理控制器”。选项为:
- 任何计算机允许任何客户机访问“代理控制器”。(缺省选择。)
- 仅此计算机只允许本地主机访问“代理控制器”。
- 特定计算机允许一系列指定的客户机访问“代理控制器”。使用逗号来分隔列表中的主机名。
单击下一步以继续。
- 如果在上面的步骤 9 中选择了“安全性”:选择安全性设置。
单击下一步以继续。
- 在总结屏幕上单击下一步以继续。
- 在完成文件传输之后,单击完成。
可以通过在安装命令中带有下列参数来静默运行安装过程:
| 参数
| 描述
|
| 必需参数
|
|
-silent
| 指示安装程序以静默方式运行
|
-P installLocation
| 指定安装路径
|
-W javaHome_win.path
| (Windows)指定 java.exe 可执行文件的标准路径
|
-W javaHome_unix.path
| (非 Windows)指定 java 可执行文件的标准路径
|
-W hostList.type
| 指定客户机与“代理控制器”的连接方式(ALL、LOCAL 和 CUSTOM)
- ALL:允许任何客户机
- LOCAL:只允许本地主机
- CUSTOM:允许一列客户机(还需要 -W hostList.hosts 参数)
|
-W security.type
| 指定是否应该启用安全性(true 和 false)
- true:启用安全(还需要“-W security.users”可选参数)
- false:禁用安全性
|
|
|
|
| 可选参数
|
|
-W wasHome_win.was510path
| (Windows)指定 IBM WebSphere Application Server 5.1 的安装位置
|
-W wasHome_unix.was510path
| (非 Windows)指定 IBM WebSphere Application Server 5.1 的安装位置
|
-W wasHome_win.was500path
| (Windows)指定 IBM WebSphere Application Server 5.0 的安装位置
|
-W wasHome_unix.was500path
| (非 Windows)指定 IBM WebSphere Application Server 5.0 的安装位置
|
-W hostList.hosts
| 指定客户机主机名,用逗号分隔(条件是 hostList.type="CUSTOM")
|
-W security.users
| 指定哪些用户可以连接至“代理控制器”(条件是 security.type = "true")
|
-P hyadesdc_ibm_runtimeAnalysis_feature.active=false
| 指定不安装“运行时分析”功能部件(缺省情况下,它是在静默安装期间安装的)
|
- 注:
- 如果正在通过不安全的连接来以静默方式安装“代理控制器”,则使用参数 security.type.="false"。
Windows 示例:
setup.exe
-silent
-P installLocation="D:\IBM\AgentController"
-W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
-W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
-W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
-W hostList.type="CUSTOM"
-W hostList.hosts="host1,host2"
-W security.type="true"
-W security.users="user1,user2"
非 Windows 示例:
setup.bin
-silent
-P installLocation="/opt/IBM/AgentController"
-W javaHome_unix.path="/opt/java1.4.1/jre/bin/java"
-W wasHome_unix.was510path="/opt/WebSphere5.1/AppServer"
-W wasHome_unix.was500path="/opt/WebSphere5.1/AppServer"
-W hostList.type="CUSTOM"
-W hostList.hosts="host1,host2"
-W security.type="true"
-W security.users="user1,user2"
使用响应文件
可以创建响应文件(例如,setup.rsp)来存储所有上面的参数,而不必在命令行上指定它们:
# Start of response file
-P installLocation="D:\IBM\AgentController"
-W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
-W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
-W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
-W hostList.type="CUSTOM"
-W hostList.hosts="host1,host2"
-W security.type="true"
-W security.users="user1,user2"
# End of response file
要使用响应文件来进行安装:
Windows:setup.exe -silent -options d:\temp\setup.rsp
非 Windows:setup.bin -silent -options /tmp/setup.rsp
- 在 Windows 上,“代理控制器”系统服务(RAService.exe)将自动启动。
- 使用“控制面板”下面的“Windows 服务”对话框来启动或停止“代理控制器”服务(开始 > 设置 > 控制面板 > 管理工具 > 服务 > IBM Rational 代理控制器)。
- 在非 Windows 平台上,“代理控制器”进程(RAServer)不会自动启动。您必须自己启动它。
- 要点:在启动“代理控制器”之前,必须对非 Windows 平台设置下列环境设置。
- 要启动“代理控制器”进程,切换至安装位置的 bin 目录(例如,/opt/IBM/AgentController/bin)并运行
./RAStart.sh
- 要停止“代理控制器”进程,切换至安装位置的 bin 目录(例如,/opt/IBM/AgentController/bin)并运行
./RAStop.sh
- 可以从“控制面板”下面的添加/删除程序对话框中除去“代理控制器”。
- 要执行静默卸载,从安装位置的 _uninst
目录(例如,C:\Program Files\IBM\AgentController\_uninst)运行命令 uninstall.exe -silent。
- 从安装位置的 _uninst
目录(例如,/opt/IBM/AgentController/_uninst)运行程序 uninstall.bin。
- 遵循屏幕上的指示信息来完成卸载。
- 要执行静默卸载,使用 uninstall.bin -silent 命令。
如果具有先前版本的“代理控制器”或从 Hyades 数据收集引擎获得的任何软件,则先停止它并接着卸载,然后安装此版本。
- 在 iSeries 主机上,创建名为 HYADESDC 的库和名为 IBMRAC 的另一个库:
CRTLIB HYADESDC
CRTLIB IBMRAC
- 在 iSeries 主机上,在 HYADESDC 库中创建一个名为 HYADESDC.SAVF 的空保存文件:
CRTSAVF HYADESDC/HYADESDC
- 在 iSeries 主机上,在 IBMRAC 库中创建一个名为 IBMRAC.SAVF 的空保存文件:
CRTSAVF IBMRAC/IBMRAC
- 使用 FTP 将文件 IBMRAC.SAVF 从安装 CD 添加至位于 iSeries 主机上的 IBMRAC 库(使用二进制传送方式)。
- 使用 FTP 将文件 HYADESDC.SAVF 从安装 CD 添加至位于 iSeries 主机上的 HYADESDC 库(使用二进制传送方式)。
- 通过输入以下命令将 iSeries 主机上的保存文件 HYADESDC.SAVF 复原到 HYADESDC 库中:
RSTOBJ OBJ(*ALL) SAVLIB(HYADESDC) DEV(*SAVF) SAVF(HYADESDC/HYADESDC)
- 通过输入以下命令将 iSeries 主机上的保存文件 IBMRAC.SAVF 复原到 IBMRAC 库中:
RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRAC)
- 启动 QShell 并在集成文件系统(IFS)上创建 /opt/hyadesdc 目录。
- 将 HYADESDC 中的保存文件 HYADESIFS.SAVF 复原至 IFS 目录 /opt/hyadesdc 中。例如:
RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESIFS.FILE') OBJ('/opt/hyadesdc/*')
- 将 IBMRAC 中的保存文件 IBMRACIFS.SAVF 复原至 IFS 目录 /opt/hyadesdc。例如,在一行上输入以下命令:
RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
- 安装“代理控制器”之后,将目录切换至安装位置的 bin 目录 /opt/hyades/bin,并通过输入以下命令来运行安装脚本:
./SetConfig.sh
- 遵循屏幕上的提示来配置“代理控制器”。
- 要启动“代理控制器”,将 HYADESDC 和 IBMRAC 库添加至库列表:
ADDLIBLE HYADESDC
ADDLIBLE IBMRAC
- 通过输入以下命令来提交 RAStart 作业:
SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
- 要停止“代理控制器”,通过输入以下命令来终止 RAStart 作业:
ENDJOB JOB(RASTART)
- 除去 HYADESDC 和 IBMRAC 库。
- 除去 IFS 目录 /opt/hyadesdc(包括所有子目录和文件)。
如果具有先前版本的“代理控制器”或从 Hyades 数据收集引擎获得的任何软件,则先停止它并接着卸载,然后安装此版本。
- 在 UNIX(R) 系统服务 shell 中,转至想要安装“代理控制器”的目录。建议您将它安装在 /usr/lpp/ 目录中。
- 将安装映像 ibmrac.os390.pax 传送至安装目录。
- 发出以下命令来解压缩“代理控制器”文件:
pax -ppx -rf ibmrac.os390.pax
- 将目录切换至安装 bin 目录 /usr/lpp/IBM/AgentController/bin,并通过输入以下命令来运行创建链接脚本:
./createLinks.sh
- 通过在 UNIX(R) 系统服务 shell 中发出以下命令来控制“代理控制器”共享对象文件程序:
extattr +p /usr/lpp/IBM/AgentController/lib/*.so
- 在安装“代理控制器”之后,将目录切换至安装位置的 bin 目录 /usr/lpp/IBM/AgentController/bin,并通过输入以下命令来运行安装脚本:
./SetConfig.sh
- 遵循屏幕上的提示来配置“代理控制器”。
在 z/OS 上使用数据通道:
为了在 serviceconfig.xml 文件中设置较大的 dataChannelSize,可能需要增大机器上的最大共享内存段大小设置。为此,请增大 BPXPRMxx 参数库成员中的 IPCSHMMPAGES 值。此值是数据通道可具有的最大 4K 页数。例如,如果要将 dataChannelSize 设置为 32M,则必须将 IPCSHMMPAGES 设置为大于 8192 的值。
要允许“代理控制器”同时与许多代理程序通信,您必须将 BPXPRMxx parmlib 成员中的
IPCSHMNSEGS 值设置为正确的值。此值指定每个地址空间连接的共享内存段的最大数目。缺省值是 10,因此您应该将此值增大为 50。
有关“代理控制器”所使用的数据通道的更多信息,请参阅“代理控制器”的联机帮助信息。
有关 z/OS BPXPRMXX parmlib 成员及如何更新它们的更多信息,请参阅 IBM z/OS MVS(TM) Initialization and Tuning Reference。
注意:RAServer
需要包含要添加至 LIBPATH 环境变量的可执行库(例如,libjvm.so)JRE 的目录。例如,如果正在使用 IBM JRE 1.4.1,则 LIBPATH 变量将设置为如下所示:
export LIBPATH=/usr/lpp/java/IBM/J1.4/bin/classic:/usr/lpp/java/IBM/J1.4/bin:$LIBPATH
- 通过作为 root 用户登录,然后打开 /usr/lpp/IBM/AgentController/bin 目录并发出以下命令来启动服务器:
./RAStart.sh
- 要停止服务器,应作为 root 用户登录,打开 /usr/lpp/IBM/AgentController/bin
目录并发出以下命令:
./RAStop.sh
以下列表包含有关在所有平台上使用“代理控制器”安全功能的提示与技巧:
- 认证是由操作系统提供的。只允许在安装时指定的用户进行认证。如果提供了用户名 ANY,则将把任何有效的用户名密码对转发至操作系统以进行认证,否则将只转发列示的用户名密码对。
- 在启用了安全性的情况下,在安装时指定的用户需要先与操作系统进行认证,然后才可与“代理控制器”交换任何信息。工作台用户必须提供有效的用户名与密码组合,该用户名和密码就是操作系统的用户名和密码。
- (仅适用于 Windows)将不对域名密码进行认证。必须提供本地用户名密码对。
- 未提供密钥管理功能。“代理控制器”使用 Java 密钥库来保证安全性。
- 缺省密钥库和导出的证书位于“代理控制器”的 \plugins\com.ibm.etools.pd.security\security(适用于 Windows)和 /plugins/com.ibm.etools.pd.security/security(适用于 Linux)目录中。这些密钥库和证书仅仅是样本。您应该将这些密钥库和证书替换为包含有意义证书的密钥库。
本节讨论与安装和卸载“代理控制器”相关的已知问题和局限性。除非另有声明,否则以下信息适用于支持“代理控制器”的所有操作系统。
“代理控制器”在非 Windows 平台上可能无法启动并发出以下消息:
RAServer 无法启动。
当 TCP/IP 端口 10002 处于使用状态时,通常会导致此故障。缺省情况下,“代理控制器”在此端口上侦听。在启动“代理控制器”时,另一个正在系统上运行的进程可能正在使用此端口;也可能是在可以释放该端口之前,“代理控制器”刚刚停止并接着重新启动。
如果“代理控制器”未能启动,可按如下方式启动它:
- 如果端口 10002 正在被另一个进程使用,则可以通过编辑
serviceconfig.xml 文件来更改端口号。这在文档中已进行了描述。
- 注:
- 如果更改了在 serviceconfig.xml 文件中配置的通信端口号,则需要将在 WebSphere Application Server 配置中定义的属性 INSTANCE_RAC_PORT_NUM_ID 更改为同一个端口号。
- 如果“代理控制器”刚刚停止,则请等待几分钟并再次尝试启动它。
如果在安装或卸载期间遇到错误,则这可能是由于正在运行的进程装入“代理控制器”对象文件而引起的。要确保可以修改对象文件,执行下列操作:
- 关闭 Rational Web Developer。
- 终止包含“Java 概要分析代理程序”或“J2EE 请求概要分析程序”的所有
java.exe 进程。
缺省情况下,Rational ClearCase SCM 适配器插件是随 Rational Web Developer 自动安装的,以支持将 Rational ClearCase 用作软件配置管理(SCM)系统。有关 Rational ClearCase 的更多信息,请参阅 www.ibm.com/software/awdtools/clearcase/。
缺省情况下,“并发版本控制系统”(CVS)插件也是随 Rational Web Developer 自动安装的,以支持将 CVS 用作 SCM 系统。可从 www.cvshome.org 获取 CVS 服务器的最新版本。不需要安装 CVS 客户机来使用 CVS,只需要 CVS 服务器。
有关安装和使用 CVS 的更多信息,请参阅小组联机帮助。
必须启用 Rational ClearCase SCM 适配器和 CVS
插件才能使用它们。要启用这些插件:
- 从 Rational Web Developer 菜单中,选择窗口 > 首选项。
- 在工作台下面的“首选项”页面上,单击功能。
- 在“功能”窗口中,滚动至小组并单击想要启用的适配器的复选框。
- 单击应用,然后单击确定。
当通过选择期望的小组资源库提供程序来共享项目时,还可以启用插件。
Rational ClearCase 客户机或服务器以及 CVS
服务器都不是自动安装的。必须将它们与 Rational Web Developer 分开安装。
要将 Rational Web Developer 与提供的其它 SCM 系统配合使用,您就需要该 SCM 产品的特定适配器。SCM
适配器通常是由 SCM 产品供应商提供的。IBM 不保证或担保其它 SCM 适配器的使用情况。有关其它 SCM 产品适配器的支持或进一步的信息,请直接与 SCM 产品供应商联系。
Rational ClearCase SCM 适配器需要 ClearCase V2002 或更高版本(完全安装的 ClearCase 或 ClearCase LT,至少具有必需的最小补丁),如下表中列示的那样:
表 3. Windows
| 必需的 ClearCase 版本和最小补丁
|
| IBM Rational ClearCase V2002.05.00 和 p2002.05.00.NT-32
|
| IBM Rational ClearCase LT V2002.05.00 和 clearcase_lt_p2002.05.00.NT-11
|
| IBM Rational ClearCase V2003.06.13
|
| IBM Rational ClearCase LT V2003.06.13
|
表 4. Linux
| 必需的 ClearCase 版本和最小补丁
|
| IBM Rational ClearCase V2002.05.00 和 clearcase_p2002.05.00-38
|
| IBM Rational ClearCase LT V2002.05.00 和 clearcase_lt_p2002.05.00-17
|
| IBM Rational ClearCase V2003.06.00 和 clearcase_p2003.06.00-11
|
| IBM Rational ClearCase LT V2003.06.00 和 clearcase_lt_p2003.06.00-6
|
注意: 在安装 Rational ClearCase(或 ClearCase LT)和 Rational Web Developer 之后,必须确保
ClearCase 客户机和服务器环境已使用最新的适当补丁作了更新。必须安装补丁,以便对比较和合并“统一建模语言”(UML)图提供正确的支持。在使用 Rational Web Developer 时,如果未使用最新的适当补丁更新 Rational ClearCase(或 ClearCase LT),在比较和合并 UML 图文件时可能会发生模型毁坏。
要获取 Rational ClearCase 发行版和补丁,请访问 www.ibm.com/software/awdtools/clearcase/support/index.html 或者致电 IBM Rational 支持机构,电话号码为 1-800-IBM-SERV(1-800-426-7378)。
Rational Web Developer 支持下列版本的 Rational ClearQuest(R):
- Rational ClearQuest V2003.06.13(SR3)
Rational ClearQuest 是一个非常灵活的缺陷和更改跟踪系统,它对在提交、分配、跟踪、测试和发布更改请求时涉及到的过程进行组织并自动执行它们。有关 Rational ClearQuest 的更多信息,请访问 www.ibm.com/software/awdtools/clearquest/。Rational ClearQuest Client for Eclipse 提供了 ClearQuest 与 Eclipse 平台(包括 Rational Software Development Platform)之间的无缝集成。
为了使用 Rational ClearQuest Client for Eclipse,您必须首先:
- 安装 Rational Web Developer。
- 安装和配置基本 Rational ClearQuest 应用程序(V2003.06.13)。与本地的 Rational ClearQuest 管理员联系,以便了解如何安装和配置 Rational ClearQuest 客户机应用程序以及如何与数据库建立连接。
有关下载 Rational ClearQuest Client for Eclipse 的信息可以在以下网址找到:www.ibm.com/support/docview.wss?uid=swg24007802。有关完整的安装指示信息,参阅在此 URL 处提供的 Readme 文件。
缺省情况下,WebSphere Application Server 6.0 会随 Rational Web Developer 自动安装。如果您计划开发将在 5.x 应用程序服务器上运行的应用程序,则可以选择安装其它的运行时测试环境。
必须先安装 Rational Web Developer 才能安装附加运行时测试环境。
您可以选择安装下列集成测试环境:
- WebSphere Application Server 5.1
- WebSphere Application Server Express 5.1
-
WebSphere Application Server 5.0.2
-
WebSphere Application Server Express 5.0.2
要安装一个或多个后备级别集成测试环境,遵循下列步骤:
- 从 Rational Web Developer 启动板中,单击安装 WebSphere 测试环境 V5.x。“IBM Rational 5.x 集成测试环境”安装程序将打开。
- 单击下一步。
- 接受许可协议并单击下一步。
- 选择想要安装的集成测试环境。单击下一步。
- 查看总结信息并单击下一步来开始安装。此安装总结将包括要安装测试环境的位置。
- 当安装完成时,单击完成以退出安装程序。
- 注:
- 如果安装了嵌入式消息传递和排队支持功能部件,则在卸载嵌入式消息传递和排队功能部件之前一定不能卸载 WebSphere V5.x 测试环境。

要在 Windows 上卸载 V5.x 测试环境,遵循下列步骤:
- 打开“控制面板”。
- 单击添加/删除程序。
- 单击 IBM Rational 5.x 继承的集成测试环境并单击更改/删除。
- “IBM Rational 5.x 测试环境”卸载程序将打开。单击下一步。
- 选择想要卸载的测试环境并单击下一步。
- 查看总结信息并单击下一步。
- 当测试环境卸载完毕时,单击完成以退出卸载程序。

要在 Linux 上卸载继承的测试环境,遵循下列步骤:
- 作为 root 用户登录。
- 转至安装目录中的 lte_prod/_uninst 子目录。
- 通过输入以下命令来卸载 V5.x 测试环境:./uninstall.bin。如果正在使用文件管理器,则可以单击该文件以启动卸载程序。
- “IBM Rational 5.x 测试环境”卸载程序将打开。单击下一步。
- 选择想要卸载的测试环境并单击下一步。
- 查看总结信息并单击下一步。
- 当测试环境卸载完毕时,单击完成以退出卸载程序。
Rational Product Updater 是一个工具,它会跟踪安装在系统上的所有 Rational 软件开发产品并且搜索产品更新和可选的新功能部件,然后安装它们。
Product Updater 是随您安装的第一个 Rational 软件开发产品自动安装的。将使用此工具自动注册您安装的所有后续 Rational 软件开发产品。对于这些产品,可以搜索并自动安装下列几种更新:
- 产品更新,例如,修订包、更新包和临时修订。
- 提供新功能的可选功能部件。
更新之间的所有依赖性都是自动强制实施的。Product Updater
使您可以管理来自单个位置的所有 Rational 软件开发产品的更新。它甚至会更新自身。
Product Updater 还使您能够执行下列任务:
- 生成已安装的 Rational 软件开发产品的详细列表,包括有关已安装的修订和可选功能部件的信息。
- 创建一个或多个本地(代理)产品更新站点,以便您所在公司的用户不必全部从因特网安装更新。
有关使用 Product Updater 的信息,请参阅该工具的帮助系统,可按如下方式访问帮助系统:
- 要启动 Product Updater,在 Rational Web Developer 中选择帮助 > 软件更新 > IBM Rational Product Updater。
- 在 Product Updater 中,选择帮助 > 帮助内容。
请参阅版权和声明。