Installation

Windows:

• Unzip ZIP-file to an appropriate folder (C:\Program Files)
• Rename unpacked folder "eclipse" to "Eclipse_Ganymede"
• Create a desktop shortcut or quick launch icon to the executable "eclipse.exe" in the unpacked folder

Linux:

# cd /usr/local/bin/
# tar xvfz /home/ralf/DOWNLOADS/eclipse-jee-galileo-SR1-linux-gtk.tar.gz
# mv eclipse/ eclipse-galileo/

Configuration

• Change start parameters in "C:\Program Files\Eclipse_Ganymede\eclipse.ini" or "/usr/local/bin/eclipse-galileo/eclipse.ini"

Windows:

-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256M
-vm
C:\Program Files\Java\jdk1.6.0_13\bin\javaw.exe
-framework
plugins\org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar
-vmargs
-Dosgi.requiredJavaVersion=1.5
-Xmx700m
-XX:MaxPermSize=690M

Linux:

-startup
plugins/org.eclipse.equinox.launcher_1.0.201.R35x_v20090715.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.gtk.linux.x86_1.0.200.v20090520
-product
org.eclipse.epp.package.jee.product
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
-vmargs
-Dosgi.requiredJavaVersion=1.5
-XX:MaxPermSize=690m
-Xms40m
-Xmx700m

Note: Xmx and XX params must be appropriate to your available memory. If Eclipse does not start, down tune them.

• Start Eclipse using shortcut
  • In Workspace Launcher
    • point the "Workspace:" field to a new Workspace-folder like "C:\Documents and Settings\<username>\My Documents\DEV\<companyname>" (Windows) or "/home/ralf/DEV/<companyname>" (Linux). Better would be a very short path for the workspace directory (to avoid later problems if your project has a very deep folder hierarchy/packages), e.g. "D:\WORKSPACES\<companyname>" (Windows)
    • Don't check "Use this as default..." (so it will be easier to switch between different workspaces later)
  • Close "Welcome" tab.

Some basic preference settings

• Window - Preferences:
  • General: Show heap status
  • General - Editors - Text Editors: Show line numbers
  • General - Editors - Text Editors - Spelling - Dictionaries: Encoding: UTF-8
  • General - Network Connections: Manual proxy configuration
    • HTTP proxy: <company_proxy_address>, Port: <company_proxy_port>
    • Use this proxy server for SSL
    • No proxy for: add internal addresses
    • Enable proxy authentication: <username>/<password>
  • General - Workspace: Text file encoding: Other: UTF-8
  • Java - Code Style - Formatter - Java Conventions [built-in] -> Use Sun Java Code Conventions

Plugins

Subclipse

• Installation
  In Eclipse:
  • Menu "Help - Install New Software..."
  • Install dialog: "Add...": Name: "http://subclipse.tigris.org/update_1.6.x", Location: "http://subclipse.tigris.org/update_1.6.x" - OK
  • Select all (if you are not sure what to select) - Next > - Next >* Accept license - Finish
  • Restart Eclipse

• Configuration
  In Eclipse:
  • Menu "Window - Open Perspective - Other... - SVN Repository Exploring" - OK

• Usage
  • Add a new repository location:
    Example:
    • Adding Wicket repository:
      "SVN Repositories" view: right click - New - Repository location... - Location Url: http://svn.apache.org/repos/asf/wicket/
  • Check out
    Example:
    • Checking out Wicket "trunk":
      Right click "http://svn.apache.org/repos/asf/wicket/ - trunk" in "SVN Repositories" - Checkout... - Checkout as project in the workspace, Project Name: "wicket-trunk" - Finish

• Troubleshooting
  • Failed to load JavaHL Library.
    Ubuntu:
    • Install libsvn-java
    • Edit eclipse.ini and add java.library.path:

      Code Block
      title eclipse.ini borderStyle solid
      -vmargs -Djava.library.path=/usr/lib/jni

M2Eclipse

Maven Integration for Eclipse provides tight integration for Maven into the IDE.

• Installation
  In Eclipse:
  • Menu "Help - Install New Software..."
  • Install dialog: "Add...": Name: "http://m2eclipse.sonatype.org/sites/m2e", Location: "http://m2eclipse.sonatype.org/sites/m2e" - OK
  • Select all (if you are not sure what to select, I unchecked AJDT...) - Next > - Next >
  • Accept license - Finish
  • Restart Eclipse

Install additional "extras" from "http://m2eclipse.sonatype.org/sites/m2e-extras"