Instructions for Throwable Instrumentation

Simplified Instructions:   (For more detailed instructions see below...)

Obtain the tool files:  Throwable.jar and throwableServlets.jar.  Also select exceptions35.txt or exceptions40.txt based on the version of WAS.
copy Throwable.jar to <was_install>/classes.
unjar throwableServlets.jar to <was_install>/classes
copy exceptions<35|40>.txt to <was_install>/properties/exceptions.txt   (yes, this file must be renamed to exceptions.txt).

For the AdminServer:
I . Update admin.config to make Throwable.jar part of the JVM bootclasspath for the AdminServer as follows: Edit <was_install>/bin/admin.config. Locate the line containing adminServerJvmArgs and update it so that the text immediately after the "=" is :    -Xbootclasspath:<was_install>/classes/Throwable.jar
e.g.   com.ibm.ejs.sm.util.process.Nanny.adminServerJvmArgs=-Xbootclasspath/p:c:/WebSphere/AppServer/classes/Throwable.jar -Xmx....
Note: for Windows NT/2000 running WebSphere 3.x do not use the above syntax because java does not support -Xbootclasspath/p.  Instead use: com.ibm.ejs.sm.util.process.Nanny.adminServerJvmArgs=-Xbootclasspath:c:/WebSphere/AppServer/classes/Throwable.jar;c:/WebSphere/AppServer/jdk/jre/lib/rt.jar -Xmx...

II. Update admin.config to add 3 more startup properties to the admin server as follows: Edit <was_install>/bin/admin.config.
Locate the line containing adminServerJvmArgs and update it so that it ends with: -DenableExceptionTrace=exclude -DenableExceptionTraceDelay -DexceptionsFile=<was_install>/properties/exceptions.txt
e.g.  com.ibm.ejs.sm.util.process.Nanny.adminServerJvmArgs=-Xbootclasspath.... -Xmx...    -D..... -D.....  -DenableExceptionTrace=exclude -DenableExceptionTraceDelay=90 -DexceptionsFile=c:/WebSphere/AppServer/properties/exceptions.txt

For the ApplicationServer:
Note the same JVM properties that are applied to the AdminServer are to be applied to each application server.  The difference is that the JVM arguments for the application server are updated using the AdminConsole.
Locate the Application Server property page for each application server using the AdminConsole and update the JVM arguments to start with the following: -Xbootclasspath...<was_install>/classes/Throwable.jar.... (follow the same rules as above for bootclasspath differences between JVM that support the bootclasspath/p and those that do not).  Finally, the JVM arguments must end with:
-DenableExceptionTrace=exclude -DenableExceptionTraceDelay -DexceptionsFile=<was_install>/properties/exceptions.txt

Restart the AdminServer and Application Servers for the changes to take effect.

* * * * * * * * End simplified instructions * * * * * * * * * * * *
 
 

OPTIONAL DETAILED INSTRUCTION






(ii) Notation used