These instructions explain how to get the source code for Roller from Roller's Subversion repository, import it in to Eclipse and run it via an Eclipse launcher that starts Jetty and Derby.

Prerequisites

These instructions assume you have these things already installed on your computer:

• Sun Java SE 1.6
• Subclipse Subversion client for Eclipse
• M2Eclipse Maven client for Eclipse

Checkout code from Subversion

Use the File->Import menu in Eclipse to start the Import, then choose the Checkout Projects from SVN option

Choose the create new repository option

Enter the URI of the Roller trunk, which is https://svn.apache.org/repos/asf/roller/trunk

Select the top-level element in the source tree

Choose the Checkout as New Project in the work space:

Once you are done you should see the top-level Roller project in Eclipse

Import Maven projects

Use the File->Import menu again, and choose to Import Existing Maven Projects

Select all of the projects under the top-level one

When you are done, you'll see all of the Roller projects in Eclipse

Building and running Roller

The Maven plugin in Eclipse will automatically build Roller for you. The plugin can also run Roller for you and will start both the Jetty web service and the Derby database for Roller.

To start Roller, use Eclipse's Run->Run Configurations to create a launcher for Roller. Create a new launcher under Maven Build, set these fields:

• Base directory:

  ${workplace_loc:/roller-weblogger-webapp}

• Goals: jetty:run

Then you can use the Run button to start Roller.

Navigate to http://localhost:8080/roller and you'll find Roller up and running.