当独立客户机应用程序(例如访问 WebSphere® Application Server 中主管的企业 bean 的 Java™ 应用程序)与 WebSphere Application Server 的互操作发生问题时,启用应用程序的跟踪可能有用。启用客户机程序的跟踪将导致那些应用程序使用的 WebSphere Application Server 类(例如命名服务客户机类)生成跟踪信息。
关于此任务
常用的故障诊断技术是在应用程序服务器和客户机应用程序上都启用跟踪,并根据时间戳记匹配记录以尝试推定发生问题的地方。
还可使用 modify 命令从 MVS™ 控制台配置跟踪。
过程
- 要启用客户机应用程序中 WebSphere Application Server 类的跟踪,请将下列示例中显示的系统属性添加到客户机应用程序的启动脚本或命令。跟踪中包括的输出位置、类以及详细信息遵照将跟踪添加到 WebSphere Application Server 的相同的规则。例如,要跟踪名为 com.ibm.sample.MyClientProgram 的独立客户机应用程序,请输入以下命令:
java -DtraceSettingsFile=MyTraceSettings.properties
-Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager
-Djava.util.logging.configureByServer=true com.ibm.samples.MyClientProgram
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
file name 标识的文件必须是放入应用程序客户机或独立进程的类路径中的属性文件中。必须通过将 %install_root\properties\TraceSettings.properties 文件复制到客户机应用程序 Java 归档 (JAR) 文件所在的目录来创建跟踪属性文件。
file name 标识的文件必须是放入应用程序客户机或独立进程的类路径中的属性文件中。必须通过将 app_server_root/properties/TraceSettings.properties 文件复制到客户机应用程序 Java 归档 (JAR) 文件所在的目录来创建跟踪属性文件。
您不能使用 -DtraceSettingsFile=TraceSettings.properties 属性为瘦客户机启用 ORB 组件的跟踪。通过在命令行中设置 com.ibm.CORBA.Debug.Output
= debugOutputFilename 参数,可以定向瘦客户机的 ORB 跟踪输出。
java.util.logging.manager
和 java.util.logging.configureByServer 系统属性配置 Java 日志记录以使用特定于 WebSphere Application Server 的 LogManager
类以及使用由 traceSettingsFile 属性指定的文件中的配置。将不会应用位于 Java SE 运行时环境 6 (JRE6) 中的缺省 Java 日志记录属性文件。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
您可配置 MyTraceSettings.properties 文件,以使用 traceFileName 属性发送跟踪输出到文件。指定两个选项之一: - 输出文件的标准名称。例如,traceFileName=c:\\MyTraceFile.log。
您必须指定此属性,以生成可视输出。
- stdout。
当指定时,输出写为 System.out。
- 还可以使用跟踪字符串属性来指定用于写消息的跟踪字符串,指定类似于服务器上的启动跟踪指定的启动跟踪指定。 为了方便起见,您可将多个个别跟踪字符串输入跟踪设置文件,每行一个跟踪字符。
结果
此处是使用每个可选属性设置的结果:
- 为不带有跟踪字符串的 traceFileName 属性指定有效设置,以将消息写入指定的文件或仅写入 System.out。
- 指定跟踪字符串不带有 traceFileName 属性值,以不生成输出。
- 指定有效的 traceFileName 属性和跟踪字符串,以将消息和跟踪条目写入 traceFileName 字段中指定的位置。