Express (Distributed operating systems), v8.0 > Troubleshoot and support > Analyzing application server Java system dumps with the IBM Monitoring and Diagnostic Tools for Java - Dump Analyzer


Run the Dump Analyzer tool outside ISA

There may be some circumstances in which it is useful to be able to run the analyzer outside the ISA environment; for instance if the analysis needs to be incorporated into some existing problem handling workflow.

First locate the jar files containing the analyzer and its dependencies. These can be found by reference to the directory in which ISA installs tools plugins (installDir). On Windows this is found under Documents and Settings/ <user ID>/IBM/ISAv4/applications/eclipse/plugins. On Linux it is under the user home directory and again in IBM/ISAv4/applications/eclipse/plugins.

There are six .jar files as follows

If we have installed extensions to the Dump Analyzer tool (for example the WebSphere Application Server modules), you may need to add additional jar files provided by these extensions. Refer to the documentation for each extension for further information about the jar files that they provide.

These jar files can be copied to other platforms and executed there or can be executed on the platform where ISA is installed. If we assume that the current directory is (installDir)/plugins/com.ibm.java.diagnostics.dbda.isa_(version number) then the java invocation on Windows is 

 set CP="dumpAnalyzer.jar;coreAnalyzers.jar"
set BCP="lib/j9/dtfj.jar;lib/j9/dtfj-interface.jar;lib/sov/dtfjsu.jar;lib/sov/dtfj.jar"
java -cp $CP -Xbootclasspath/p:$BCP
        com.ibm.dtfj.analyzer.base.DumpAnalyzer (dumpName) (options)

Where the dump name should be the name of either a dump which has been processed by jextract (typically *.dmp.zip or *.sdff) or a directory which contains dump files. If a directory is given then the analyzer will analyze all the dumps in the directory. The output will be directed to the primary output stream and can then be further redirected using normal operating system mechanisms.

Note that the above invocation ensures that the analyzer will use the latest versions of the DTFJ libraries.


Analysis options

The analyzer allows some options to control the analysis or output format. Typically the options are specified as -[option]:[parameter(s)]

-help

Produces help information for the dump analyzer itself and for any analyzers specified.

-level:[number]

Control the analysis level where higher numbers generally do more analysis and produce more output. At present the range is from 0 to 3.

-head

Generate a standard header on the output. The header will give the dump name and primary platform characteristics. The default analysis script does this automatically but this option can be useful if another analyzer is requested.

-tail

Generate a standard trailer on the output. The trailer will list the analyzers which have been run and summarize the analysis time. The default analysis script does this automatically but this option can be useful if another analyzer is requested.

-debugLevel:[number]

Control the amount of debug information written to the log. Numbers in the range 0 to 4 produce increasing levels of debug information.

-list

Produces a list of the standard analyzers and gives help information for each of them. Any other options starting with '-' are silently ignored at present. Any options which do not start with '-' are assumed to be the names of analysis modules to be run.

© Copyright IBM Corp. 2007, 2008 All duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

+

Search Tips   |   Advanced Search