Question & Answer
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.
Procedure:
Procedure:
Procedure:
Procedure:
Rational Application Developer 9.1 | |
Rational Application Developer 9.0 | |
Rational Application Developer 8.5 | |
Rational Application Developer 8.0 |
Rational Application Developer 9.1 |
Procedure:
- Ensure that the product is stopped.
- 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>/SDP91/).
- Start the product using the following command from command line within 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.v91.ide > trace.txt 2>&1
Note: The exact path to the launcher JAR file (org.eclipse.equinox.launcher_*.jar) can change in various fix pack 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.v91.ide -debug > trace.txt 2>&1
- The command in step (3) will start Rational Application Developer v9.1, allowing the problem to be reproduced. The plug-in tracing information is captured into the <install>/SDP91/trace.txt file which can be provided to IBM® support (via ESR or by FTP) to further diagnose the problem.
Rational Application Developer 9.0 |
Procedure:
- Ensure that the product is stopped.
- 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/).
- Start the product using the following command from command line within 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) can change in various fix pack 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
- The command in step (3) will start Rational Application Developer v9.0, allowing the problem to be reproduced. The plug-in tracing information is 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:
- Ensure that the product is stopped.
- 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/).
- Start the product using the following command from command line within 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) can change in various fix pack 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
- The command in step (3) will start Rational Application Developer v8.5, allowing the problem to be reproduced. The plug-in tracing information is 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:
- Ensure that the product is stopped.
- 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/).
- Start the product using the following command from command line within 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) can change in various fix pack 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
- The command in step (3) will start Rational Application Developer v8.0, allowing the problem to be reproduced. The plug-in tracing information is 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.
[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSRTLW","label":"Rational Application Developer for WebSphere Software"},"ARM Category":[{"code":"a8m0z000000bm08AAA","label":"Rational Application Developer"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Version(s)"}]
Was this topic helpful?
Document Information
Modified date:
08 October 2020
UID
swg21327307