You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 31 Next »

This guide explains how to get the Roller source code, build it with Maven, test it with Maven and run it via Maven, Jetty and Derby (recommended for development test purposes only). This build build applies to the current Roller trunk.

Roller 5.1 requires JDK 1.7 or newer; Roller 5.0.x should build with JDK 1.6.

Eclipse users, you might want to refer to this instead: Build and Run Roller 5 in Eclipse.

Get the Roller source code

There are two ways to get the source code, from the project's Subversion repository or from a source release. Here's how to get the Roller trunk (upcoming 5.1) code from Subversion:

   svn co http://svn.apache.org/repos/asf/roller/trunk roller_trunk

For the current (5.0.x) release branch:

   svn co http://svn.apache.org/viewvc/roller/branches/roller_5.0/ roller_50

Replace "http://" with "https://" in the above URLs if you are presently a Roller committer (i.e., have write access to Roller).

 

TBD: how to get and extract a source release

Build Roller Weblogger

Here's how to build Roller Weblogger (also runs the unit tests).

   cd roller_trunk 
   mvn clean install

Run Roller Weblogger for development testing

Here's how to run the Jetty servlet engine, Derby and Roller for development testing of Roller:

   cd roller_trunk/app
   mvn jetty:run

Then use your web browser to browse to http://localhost:8080/roller to test Roller. You will find the log files in roller_trunk/app/target/work. You can adjust logging levels via the Roller properties override file at roller_trunk/app/src/test/resources/roller-jettyrun.properties. Note the blog information stored during each mvn jetty:run session will be lost once you stop Jetty (i.e., each mvn jetty:run starts with empty Roller database tables), however deploying Roller this way allows for hot (real-time) deployment of your JSP and CSS/JavaScript to the running application.

Build a Roller Weblogger release package

After running mvn clean install from from roller_trunk, navigate to its assembly-release subfolder and run mvn clean install again.

Other resources

Check the Roller Install guide for deployment information on Tomcat, GlassFish, or JBoss. Unlike mvn jetty:run above, these deployments will persist data to non-temporary databases so you don't have to start from scratch with each run.

The Roller team is also starting to use Selenium to automate in-browser testings (using just Firefox presently), mvn clean install from the Roller it-selenium folder will activate the Roller Selenium tests.

Check this page's child pages for development within IntelliJ IDEA and Eclipse, as well as how to do code tracing in IDEA while running Roller via mvn jetty:run.

  • No labels