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:
-
Back up the existing jboss-40-install/jboss-aop-jdk50.deployer to
server/<config-name>/deploy/jboss-aop-jdk50.deployer.bak
-
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
-
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
-
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:
-
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
-
Copy the files from jboss-40-install/jboss-aop-jdk14.deployer to
server/<config-name>/deploy/jboss-aop-jdk50.deployer
-
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
-
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
-
In JBoss 4.0.4.GA and later, move client/jbossretro-rt.jar
to client/jbossretro-rt.bak.
-
In JBoss 4.0.4.GA and later, move client/javassist.jar
to client/javassist.bak.
-
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