You probably want to install a current Java Development Kit from Sun/Oracle.Go to http://java.sun.com/javase/downloads/index.jsp. You will find that all the Maven project defaults tend to assume Java 5 and you have to make a few minor adjustments to use Java 6 instead. Follow the installation instructions. Remember the directory where it was installed.There is a
If you install the 64 bit version of Java for Windows, but this is generally just a runtime intended to support very large production application servers. For Eclipse and most software development the 32 bit version of the JDK is the right choice even on a 64 bit Windows desktop.You probably want to download the current release of Maven. Go to http://maven.apache.org/download.html and select the best version. [At the time this is written, the best version is 2.2.1] Remember the directory into which it was unpacked, install the 64 bit version of Eclipse. Otherwise, install the 32 bit version of both.
Download and install the latest version of Eclipse (3.6 SR1 or 3.6. 1). Go to http://www.eclipse.org/downloads/ and choose the Eclipse IDE for Java EE Developers. Again, even if you have a Windows 64 bit desktop you probably want to choose the 32 bit application installation.
Note: There is a bug in Eclipse 3.6.1 that puts Eclipse into a loop during Workspace initialization with a message "Initializing Java Tooling (1%)" on the bottom status line. If you experience this problem, download the patch files attached to Bug 327801.
When Maven runs under Eclipse, it wants to run in a full JDK with a complier instead of just a JRE. You can specify the version of java you want to run Eclipse under by editing the eclipse.ini text file in the eclipse install directory you just created. Add -vm on one line and then on the next line enter the path to the javaw.exe (windows) or java (linux) executable program you just installed. If you make this change before you run Eclipse for the first time, the version of Java you installed will be stored in the Eclipse table of java runtimes and will be the default for all applications, servers, and tools.
There were two popular Subversion plugins for Eclipse, Subclipse and Subversive. Subversive became a standard part of the Eclipse package, but it is not installed by default. You have to first install the core Subversive option, and then the first time you use SVN you will be prompted to install a system specific connector. The SVN Kit connector is 100% pure Java and available on all systems, while other Native connectors are written in C and are system specific.
- Start Eclipse
- Clear the introductory page
- Accept the default Workspace file path or choose a location for a new file
- Select Help - Install New Software from the menu
- In the "Work with:" box at the top, select "All Available Sites"
- The first time this runs, it takes a long time building a catalog from the internet. Wait for it.
- In the filter box, type "Subv" (first few letters of Subversion)
- Click the box next to "Subversive SVN Team Provider"
- [Choose any other optional tools you want]
- Click Next, Next, Accept, Finish, Restart Eclipse
- Click Window - Preferences to bring up the Eclipse configuration page
- Select Team, then SVN under Team
- This triggers the Subversive Connector Discovery panel.
- Select SVN Kit 1.3.2 (a pure Java connector that works on all systems)
- Click finish, then in the popup Next, Next, Accept, Finish, and OK (to the unsigned content popup), and OK to restart Eclipse
Now install the Maven plugin. To double check these instructions, you might want to visit http://m2eclipse.sonatype.org/installing-m2eclipse.html.
- Click Help - Install New Software on the menu
- Click the Add... button
- Name: Maven Location: [paste URL] http://m2eclipse.sonatype.org/sites/m2e
- OK, click Add... button again
- Name: Maven Extras, Location: [paste URL] http://m2eclipse.sonatype.org/sites/m2e-extras
- Now in Work With [top box] select All Available Sites
- Expand the two Maven sites just created
- Select "Maven Integration for Eclipse (Requred)" from the Maven core site
- Select "Maven Integration for WTP" from the Extras site
- Next, Accept, Finish, OK, Restart
Click Window - Preferences - Maven - Installations. The Maven plugin ships with an embedded version of Maven that is probably obsolete. Click the Add... button, navigate to the directory where you expanded the current (2.2.1) version of Maven that you downloaded from Apache, and click OK. This new External copy of Maven will now be selected and will be used by the Plugin. Click OK to close the configuration.
The version of Eclipse current at the time this was last updated is Luna. It comes with Maven support built in by default, but the support for Subversion is now an option because Git has become more popular. The "Subversive" project is part of Eclipse and can be installed from Help - Install New Software. Software from third parties can be installed with Help - Eclipse Marketplace.
At Yale, you should:
- After installing "Subversive" from New Software, the first time you try to use SVN (by opening the SVN Repository Exploring perspective), Eclipse will pop up a window asking you to select an interface library option. Choose the lastest version of SVNKit (a pure Java solution for communication with the SVN server) rather than using external command tools.
- Install the "JBoss Tools" for your release of Eclipse using Eclipse Marketplace. Make sure you select Tools and not Developer Studio, which is a complete replacement version of Eclipse.
- If you are using Tomcat too, install Mongrel to get Tool Bar icons to start and stop Tomcat.
- Optionally you might want to install the Spring Tool Suite for your release of Eclipse.
There are several configuration options that are best set immediately, before loading any projects. Go to Window - Preferences. In the Team area, select Ignored Resources. This exposes a list of file extensions and directory names of things you do not want to be checked into SVN. Click the Add Pattern... button and add "target", the name of the directory that Maven uses as a work area to collect the compiler output and generate the artifact. If you want to use Yale recommendations (at least for this workspace) that you only check in the Maven POM and not check in the Eclipse project files, then add the three Eclipse names ".project", ".classpath", and ".settings" (note that these names begin with a period but they are names not extensions so do not put a wildcard in front of them).
This is also a good time to go to Java - Installed JREs. Eclipse automatically adds whatever version of Java is the primary (generally the lastest) on this operating system. If you want to build for a different release (CAS is typically one release back from current) then after you have actually installed that version of Java on the machine add it to this list of Java versions Eclipse knows about and set the checkbox so it is the default.
An application is built with the latest version of Maven, but by convention at Yale the Installer project (that copies the application to JBoss or Tomcat using Ant) runs on an old Maven 2.2.1. To enable the same processing in the Sandbox, download that version of Maven, put it in some directory, and then in the Eclipse Preferences select Maven - Installations and add that directory to the list of Maven versions that Eclipse knows about. When you create a Run Configuration for the Installer, you will select this Maven 2.2.1.
The JBoss Tools need to locate the directory where JBoss is installed. You can do this manually, but Eclipse JBoss Tools can configure it for you. Go to Preferences - JBoss Tools - JBoss Runtime Detection (in Luna you may have to click it, click something else, then click it again). Click the Add button and then browse to the parent directory of the jboss server (if JBoss was installed as /opt/jboss/jboss-eap-6.1 then browse to /opt/jboss). If you click search, then JBoss will configure any JBoss or Tomcat servers found under the directory you just configured. If you have multiple versions of JBoss, put them all under the same directory and they will all be located.