故障诊断

请参阅下表以了解一些常见问题及其相应的解决方案。

有关故障诊断的其它资源

参阅 Rational® Developer 的自述文件。可在 Rational Developer 的安装启动板上访问它。

问题解决方案

问题 解决方案
不能启动 WebSphere® Portal 测试环境
  • 确保安装了 WebSphere Portal 测试环境。检查安装日志以验证安装是否成功。WebSphere Portal 5.0 测试环境的安装日志为 workbench_installdir\runtimes\portal_v50\log\wpsinstalllog.txt
  • 更改服务器配置:仅当 WebSphere Portal V5.0 测试环境不能以调试方式启动时,此解决方案才适用。在服务器配置中,确保在服务器页面中选择了在调试方式下启用热方法替换复选框。为此,执行下列步骤:
    1. 在“服务器”视图中,双击在调试方式下未能启动的 WebSphere Portal V5.0 测试环境以打开其服务器配置。
    2. 选择“概述”页。
    3. 选择“在调试方式下启用热方法替换”复选框。
    4. 按 Ctrl+S 以保存更新后的服务器配置。
  • 仅适用于 Linux™:更改 WebSphere Portal 数据库的访问许可权:因为 WebSphere Portal 的局限性,WebSphere Portal 测试环境仅可供一个用户使用。可通过对 WebSphere Portal 数据库开放读、写和执行许可权来允许其他用户使用服务器。要更改访问许可权,执行下列命令:
    1. cd /opt/PortalUTE/PortalServer/cloudscape/
    2. chmod -R 777 wps50
    或者,您可以通过卸载并重新安装 WebSphere Portal 测试环境来更改可以使用服务器的用户。
  • 仅适用于 Windows®验证 Windows 用户是否为 Administrator:

    您必须作为 Administrator 登录。否则,作为 Administrator 登录至 Windows 并运行 WebSphere Portal 测试环境。

  • 要运行或调试 Struts portlet,并且 portlet 具有静态(非 JSP)或 XML 内容,则需要启用代码转换(请参阅启用代码转换)。
  • 要运行或调试引用其它 Java™ 或 EJB 项目的 portlet 项目,请参阅引用其它项目
  • 要运行或调试使用应用程序库文件的 portlet 项目,请参阅配置本地服务器以测试 portlet中有关共享库的部分。
  • 检查 WebSphere Portal 的日志以确定问题所在。请参阅日志文件或启用控制台日志记录,如配置本地服务器以测试 portlet中所述。
不能对 WebSphere Portal 测试环境创建服务器。
  • 确保已安装想要使用的 WebSphere Portal 测试环境。仅当已安装测试环境,才能创建 WebSphere Portal 测试环境服务器。
  • (仅适用于 WebSphere Portal V5.1)确保您已经按配置 WebSphere Portal 5.1 测试环境中所述配置了首选项。
导入、导出或部署的门户网站发生 JSP 或 Java 编译错误 如果发生以下任何情况,依赖于某些类的外部 JAR 文件的 JSP 文件或 Java 类可能无法编译:
  • JSP 文件或 Java 类是从远程门户网站服务器导入的,并且使用远程服务器的 WebSphere_install_directory/libPortal_server_install_directory/shared/app 目录中的外部 JAR 文件。
  • JSP 文件或 Java 类是从 Rational Developer 项目导出的,该项目具有对 JAR 文件的访问权,并且安装在对 JAR 文件没有访问权的外部门户网站服务器上
  • JSP 文件或 Java 类是从 Rational Developer 项目部署的,该项目具有对 JAR 文件的访问权并且目标门户网站服务器对 JAR 文件没有访问权

可能会因为导入、导出和部署操作对引用的 JAR 文件不起作用而发生这种情况。

要解决此问题,在门户网站项目使用外部 JAR 文件时,这些 JAR 文件需要对服务器可用。
  • 要使 JAR 文件对门户网站项目可用,将这些 JAR 文件复制至开发机器并将它们添加至门户网站项目的 Java 构建路径。要设置 Java 构建路径,遵循下列步骤:
    1. 从“项目资源管理器”视图中突出显示该项目并选择属性
    2. 在左窗格中,选择 Java 构建路径
    3. 在右窗格中选择选项卡。
    4. 添加被引用的 JAR。
    5. 单击确定以保存配置。
  • 要使 JAR 文件对 WebSphere Portal 测试环境可用,将这些 JAR 文件复制至开发机器并将它们添加至测试环境服务器的 workbench_install_directory/runtimes/portal_v5X/shared/app 目录。
  • 要使 JAR 文件对外部门户网站服务器可用,在导出或部署门户网站项目后手工将所需的 JAR 文件复制至外部门户网站服务器系统。
