Web Agent Guides › Web Agent Option Pack Guide › Introduction › Web Agent Option Pack on JBOSS 5.1.2 Requires Workaround to Operate (152769)

Web Agent Option Pack on JBOSS 5.1.2 Requires Workaround to Operate (152769)

Symptom:

On a JBoss 5.1.2 server, system JARs are overriding application-specific JARs, such as those JARs for the Web Agent Option Pack.

Solution:

Prevent the Web Agent Option Pack XML API files from being overwritten by JBOSS system JARS.

Important! This workaround only applies to JBOSS 5.1.2 and higher.

Add the following filter package in two places in the war-deployers-jboss-beans.xml file:

<property name="filteredPackages">javax.servlet,org.apache.commons.
logging,javax.xml.parsers,org.xml.sax,org.w3c.dom,javax.xml.namespace</property>

The filter package allows the use of the Web Agent Option Pack XML API files instead of the JBOSS system files.

Follow these steps:

1. Locate the war-deployers-jboss-beans.xml file located in the following directory:

   /deployers/jbossweb.deployer/META-INF/
   

2. Find the following entry:

   <property name="filteredPackages">javax.servlet,org.apache.
   commons.logging</property> 
   

3. Change the entry to:

   <property name="filteredPackages">javax.servlet,org.apache.commons.
   logging,javax.xml.parsers,org.xml.sax,org.w3c.dom,javax.xml.namespace</property>
   

   This entry in the file is on one line.

4. Find the second instance of the entry in step 2 and replace it with the entry in step 3.

   Add the filter package in both places in the XML file.

5. Save the XML file.