Eclipse

Eclipse Setup

A demonstration of installing and configuring Eclipse 3.7 for working with most Jasig projects.

Many progress bars and wait times are cut out of the video.

Detailed Instructions

These instructions correspond to the times and subtitles in the demo video.

 0:00 - 0:40 - Download & Extract Eclipse

Download Eclipse IDE for Java EE Developers from: http://www.eclipse.org/downloads/

 0:40 - 0:55 - Create a new Eclipse Workspace

Select the location to store your projects

 0:55 - 1:35 - Install Subclipse SVN Client Plugin
  1. Go to the Help > Eclipse Market Place... menu
  2. Search for Subversion
  3. Scroll to the Subclipse entry and click on the Install button
  4. Agree to the license, click through the following dialogs and click the Restart Now button when it appears.
 1:35 - 2:05 - Ubuntu Specific: Install Java-Subversion Library

If using Ubuntu, or likely other flavors of Linux, the libsvn-java library needs to be installed. If you are not using Linux please ignore this step.

 2:05 - 3:05 - Install Spring Tool Suite
  1. Download the Spring Tool Suite Installation Instructions
  2. Find the Installing from the Release Update Site section
  3. Find the URL for the bookmarks.xml file for Eclipse 3.7 (http://dist.springsource.com/release/TOOLS/composite/e3.7/bookmarks.xml)
  4. Save this file to your computer
  5. In Eclipse go to the Window > Preferences > Install/Update > Available Software" options and click on the *Import... button.
  6. Select the bookmarks.xml file you just downloaded
  7. Go to the Help > Install New Software... menu
  8. Select the SpringSource Update Site for Eclipse 3.7 option from the Work with: drop down box
  9. Click the Select All button and then the Next > button
  10. Agree to the license, click through the following dialogs and click the Restart Now button when it appears.
 3:05 - 3:38 - Install Maven 2 Eclipse Integration (M2E)
  1. Go to the M2E Project Site and follow the Download link
  2. Copy the update site URL (http://download.eclipse.org/technology/m2e/releases)
  3. In Eclipse go to the Help > Install New Software... menu
  4. Paste the update site URL into the Work with: drop down box and press enter.
  5. Click the Select All button and then the Next > button
  6. Agree to the license, click through the following dialogs and click the Restart Now button when it appears.
 3:38 - 4:05 - Install Sysdeo Tomcat Plugin
  1. Go to the Sysdeo Tomcat Plugin Site
  2. Scroll to the Download section and download the latest release.
  3. Extract the downloaded file and move the resulting com.sysdeo.eclipse.tomcat_3.3.0 folder into the eclipse/plugins directory.
  4. Manually restart eclipse
 4:05 - 4:33 - Workspace Setup

Customize your Eclipse workspace UI according to your preferences.

These instructions were last updated on 7/22/2011

uPortal Project Setup

A demonstration of checking out and configuring uPortal 4 in Eclipse. This video assumes the setup in the Eclipse Setup video above was followed.

Many progress bars and wait times are cut out of the video.

Detailed Instructions

These instructions correspond to the times and subtitles in the demo video.

 0:00 - 0:10 - Starting Eclipse

.

 0:10 - 0:23 - Add Jasig SVN Repository
  1. Switch to the SVN Repository Exploring perspective
  2. Right click in the SVN Repositories list and select New > Repository Location from the menu
  3. Enter https://source.jasig.org/* for the *Url and click the Finish button.
 0:23 - 1:18 - Checkout uPortal 3.2-patches Branch
  1. Navigate to the uPortal/branches/rel-3-2-patches folder in the Jasig SVN repository (https://source.jasig.org/)
  2. Right click on the rel-3-2-patches folder and select Checkout... from the menu
  3. Use the New Project Wizard option on the Checkout from SVN dialog and click the Finish button
  4. Under the General folder select Project and click the Next > button
  5. Name the project uPortal_3.2-patches and click Next > then Finish
 1:18 - 1:40 - Configure as Maven Project
  1. Right Click on the uPortal_3.2-patches project and select the Configure > Convert to Maven Project option.
 1:40 - 2:30 - Import Child Projects
  1. Right Click on the uPortal_3.2-patches project and select the Import... option.
  2. Expand the Maven folder and select the Existing Maven Projects option, then click Next >
  3. Click the Deselect All button since uPortal creates a lot of little Maven overlay projects that aren't useful to import.
  4. Select the uportal-impl and uportal-war projects
  5. Expand the Advanced section and select the Name template: artifactId-version, then click Next >
  6. Select the Add project(s) to working set checkbox
  7. Click the More.. button to the right of the Working Set drop down box
  8. In the Select Working Sets dialog click the New button
  9. Select the Java working set option, click Next >, name the working set uPortal_3.2-patches and click Finish
  10. Click Next > in the Import Maven Projects dialog. You can ignore the warnings about missing Maven plugin connectors and just click Finish
 2:30 - 2:40 - Switch to Working Sets View
  1. Click on the small down arrow in the upper right corner of the Package Explorer tab
  2. Select Top Level Elements > Working Sets from the menu
  3. Check the Sort Projects box and then click the OK button

These instructions were last updated on 7/22/2011