1.0 简介
2.0 受支持的软件和规范
3.0 对前发行版的更改
4.0 限制
4.1 WebSphere 服务器必须具有匹配的代码页
5.0 已知问题
5.1 为 WebSphere V5 配置 J2C 资源适配器
5.2 因无效字符而不能创建或启动 WebSphere Application Server
5.3 长目录名会导致 JSP 测试出错
5.4 Internet Explorer:在使用本地地址时禁用代理或 socks 服务器
5.5 与因特网断开连接后使用 Apache Tomcat 的问题
5.6 WebSphere 服务器安全性
5.7 运行与 WebSphere Application Server 连接的 Java 应用程序
5.8 在启用安全性的情况下运行 WebSphere V4.0 管理客户机
5.9 WebSphere 测试环境版本
5.10 在通用测试客户机中使用构造函数
5.11 在 Windows 上发布远程 V5 服务器时的区分大小写问题
5.12 通用测试客户机中的缺省 JNDI 提供程序 URL
5.13 J2EE 客户机不能访问远程机器上的测试环境服务器
5.14 对 WebSphere V4.0 进行跟踪
5.15 在卸载 WebSphere V4 运行时之后还残留下一些文件
5.16 应用 WebSphere V4 PTF 时出现的消息
5.17 在 WebSphere V5 管理控制台中创建数据源和服务器
5.18 移动服务器配置并重命名服务器项目
5.19 WebSphere 服务器的路径选项
5.20 设置远程服务器以使用嵌入式消息传递
5.21 忽略控制台视图中的“只安装了嵌入式消息传递客户机”消息
5.22 配置 Cloudscape 5.1
5.23 将 WebSphere 服务器重新发布至 AIX 机器导致警告消息
5.24 全速调试和热方法替换支持
5.25 WebSphere MQ 迁移
5.26 从 WebSphere Studio V5.0 迁移已部署连接器项目
5.27 WebSphere 服务器因工作空间路径以反斜杠开始而未启动
5.28 保存新的 JAAS 认证条目时可能会导致服务器毁坏
“服务器工具”功能部件允许您在不同的本地和远程运行时环境中测试和发布 J2EE 应用程序。本自述文件描述与以下“服务器工具”功能相关联的限制、已知问题和变通方法:
- 使用服务器和服务器配置设置服务器。(服务器和服务器配置是“服务器工具”使用的构造,用来在不同的运行时环境中进行测试和发布。)
- 在 IBM WebSphere Application Server 或 Apache Tomcat 上测试 J2EE 项目。
- 在通用测试客户机上测试企业 bean。
- 静态 Web 项目支持。
与测试和发布有关的联机帮助包含有关“服务器工具”的限制以及有关解决“服务器工具”中的问题的其它信息。
有关受支持的运行时环境的信息,参阅产品自述文件。
“通用测试客户机”要求使用 Netscape V6.0 或更高版本,或者使用 Microsoft Internet Explorer 5.0 或更高版本。
服务器工具支持测试项目和将项目发布到 Windows、Linux 和 AIX 机器上的 WebSphere 服务器中。
使用 WebSphere 服务器进行测试时,远程机器必须与本地机器具有相同的代码页。运行具有不同代码页的本地和远程服务器不受支持,并且可能会导致控制台毁坏。
单击 WebSphere V5 服务器配置编辑器的 J2C 页面上的“添加”按钮时,可能会收到错误。要解决此问题,在 EAR 内配置连接器模块或执行下列步骤:
1. 启用 WebSphere 管理控制台并启动服务器。
2. 打开并登录到管理控制台。从左边选择资源 > 资源适配器。
单击新建。输入连接器模块的名称并指定项目中 connectorModule 文件夹的全限定路径。例如,C:\workspace\myConnector\connectorModule。
4. 单击应用,然后刷新 IDE 中的服务器项目。现在,可以继续使用服务器配置编辑器进行任何进一步的更改。
如果将 WebSphere Studio 安装到名称包含美元符号($)或任何特殊字符(例如,#、%、+ 或 *)的目录中,可能不能创建或成功启动 WebSphere 服务器。要避免这种情况,不要将 WebSphere Studio 安装到包含这些字符中的任何字符的目录中。
当创建 WebSphere 服务器或者将包含 WebSphere 服务器的服务器项目时,在名称中不要包括 #、%、& 或 * 字符。WebSphere Application Server 不支持这些字符。
如果在具有长路径的目录中使用工作空间,或者为企业应用程序项目或 Web 项目选择长名称,当尝试执行 JSP 页时,可能会产生以下错误消息:
错误消息:JSPG0113E:JSP 文件
未找到“Xxx/Yyy_jsp_0.java(文件名太长)”如果接收到此错误,则可执行下列任一项操作:
- 将工作空间移至具有较短路径的位置中,例如,c:/workspace。
- 重命名企业应用程序项目和/或 Web 项目,使其具有较短的名称。
- 减小 Web 应用程序中 JSP 页的文件夹深度。例如,将 JSP 页移动到公共文件夹中或者移动到 Web Content 文件夹的根目录中,而不是进一步向下嵌套它们。
如果正在 Internet Explorer 中使用代理或 socks 服务器,则应该对本地地址禁用它。否则,在使用内部 Web 浏览器或者安装的 Microsoft Internet Explorer 版本来尝试查看“通用测试客户机”或任何其它 Web 应用程序时,可能会导致问题。
随 Apache Tomcat 交付的缺省 web.xml 文件包含对因特网上的 DTD 文件的引用。正因为如此,与因特网断开连接后,Tomcat 服务器不能启动。在 WebSphere Studio 中,已从 Tomcat V3.2 配置中除去这些引用,因此在单机运行时也可以工作。如果从 WebSphere Studio 外部导入 Tomcat 服务器配置,或者使用的是 Tomcat V4.0,则在与因特网断开连接时工作可能会遇到问题。如果发生这种情况,请采取下列步骤来除去此引用。
如果启动服务器时有问题,则可能需要连接至因特网并使用备份的 web.xml 文件重新添加 DOCTYPE 元素。
- 从 Tomcat 服务器配置中备份 web.xml 文件。
- 使用文本编辑器编辑 Tomcat 服务器配置中的 web.xml 文件。
- 从文件中除去整个 DOCTYPE 元素。
- 保存并关闭编辑器。
当对服务器启用安全性时,不要使它的服务器标识与安装 WebSphere Application Server 的机器的名称相同。否则,WebSphere Application Server 可能无法启动。
服务器用户标识的“用户权利”策略还必须为用户授予充当操作系统的一部分的特权。
WebSphere Application Server 有一个限制,使用 WebSphere 客户机连接至在 WebSphere 服务器上运行的企业 bean 的所有 Java 应用程序都必须使用用来构建 WebSphere 客户机的同一个 IBM Java ORB 级别。如果不使用同一个 ORB 级别,则在运行客户机应用程序时可能会接收到类似如下的错误:
java.lang.NoClassDefFoundError: com/ibm/rmi/iiop/GIOPVersionException
要确保使用了正确的 ORB 级别,可以使用 WebSphere JRE 来运行客户机应用程序。为此,执行下列步骤:
- 在“调试”透视图中使用“运行”>“运行”或者使用“运行”>“调试”菜单项来打开“启动配置”对话框。
- 选择想要编辑的“Java 应用程序启动配置”。
- 转至 JRE 页面,并从组合框中选择适当的 WebSphere JRE。
- 应用更改。
另外,只要确保使用了相匹配的 ORB 级别,就可以使用任何 JRE 来运行客户机应用程序。为此,执行下列步骤:
- 在“调试”透视图中使用“运行”>“运行”或者使用“运行”>“调试”菜单项来打开“启动配置”对话框。
- 选择想要编辑的“Java 应用程序启动配置”。
- 转至“自变量”页面,将以下内容添加至“VM 自变量”字段:
-Xbootclasspath/p:WAS_installdir\java\jre\lib\ext\ibmorb.jar
其中,WAS_installdir 是包含运行时的目录,例如,c:\Program Files\IBM\WebSphere Studio\runtimes\aes_v4- 应用更改。
当启用了安全性时,不能直接从工作台中启动 WebSphere V4 管理客户机。要启动管理客户机,遵循下列步骤:
- 启动 WebSphere 服务器。
- 打开 Web 浏览器,并输入以下 URL:http://[localhost:8080]/admin,其中 [localhost:8080] 是您正在使用的服务器的名称和端口。
- 输入用来配置安全性的用户标识和密码。单击“提交”。
- 在右窗格中,单击配置 > 打开。
- 选择“输入服务器上的文件的全路径”。
- 在文本字段中输入至服务器配置的全路径。例如:C:\studio\eclipse\workspace\Servers\was.wsc\server-cfg.xml。
- 单击“确定”。
WebSphere V4 测试环境基于 WebSphere V4.06。WebSphere V5 测试环境基于 WebSphere V5.02。当从 WebSphere Studio 的先前版本迁移时,将除去对该 WebSphere 测试环境的任何电子修订,因此必须重新手工安装它们。
使用“通用测试客户机”时,您将不能在参数页面中构造将接口用作参数的对象。要根据具有接口类型的参数构造的所有对象都必须使用类引用部分。
首先装入并构造接口或抽象类型的对象。然后装入包含类型为抽象/接口的构造函数的类。现在,在参数页面中选择预先建立的对象。
如果已经将项目发布到 Windows 上的远程 V5 服务器,然后将该项目重命名为名称相同但是大小写不同,例如,将“MyEarProject”重命名为“myearproject”,则在服务器启动期间可能就会产生一些文件不存在错误。这是 Windows 的一种局限性,即,WebSphere Studio 不能区分名称相同但是大小写不同的两个已发布的项目。可以通过从远程机器中除去已发布的服务器配置,然后重新发布项目来解决此问题。
从 WebSphere Studio V4.0 中就已经更改了“通用测试客户机”的缺省 JNDI 提供程序 URL。新的提供程序 URL 为“iiop://2809”而不是“iiop://900”。如果您正在手工启动测试客户机并且需要旧的端口号(例如,为了访问 WebSphere v4.0),则可以通过测试客户机中的“属性”页面来更改提供程序 URL。
当尝试从正在远程机器上运行的 J2EE 客户机来访问测试环境服务器时,可能会产生 org.omg.CORBA.COMM_FAILURE。必须配置在远程服务器配置中定义的 ORB 引导程序主机名才能修正该问题。要编辑 ORB 引导程序主机名,转至服务器编辑器的端口页面,并将 ORB 引导程序端口部分中的主机名字段设置为远程主机名。
在进行更改之后,保存更改,再重新启动测试环境服务器以使更改生效。
如果对 WebSphere V4.0 禁用跟踪,则在控制台中将产生 ConnectionException,并且将无法正确停止服务器。
卸载 WebSphere V4 运行时时,目录 WS_installdir/runtimes/aes_v4 在卸载之后可能仍然存在。如果该目录仍存在,则必须手工除去它;否则,在 WebSphere V4 服务器支持方面可能会产生某些问题。如果卸载了 WebSphere Studio,然后又在同一位置再次安装它,则需要手工进行同样的检查。
当应用 WebSphere V4 PTF 时,您可能会看到这样一条消息:“注意:一旦启动了服务器,请重新生成插件配置,以便更新 plugin-cfg.xml 文件”。可以安全地忽略此消息。
当使用 WebSphere Studio 中的“WebSphere V5 管理控制台”来添加数据源或创建服务器时,您可能会接收到 NullPointerException 或其它错误。使用下列变通方法之一:
- 如果您正在创建数据源,则使用 WebSphere V5 服务器编辑器。可以通过在“服务器”或“服务器配置”视图中双击 WebSphere V5 服务器来打开编辑器。转至“数据源”页面,以便从服务器中添加、编辑或除去数据源。
- 停止服务器。
- 将模板目录从以下目录(其中 WS_installdir 是 WebSphere Studio 的安装目录):
WS_installdir\runtimes\base_v5\config\templates
复制到以下文件夹中的当前工作空间中:
workspace_ dir\server_ project\server_ name.wsc 文件夹- 重新启动服务器,然后再试。
服务器与它的服务器配置之间的关联包括服务器配置所驻留的项目。当您重命名服务器项目或者将服务器配置移至另一个项目时,使用这些配置的任何服务器都将使它们的关联断开。要解决该问题,在“服务器”视图中,右键单击该服务器,并选择切换配置 > 服务器配置名称以便使配置与服务器重新关联起来。
WebSphere 服务器编辑器的“环境”页面上的“路径选项”功能不起作用。将把在 Java 库路径字段中输入的路径添加到现有服务器 PATH 中。您将不能控制将数据添加到何处,例如,是将数据添加到现有服务器 PATH 的开头、末尾还是替换现有服务器 PATH。
在『设置服务器以使用嵌入式消息传递』这一主题中,『测试环境』一节中某些部分的内容适用于『远程服务器』一节中的指示信息。必须在本地或远程服务器配置中定义下列各项:WAS_PUBSUB_ROOT、MQ_INSTALL_ROOT 和服务器端的“队列”管理器。另外,还需要在服务器配置的 ws.ext.dirs 部分具有一个条目指向安装了 WebSphere MQ 的 java/lib 目录。
可以在此主题的测试环境部分找到有关设置“队列”管理器的指示信息。在独立的 WebSphere Application Server 机器中的相对于 WebSphere Application Server 安装根目录的同一目录中存在相同的 createmq 批处理文件。如果您将服务器从 WebSphere Studio 中远程部署到远程 WebSphere Application Server 机器上,则将需要执行此步骤。
注意:如果已经使用 WebSphere Studio 安装程序安装了“嵌入式消息传递”,则不需要运行 createmq.bat,也不需要设置 variables.xml 或者创建批处理文件就可以启动工作台,从而确保 MQ 二进制文件在 WAS 服务器路径上。您将还需要在服务器上对 ws.ext.dirs 执行添加操作。仅当您使用 WebSphere Application Server 安装程序安装了“嵌入式消息传递”时才需要执行此任务。
在启动 WebSphere V5.0 测试环境期间,您可能会在“控制台”视图中看到一条消息,指出“只安装了嵌入式消息传递客户机”,尽管“嵌入式消息传递”(它是一个可选组件)未作为 WebSphere Studio 安装的一部分来安装。可以安全地忽略此消息,并且并不是意味着已经安装了“嵌入式消息传递”,而是为生成此令人容易误解的消息的测试服务器定义了某些服务器配置变量。
要安装 Cloudscape 5.1,在 Windows 上运行 installCloudscape51.bat 文件,在 Linux 上则运行 Cloudscape51.sh 文件。此文件位于 WS_installdir/runtimes/base_v5/cloudscape51 目录中(其中 WSinstalldir 是 WebSphere Studio 的安装目录)。安装程序将启动特定于 WebSphere 的 Cloudscape 安装程序。当提示您输入目录名时,浏览至 WS_installdir/runtimes/base_v5 目录,或者直接输入该目录。
注意:安装 Cloudscape 5.1 之后,不能运行或具有 Cloudscape 5.0 定义的任何数据源。如果想运行 Cloudscape 5.0,则必须首先卸载 Cloudscape 5.1,然后除去 Cloudscape 5.1 数据源或者将它们更改为 Cloudscape 5.0 数据源。
当将 WebSphere 服务器重新发布到 AIX 机器时,可能会在发布对话框中出现有关无法删除某些文件的一些警告消息。可以安全地忽略这些警告消息。
仅当在 WebSphere V5 测试环境中进行调试时,才支持全速调试和热方法替换。在 WebSphere V5 测试环境外调试应用程序不受支持。
WebSphere MQ 组件不支持交叉版本兼容性。应该确保要使用的 WebSphere MQ 版本与要部署到的 WebSphere 测试环境或 WebSphere 服务器处于相同的修订包级别。
例如,不应该将 WebSphere Studio V5.0 安装的 WebSphere MQ 与 WebSphere V5.0.2 测试环境配合使用。相反,应该卸载 WebSphere MQ 并安装随 WebSphere Studio V5.1 一起交付的版本。
在移至更高的发行版时,在包含被部署到 WebSphere 测试环境或 WebSphere 服务器的连接器项目的 WebSphere Studio V5.0 中创建的工作空间不会被自动迁移。尝试将连接器项目发布到服务器时,可能会收到错误。
要解决该问题,在“服务器”视图中,右键单击该服务器并选择添加或除去项目。从服务器中除去 EAR 项目,然后将又将它添加回来。这将修正 WebSphere 服务器配置,以便正确部署连接器项目。
当使用以反斜杠开始的工作空间路径时,WebSphere 服务器可能不能启动。将导致该问题的工作空间路径的一些示例有:
\workspaceA\my_workspaces\work1以驱动器盘符开始的工作空间路径或不以反斜杠开始的工作空间路径不会导致此问题。如果已使用以反斜杠开始的工作空间启动 WebSphere Studio,则遵循下列步骤以允许 WebSphere 服务器启动:
- 关闭 WebSphere Studio。
- 重新启动 WebSphere Studio(如果先前选择了在启动时隐藏工作空间选择对话框,则使用 -setworkspace 标志)。
- 当提示输入工作空间位置时,将驱动器盘符添加至工作空间路径的开头。例如,\workspace1 将变为 c:\workspace1。
- 现在可以启动现有的 WebSphere 服务器。
如果打开 V5 服务器编辑器,在不退出该编辑器的情况下创建和保存新的“JAAS 认证条目”,然后转至“数据源”选项卡并添加 V5 数据源,则会出现一个文件已更改对话框。必须单击否才能避免毁坏服务器配置。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.