As of release 0.7.2, RSF will be switching to Maven 2 for building of all framework JARs and sample applications, from its previous supported version of Maven 1.0.2. Typically this leads to faster builds and shorter dependency lists, as well as being more actively supported by the Apache community.

Most of the Maven 2 build process is completely automatic, except for the deployment of the samples to a webapp container. This requires a couple of properties to be set within your settings.xml file. This is operated by the RSF deployer plugin, which is a very tiny plugin which performs WAR deployment by a very simply file copy process. After experimentation with the Maven 2 Cargo deployer, it was found to be too poorly supported and stumbles over this simple use case.

The key properties required within settings.xml are appserver.id and appserver.home. These instructions are for use of a Tomcat version 5.x container - consult the Cargo documentation site for details of alternative containers. There are various ways of activating a "profile" in your settings.xml, these instructions are for a single profile which is always activated by default - consult the Maven documentation site for more information on settings.xml.

Here is a sample settings.xml which will enable you to build and deploy the sample apps by running mvn install rsf:deploy:

<settings xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <profiles>
    <profile>
      <id>tomcat5x</id>
      <activation>
        <activeByDefault>true</activeByDefault>
        </activation>
      <properties>
        <appserver.id>tomcat5x</appserver.id>
        <appserver.home>c:\opt\tomcat</appserver.home>
      </properties>
    </profile>
  </profiles>
</settings>

This file needs to be placed in your USER_HOME/.m2 directory. Please consult the main RSF container setup guide for more details.