Chapter 9. Installing

This section defines how to install JBoss AOP standalone, within JBoss 4.0.x, JBoss 4.2.x and within JBoss 5.x

9.1. Installing Standalone

There's nothing really to install if you're running outside the JBoss application server. If you are using JDK 1.4.x, use the libraries under the lib-14/ directory to build your JBoss AOP applications. If you're using JDK 5.0, use the libraries under lib-50/.

9.2. Installing with JBoss 4.0.x amd JBoss 4.2.x Application Server for JDK 5

To install JBoss AOP in JBoss 4.0.x or JBoss 4.2.x Application Server: with JDK 5, there is an ant build script to install into the application server. It lives in jboss-40-install/jboss-aop-jdk50.deployer/build.xml. Modify jboss-40-install/jboss-aop-jdk50.deployer/jboss.properties to point to the the root of your JBoss installation and specify the application server configuration you want to upgrade. These are the steps taken by the ant script:

  1. Back up the existing jboss-40-install/jboss-aop-jdk50.deployer to server/<config-name>/deploy/jboss-aop-jdk50.deployer.bak
  2. Copy the files from jboss-40-install/jboss-aop-jdk50.deployer over the files that already exist in your existing JBoss Application Server distribution under server/<config-name>/deploy/jboss-aop-jdk50.deployer
  3. In JBoss 4.0.4.GA and later, move server/<config-name>/deploy/jboss-aop-jdk50.deployer/javassist.jar to server/<config-name>/lib/javassist.jar. Any existing javassist.jar in that location is copied to server/<config-name>/deploy/jboss-aop-jdk50.deployer.bak/lib/javassist.bak
  4. If you NOT upgrading from a previous AOP 2 distribution, open up server/<config-name>/deploy/jboss-aop-jdk50.deployer/jboss-aspect-library-jdk50.jar and delete all classes and subpackages under org.jboss.aop. In AOP 2.0 we changed the packaging, these classes now exist inside server/<config-name>/deploy/jboss-aop-jdk50.deployer/jboss-aop-as4-deployer.jar. Also, we delete any files that also exist in server/<config-name>/deploy/jboss-aop-jdk50.deployer/jboss-standalone-aspect-library-jdk14.jar

9.3. Installing with JBoss 4.0.x Application Server for JDK 1.4

To install JBoss AOP in JBoss 4.0.x with JDK 1.4 (JBoss 4.2.x requires JDK 5), there is an ant build script to install into the application server. It lives in jboss-40-install/jboss-aop-jdk14.deployer/build.xml. Modify jboss-40-install/jboss-aop-jdk14.deployer/jboss.properties to point to the the root of your JBoss installation and specify the application server configuration you want to upgrade. These are the steps taken by the ant script:

  1. Back up the existing jboss-40-install/jboss-aop.deployer (if upgrading from AOP 1.x) or jboss-40-install/jboss-aop-jdk14.deployer (if upgrading from AOP 2.x) to server/<config-name>/deploy/jboss-aop.deployer.bak
  2. Copy the files from jboss-40-install/jboss-aop-jdk14.deployer to server/<config-name>/deploy/jboss-aop-jdk50.deployer
  3. In JBoss 4.0.4.GA and later, move server/<config-name>/deploy/jboss-aop-jdk50.deployer/javassist.jar to server/<config-name>/lib/javassist.jar. Any existing javassist.jar in that location is copied to server/<config-name>/deploy/jboss-aop-jdk50.deployer.bak/lib/javassist.bak
  4. In JBoss 4.0.4.GA and later, move server/<config-name>/deploy/jboss-aop-jdk50.deployer/jbossretro-rt.jar to server/<config-name>/lib/jbossretro-rt.jar. Any existing jbossretro-rt.jar in that location is copied to server/<config-name>/deploy/jboss-aop-jdk50.deployer.bak/lib/jbossretro-rt.bak
  5. In JBoss 4.0.4.GA and later, move client/jbossretro-rt.jar to client/jbossretro-rt.bak.
  6. In JBoss 4.0.4.GA and later, move client/javassist.jar to client/javassist.bak.
  7. If you NOT upgrading from a previous AOP 2 distribution, open up server/<config-name>/deploy/jboss-aop-jdk50.deployer/jboss-aspect-library-jdk50.jar and delete all classes and subpackages under org.jboss.aop. In AOP 2.0 we changed the packaging, these classes now exist inside server/<config-name>/deploy/jboss-aop-jdk50.deployer/jboss-aop-as4-deployer.jar. Also, we delete any files that also exist in server/<config-name>/deploy/jboss-aop-jdk50.deployer/jboss-standalone-aspect-library-jdk14.jar

9.4. Installing with JBoss Application Server 5

JBoss 5 is not released yet, this section will be modified when the packaging is finalised, but all you should need to do is copy the contents of the jboss-50-install/lib directory into $JBOSS_ROOT/lib, and copy the contents of the jboss-50-install/jboss-aop-jboss5.deployer folder into $JBOSS_ROOT/server/<config-name>/deployers/jboss-aop-jboss5.deployer