WebSphere Portal 测试环境中的 java.lang.NoClassDefFoundError 当使用本地调试来测试或调试 portlet 应用程序并且该 portlet 应用程序需要使用库文件或引用其它项目时,需要在服务器上能够使用它们。参阅配置本地服务器以测试 portlet引用其它项目中有关共享库的部分。
当运行或调试 portlet 时,代码转换功能没有正确运行 缺省情况下,在 WebSphere Portal 测试环境中禁用代码转换功能。您需要启用它。请参阅启用代码转换
不能使用 WebSphere Portal 测试环境启动 WML 设备仿真器 要在 WML 设备仿真器中运行或调试 portlet,需要启用代码转换。请参阅启用代码转换。还需要使用配置 Web 浏览器和设备仿真器中的指示信息来定义设备仿真器程序。
不能在 WebSphere Portal 测试环境中运行个性化 portlet 项目 要运行或调试个性化 portlet 项目,您需要使用在远程服务器上运行的 WebSphere Portal Server Attach 和 WebSphere Portal。
启动 Rational Developer 时发生“无法恢复工作台”错误 重新启动 Rational Developer 并指定新的目录作为工作空间。如果您以前选择了将此工作空间用作缺省工作空间并且不再显示此对话框,并且未出现允许您指定工作空间目录的对话框,则使用 -data 参数来启动工作台。从命令行:


对于 Windows

cd workbench_installdir
rationalsdp.exe -data workspace_directory


对于 Linux

cd workbench_installdir
rationalsdp.sh -data workspace_directory

其中 workbench_installdir 是安装 Rational Developer 的目录,并且 workspace_directory 是您想要使用的新工作空间目录

为 WebSphere Portal 4.2 开发的 Portlet 在 WebSphere Portal 5.0 上不能正常工作 仅当这些 portlet 是由 Portal Toolkit 5.0.2 或更早版本开发的时候,此解决方案才起作用。

从 portlet 项目或从 WAR 文件删除 /WEB-INF/tld/portlet.tld 文件。

为 WebSphere Portal V4.2 编写的大多数 portlet 在 WebSphere Portal V5.x 将按原样运行。一些 Portlet API 4.2.x 现在被标记为不推荐使用,但在 WebSphere Portal V5.x 上仍然可用。但是,portlet.tld 文件在两个版本的 WebSphere Portal 之间是不同的。在 Portal Toolkit 5.0.2 或更早版本中的 portlet 项目中包括此文件。

在测试环境中运行(测试)或调试 portlet 失败。启动在服务器上运行在服务器上调试任务之后,测试环境处于正在启动状态,但它已经终止了。portlet 在 JSP 文件或 Java 代码中不存在验证错误,并且部署描述符也是正确的。 确保在工作台首选项中选择了自动构建。要检查该值,选择窗口 > 首选项 > 工作台
在远程机器上部署或测试 portlet 失败。可能是执行下列任一任务时失败:
  • 使用“部署”向导部署 portlet。
  • 使用 Server Attach 服务器运行或调试 portlet 项目。
  • 部署使用 portlet 项目的门户网站项目。
  • 运行或调试使用 portlet 项目的门户网站项目。
确保服务器配置正确。请参阅配置网络以进行部署
在 WebSphere Portal 测试环境服务器上运行或调试项目时,“控制台”视图中的内容被截断。 确保在工作台首选项中未选择限制控制台输出。要检查该值,选择窗口 > 首选项 > 运行/调试 > 控制台
当两个或更多 JSR 168 portlet 项目与其相关联时,WebSphere Portal V5.1 测试环境不启动。 当两个或更多 JSR 168 portlet 项目与服务器相关联并且 portlet 部署描述符中的 <portlet-app> 元素上没有标识属性时,WebSphere Portal V5.1 测试环境无法启动。如果标识属性不是唯一的,则可能发生同一问题。要解决此问题,编辑 portlet 部署描述符(portlet.xml),并将具有唯一值的标识属性添加至 <portlet-app> 元素。在编辑 portlet 部署描述符时使用“源代码”页进行此更改。
将 JSR 168 portlet 项目部署至 WebSphere Portal V5.0 服务器这一操作仅一次有效。 使用 WebSphere Portal Server 上的 WebSphere Portal 管理页面除去(卸载)想要部署的 JSR 168 portlet,对门户网站服务器应用修订 PQ92087,然后使用 Rational Developer 再次部署 portlet。
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.