Install (or check that you already have it installed) the following software:
Obviously, JDK has to be installed. Cayenne 3.0 requires JDK 1.5 or newer.
Download Eclipse from here. This tutorial is based on the Galileo package (Eclipse 3.5), JEE edition, still it should work any recent vanilla Eclipse distribution.
After downloading Eclipse, unpack it somewhere in the filesystem, and start it. The only plugin that you need for the tutorial is m2eclipse. To install it, in Eclipse go to "Help > Install New Software", then click on "Add.." to add a new download site, and enter "Maven" in the "Name" field, and "http://m2eclipse.sonatype.org/update/" in the "Location" field. You may install any of the optional components that you think you need, but for this tutorial we only select a few basic components as shown on the following screenshot:
Follow the Eclipse dialog instructions to finish the installation.
While we'll be using Maven to include Cayenne runtime jars in the tutorial project, you'll still need to download Cayenne to get access to CayenneModeler tool. Select an appropriate . Unpack the distribution somewhere in the file system.
Start Eclipse and go to "File > New > Project". Select a "Java Project" for the project type and click "Next":
Enter "cayenne-tutorial" for the project name, select "Create separate source and output folders" radio button and click "Next":
On the next screen ("Java Settings") go to the "Libraries" tab and click "Add External Jar" button on the right to add two Jar files:
When done click "Finish" and the new project should appear in Eclipse.
Next Step: Tutorial Starting Mapping Project