Snowdrop is a utility package that contains JBoss-specific extensions to the Spring Framework. These extensions are either:
- Extensions to Spring Framework classes that can be used wherever the generic implementations provided by the framework do not integrate correctly with JBoss Enterprise Application Platform.
- Extensions for deploying and running Spring applications with the JBoss Enterprise Application Platform.
Deployments can also be configured to exclude specific implicit dependencies. This is done with the jboss-deployment-structure.xml deployment descriptor file. This is commonly done when an application bundles a specific version of a library that the application server will attempt to add as an implicit dependency.
Snowdrop 3.x works with the following version of JBoss:
-
JBoss AS 7.1.0, 7.1.1, 7.1.2, 7.1.3
-
JBoss AS 7.2.0 - (This version of JBoss has a problem with Hibernate, specifically Hibernate 4.1.0.CR1)
-
JBoss EAP 6.0.0, 6.0.1, 6.1.0, 6.1.1, 6.2.x
NOTE: If you need to use JBoss AS 5/6 or EAP 5 then please use Snowdrop 2.1.1.Final (it is Tagged in this repo). That version still supports the older versions of JBoss.
NOTE: You don't need to build if you wish to use a released version of snowdrop, just continue from the Install section. It will use the libraries in Maven.
mvn clean install
Automatic: See the complete instructions here.
cd install
mvn package -DJBOSS_HOME=/path/to/jboss_home -P${desired-spring-version} -Dversion.snowdrop=${snowdrop.version}
Manual:
To install the Snowdrop Deployment subsystem:
-
For JBoss AS 7.1(or older) or EAP 6.0.x(or older).
-
Extract the
subsystem-as7/subsystem-as7/target/jboss-spring-deployer-as7.zip
into the$JBOSS_HOME
directory. -
Extract the
subsystem-as7/modules/spring-x.x/target/spring-x.x-module.zip
into the$JBOSS_HOME/modules
directory. -
For JBoss AS 7.2(or newer) or EAP 6.1.x(or newer).
-
Extract the
subsystem-as7/subsystem-as7/target/jboss-spring-deployer-as7.2.zip
into the$JBOSS_HOME
directory. -
Extract the
subsystem-as7/modules/spring-x.x/target/spring-x.x-module.zip
into the$JBOSS_HOME/modules/system
directory.
To use JBoss with Snowdrop run:
$JBOSS_HOME/bin/standalone.sh -c standalone-snowdrop.xml
-
For JBoss AS 7.1(or older) or EAP 6.0.x(or older).
-
Delete the
$JBOSS_HOME/modules/org/jboss/snowdrop
directory. -
Delete the
$JBOSS_HOME/modules/org/springframework
directory. -
For JBoss AS 7.2(or newer) or EAP 6.1.x(or newer).
-
Delete the
$JBOSS_HOME/modules/system/add-ons/snowdrop
directory. -
Delete
$JBOSS_HOME/standalone/standalone-snowdrop.xml
.