Manual creation of aspect-enabled JAR files

IBMSupport Assistant Lite is the preferred way to create and deploy aspect-enabled JAR files for troubleshooting because the tool automates the process for you. If you do not want to install IBM Support Assistant Lite, or you are running on a platform that does not support IBM Support Assistant Lite, you can manually create own aspect-enabled JAR files using either the aspect source files that ship with IBM WebSphere Portal, or aspect source files provided by IBM Support.

  1. Set up AspectJ as follows:

    1. Download the latest version of AspectJ from the Eclipse Web site.

    2. To install AspectJ, run the command shown below: 

        java -jar aspect_enabled_jar_filename

  2. Make the following changes:

    1. Set the CLASSPATH environment variable to include Aspect-Home/aspectjrt.jar where Aspect-Home is the directory where you installed AspectJ.

    2. Set the PATH environment variable to include Aspect-Home/bin.

    3. Modify the AspectJ compiler batch file Aspect-Home/bin/ajc.bat to use -Xmx1500M instead of -XmX64M.

  3. To create an aspect-enabled JAR file, run the following command on a single line: 

      ajc -inpath /path/to/file.jar 
-sourceroots full path of directory that contains the aspect source file
-extdirs full path of directory that will contain the built JAR file 
-outjar aspect_enabled_jar_file
      Contact IBM Support for the values that specify for -inpath, -sourceroots, -extdirs, and -outjar.

  4. To implement an aspect-enabled JAR file:

    1. Go to the directory that contains the JAR file that you want to replace.

    2. Copy the JAR file to a backup location.

    3. Replace the specified JAR file with the aspect-enabled version.

  5. Restart the server.

  6. Set any necessary trace levels.

  7. Reproduce the problem that you want to troubleshoot.

  8. Collect the LOG files.

  9. Replace the aspect-enabled JAR file with the backup copy of the original JAR file.

  10. Reset the trace levels.

  11. Restart the server.


Parent

Tools for troubleshooting and diagnostics
Data collection and symptom analysis

Download the IBM Support Assistant Lite for Websphere Portal

Self-Help Central for WebSphere Portal

Eclipse AspectJ downloads site

 


+

Search Tips   |   Advanced Search