How to trace Rational Application Developer for WebSphere Software

Technote (FAQ)


Question

How do you enable tracing to capture more information about a product failure in IBM Rational Application Developer for WebSphere Software?

Cause

Tracing within Rational Application Developer is done at a plug-in level when the -debug command-line argument is specified and a .options file is created to instruct the product which plug-in tracing to enable.

Answer

This document describes how to enable this tracing framework so that the output can be easily captured and provided to the IBM support team for diagnosis.

Rational Application Developer 9.0
Rational Application Developer 8.5
Rational Application Developer 8.0
Rational Application Developer 7.5
Rational Application Developer 9.0

Procedure:

  1. Ensure that the product is stopped.

  2. Create a .options file containing the necessary plug-in tracing options as instructed by IBM support. Save this file into the product installation directory (i.e. <install>/SDP90/).

  3. Start the product using the following command from command-line and in the product installation directory:

    Linux

    ./jdk/jre/bin/java -Xquickstart -Xms100m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx96m -Xshareclasses:name=IBMSDP_%u -XX:MaxPermSize=512M -Dcom.ibm.ws.management.event.max_polling_interval=1000 -Dosgi.bundlefile.limit=100 -cp plugins/org.eclipse.equinox.launcher_1.3.0.v20120522-1813.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v9.ide > trace.txt 2>&1

    Note: The exact path to the launcher JAR file (org.eclipse.equinox.launcher_*.jar) may change in various fixpack releases of the product. When launching this command ensure that the latest org.eclipse.equinox.launcher plug-in version is added to the classpath argument.

    Windows

    eclipsec.exe -product com.ibm.rational.rad.product.v9.ide -debug > trace.txt 2>&1

  4. The command in step (3) will start Rational Application Developer v9.0 allowing the problem to be reproduced. The plug-in tracing information will be captured into the <install>/SDP90/trace.txt file which can be provided to IBM support (via ESR or by FTP) to further diagnose the problem.
Rational Application Developer 8.5

Procedure:

  1. Ensure that the product is stopped.

  2. Create a .options file containing the necessary plug-in tracing options as instructed by IBM support. Save this file into the product installation directory (i.e. <install>/SDP85/).

  3. Start the product using the following command from command-line and in the product installation directory:

    Linux

    ./jdk/jre/bin/java -Xquickstart -Xms100m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx48m -Xshareclasses:name=IBMSDP_%u -XX:MaxPermSize=128M -Dcom.ibm.ws.management.event.max_polling_interval=1000 -Djava.util.Arrays.useLegacyMergeSort=true -Dosgi.requiredJavaVersion=1.5 -Dosgi.bundlefile.limit=100 -cp plugins/org.eclipse.equinox.launcher_1.1.1.R36x_v20101122_1400.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v85.ide > trace.txt 2>&1

    Note: The exact path to the launcher JAR file (org.eclipse.equinox.launcher_*.jar) may change in various fixpack releases of the product. When launching this command ensure that the latest org.eclipse.equinox.launcher plug-in version is added to the classpath argument.

    Windows

    eclipsec.exe -product com.ibm.rational.rad.product.v85.ide -debug > trace.txt 2>&1

  4. The command in step (3) will start Rational Application Developer v8.5 allowing the problem to be reproduced. The plug-in tracing information will be captured into the <install>/SDP85/trace.txt file which can be provided to IBM support (via ESR or by FTP) to further diagnose the problem.
Rational Application Developer 8.0

Procedure:

  1. Ensure that the product is stopped.

  2. Create a .options file containing the necessary plug-in tracing options as instructed by IBM support. Save this file into the product installation directory (i.e. <install>/SDP80/).

  3. Start the product using the following command from command-line and in the product installation directory:

    Linux

    ./jdk/jre/bin/java -Xquickstart -Xms100m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx48m -Xshareclasses:name=IBMSDP_%u -XX:MaxPermSize=128M -Xverify:none -Declipse.p2.verifyPlan=false -Dcom.ibm.ws.management.event.max_polling_interval=1000 -Dosgi.requiredJavaVersion=1.5 -Dosgi.bundlefile.limit=100 -cp plugins/org.eclipse.equinox.launcher_1.1.1.R36x_v20101122_1400.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v80.ide > trace.txt 2>&1

    Note: The exact path to the launcher JAR file (org.eclipse.equinox.launcher_*.jar) may change in various fixpack releases of the product. When launching this command ensure that the latest plug-in version is added to the classpath argument.

    Windows

    eclipsec.exe -product com.ibm.rational.rad.product.v80.ide -debug > trace.txt 2>&1

  4. The command in step (3) will start Rational Application Developer v8.0 allowing the problem to be reproduced. The plug-in tracing information will be captured into the <install>/SDP80/trace.txt file which can be provided to IBM support (via ESR or by FTP) to further diagnose the problem.
Rational Application Developer 7.5

Procedure:

  1. Ensure that the product is stopped.

  2. Create a .options file containing the necessary plug-in tracing options as instructed by IBM support. Save this file into the product installation directory (i.e. <install>/SDP75/).

  3. Start the product using the following command from command-line and in the product installation directory:

    Linux

    ./jdk/jre/bin/java -Xquickstart -Xms40m -Xmx1024m -Xmnx64m -Xgcpolicy:gencon -Xscmx96m -XX:MaxPermSize=128M -cp plugins/org.eclipse.equinox.launcher_1.0.100.v20080509-1800.jar org.eclipse.equinox.launcher.Main -debug -product com.ibm.rational.rad.product.v75.ide > trace.txt 2>&1

    Note: The exact path to the launcher JAR file (org.eclipse.equinox.launcher_*.jar) may change in various fixpack releases of the product. When launching this command ensure that the latest plug-in version is added to the classpath argument.

    Windows

    eclipsec.exe -product com.ibm.rational.rad.product.v75.ide -debug > trace.txt 2>&1

  4. The command in step (3) will start Rational Application Developer v7.5 allowing the problem to be reproduced. The plug-in tracing information will be captured into the <install>/SDP75/trace.txt file which can be provided to IBM support (via ESR or by FTP) to further diagnose the problem.

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Application Developer for WebSphere Software
General Information

Software version:

7.5, 7.5.1, 7.5.2, 7.5.3, 7.5.4, 7.5.5, 7.5.5.1, 7.5.5.2, 7.5.5.3, 7.5.5.4, 7.5.5.5, 8.0, 8.0.1, 8.0.2, 8.0.3, 8.0.4, 8.0.4.1, 8.0.4.2, 8.5, 8.5.1, 8.5.5, 9.0

Operating system(s):

Linux, Windows

Reference #:

1327307

Modified date:

2013-10-15

Translate my page

Machine Translation

Content navigation