Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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. (If you are wondering why we don't suggest using the "Check out Maven projects from SCM" option: it does not work. See this issue for MNGECLIPSE-2596 details.)

Image Added

Choose the Create new repository location option

Image Added

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

...

Image Added

Select the top-level

...

element

...

in

...

the

...

source

...

tree

Image Added

Choose the Checkout as project in the workspace option:

Image Added

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

Image Added

Import Maven projects

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

Image Added

Select all of the projects under the top-level one

Image Added

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

Image Added

Building and running Roller

To build all of the Roller code, right-click on the roller-project project, choose Run As and then choose Maven install. If you change anything in a project, you'll have run Maven Install on the project before you attempt Roller.

The Eclipse Maven plugin can also run Roller for you and will start both the Jetty web service and the Derby database for Roller. To run 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

...

Image Added

Then you can use the Run button to start Roller.

Navigate to http://localhost:8080/roller

...

and

...

you'll

...

find

...

Roller

...

up

...

and

...

running.