Skip to content
This repository
README.md

SNOWDROP

Snowdrop is a utility package that contains JBoss-specific extensions to the Spring Framework. These extensions are either:

  1. 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.
  2. Extensions for deploying and running Spring applications with the JBoss Enterprise Application Platform.

Usage/Setup:

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.

Supported Version:

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.0

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.

Build:

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

Install snowdrop:

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:

  1. For JBoss AS 7.1(or older) or EAP 6.0.x(or older).

    1. Extract the subsystem-as7/subsystem-as7/target/jboss-spring-deployer-as7.zip into the $JBOSS_HOME directory.
    2. Extract the subsystem-as7/modules/spring-x.x/target/spring-x.x-module.zip into the $JBOSS_HOME/modules directory.
  2. For JBoss AS 7.2(or newer) or EAP 6.1.x(or newer).

    1. Extract the subsystem-as7/subsystem-as7/target/jboss-spring-deployer-as7.2.zip into the $JBOSS_HOME directory.
    2. 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

Uninstall snowdrop:

  1. For JBoss AS 7.1(or older) or EAP 6.0.x(or older).

    1. Delete the $JBOSS_HOME/modules/org/jboss/snowdrop directory.
    2. Delete the $JBOSS_HOME/modules/org/springframework directory.
  2. For JBoss AS 7.2(or newer) or EAP 6.1.x(or newer).

    1. Delete the $JBOSS_HOME/modules/system/add-ons/snowdrop directory.
  3. Delete $JBOSS_HOME/standalone/standalone-snowdrop.xml.

Something went wrong with that request. Please try again.