Versions Compared

Old Version 7

changes.mady.by.user Alisha Edison-Hair (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Alisha Edison-Hair (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

    1. Install M2Eclipse
      1. Before you can use Maven from Eclipse, you will need to make sure that you are running Eclipse from the JRE that is part of a JDK virtual machine.  One safe way to do this is to create a shortcut for running Eclipse, and adding the path to the JDK in the shortcut target, as described above under the Eclipse installation instructions.
      2. From Eclipse Marketplace – DO NOT DO THIS!  You will need to do the initial install the traditional way, as described next (the Eclipse Marketplace does not currently allow you to do a base install of m2eclipse)…
      3. From Install New Software
        1. Help → Install New Software


        Type just the URL (http://m2eclipse.sonatype.org/sites/m2e) (1), click the Add button (2), type in “m2eclipse” for the name, and hit “okay” for adding the repository.  You should then click in the box beside “Maven Integration for Eclipse (3), and click the Next button at the bottom of the Install window.

        It will verify your selection (making sure dependencies are present), and then give you a chance to go back to add dependencies, or continue by clicking Next

        Accept the license and click Finish.

        Restart Eclipse if prompted.

        If you get the following warning, click OK to ignore


        If you get the following error, restart the machine and try again.



    2. Make sure Eclipse is pointed to a JDK rather than a JRE in Eclipse Preferences (Windows → Preferences → Java → Installed JREs and Windows → Preferences → Java → Installed JREs → Execution Environments)



    3. Install Subclipse
      1. From Eclipse Marketplace:  DO NOT DO THIS!  It installs correctly, but is missing some important functionality.
        1. UPDATE:  The install from Eclipse Marketplace has apparently been fixed.
      2. From Install New Software
        1. Select all options from the menu after you enter / select the path as shown below
          1. URL = http://subclipse.tigris.org/update_1.8.x
          2. Name = anything; suggest “Subclipse”


        3. Click on Next
          1. It will verify your selection (making sure dependencies are present), and then give you a chance to go back to add dependencies, or continue by clicking Next.
        4. Accept the license and click Finish
        5. If you get the following warning, click OK to ignore.


        6. Restart Eclipse if prompted
    4. Set Eclipse Preferences for Subversion
      1. Window → Preferences → Team → SVN
      2. Select a client for the SVN Interface
        1. If no clients are listed, you probably installed Subclipse from the Marketplace, and didn’t get the client.  Go back to the step about installing Subclipse and get the client.
        2. For this example, JavaHL is selected
      3. Window → Preferences → Team → SVN → Menu icons
        1. Select Tortoise SVN
    5. Set up Tomcat Server in Eclipse
      1. File → New → Other → Server → Server
        1. Select Apache Tomcat (e.g., Tomcat 7.0) and use default settings
      2. Select installation directory, Finish
    6. Set Eclipse Preferences for Maven

      1. Window → Preferences → Maven → Installations → Add → specify Maven root folder (e.g., C:\Program Files\Apache Software Foundation\apache-maven-3.0.3) → OK


      2. Create a settings.xml file in location specified in Eclipse under Window → Preferences → Maven → User Settings


      3. Sample XML (used for this example):

        Pre

        <?xml version="1.0" encoding="UTF-8"?>

        <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0http://maven.apache.org/xsd/settings-1.0.0.xsd">

        <pluginGroups>

               </pluginGroups>

               <proxies>

               </proxies>

               <servers>

               </servers>

               <mirrors>

               </mirrors>

               <profiles>

               </profiles>

        </settings>

      4. Restart Eclipse
      5. Update central Maven repository index, as follows.  Note that if you don't do it here, it will automatically take place later in the installation process.  We recommend updating the index here, so that if there is an error, it is clear where the error occurred.
        1. Windows → Show View →Other → Maven → Maven Repositories
          1. Click Global Repositories → right click "central", select Update Index
          2. This may take a while; you can track progress by clicking on the progress icon on the bottom right of the screen  ()
          3. Sometimes, it takes multiple attempts before this completes.  You may need to restart Eclipse in the process.
          4. If you see an error message of "Unable to update index for central," it may mean you need to turn off a Proxy connection (see http://www.ehow.com/how_6079770_using-proxy-server.html) or configure Proxy-based Maven connections (see http://maven.apache.org/guides/mini/guide-proxies.html).  Once you have made the changes, verify that you do not get this error by repeating the steps above.
    7. InstallJbossDrools Eclipse Workbench (allows writing Drools rules and working with Drools Flow, and testing / debugging directly from Eclipse; part of JBoss Tools).
      1. Automatic installation from Eclipse
        1. Download Drools plugin for Eclipse
          1. Help → Install New Software
          2. Use appropriate URL found at http://www.jboss.org/tools/download.html.  In this case, use http://download.jboss.org/jbosstools/updates/stable/helios/
          3. Name used in this example for repository: Drools
          4. Install the three Drools components indicated below under the SOA Development category


          5. If you get the following warning, click OK to ignore.


          6. Restart Eclipse if prompted
      2. Download the Drools Runtime version 5.5.0.Final
        1. Download file named Drools Binaries from http://www.jboss.org/drools/downloads.html, using link at
          http://download.jboss.org/drools/release/5.5.0.Final/drools-distribution-5.5.0.Final.zip
        2. Place contents of the binaries folder in the zip archive into a directory (C:\Data\Drools\Drools5.5.0.Final is used in this guide)
        3. E.g., this directory should look like the following:
      3. Configure Drools Eclipse Workbench
        1. Windows → Preferences → Drools → Installed Drools Runtime → Add
          1. Add the version of Drools (since you are allowed to have more than one installed) that you want to add to the build path of newly created Drools projects (the example below shows an older version, you should use the current version of Drools that you have just installed).
        2. Select the Drools runtime for use (Use the current version, not 5.3 as shown below)


        3. Restart Eclipse

...

  1. Add the OpenCDS repository to the list of repositories available to Eclipse.
    1. Window → Show View → Other…→ SVN → SVN Repositories


    2. You will see a list of the configured Subversion repositories (your initial list may be empty).  Right-click on the list and choose New → Repository Location from the pop-up dialog


    3. Add the repository for the OpenCDS Trunk Project.  The relevant URLs are as follows.  Most individuals should initially connect to the 1.x release repository.

      1. E.g., enter http://develop.opencds.org/svn_v1.0/trunk/opencds-parent, and click on Finis

        RepositoryURL and DescriptionAccess
        Main development trunk

        http://develop.opencds.org/svn_active/trunk/opencds-parent

        Locus of the active development on 1.x releases.

        		Currently restricted to active code contributors.  Access may be requested from David Shields at david.shields@opencds.org.
        1.x release

        http://develop.opencds.org/svn_v1.0/trunk/opencds-parent

        Stable snapshots from the main development trunk.

        		Public read-only access.  ID and password not required.
  2. Import the OpenCDS Project Step 1: Establish Maven Projects
    1. Close Eclipse if open
    2. Check out OpenCDS parent project into the Eclipse OpenCDS workspace as follows:
      1. Go to workspace location (e.g., C:\OpenCDS)
      2. Right click and select SVN Checkout from context menu


      3. Enter URL of repository and proceed, as noted below.  Note that the URL of the repository should be the appropriate one noted in the table above.  Also note that you must add “opencds-parent” to the end of the Checkout directory.


      4. Now, build the project with Maven from the command line
        1. From the command line, go to the opencds-parent folder in the workpace workspace (e.g., C:\OpenCDS\opencds-parent)
        2. Run the command
          1. mvn clean
        3. Run the command
          1. mvn install
        4. Run the command
          1. mvn eclipse:eclipse
          2. running this command creates all the Eclipse-specific project settings for OpenCDS so that you can work with it in Eclipse.
  3. Import the OpenCDS Project Step 2: Import Maven Projects
    1. Open Eclipse
    2. Import the OpenCDS parent project into Eclipse OpenCDS workspace as a Maven project, as follows:
      1. File → Import → Maven → Existing Maven Projects → Next


      2. Root Directory → Browser → opencds-parent location (e.g., C:\OpenCDS\opencds-parent).  Select all Projects, Finish (the latest version of OpenCDS may have slightly different modules than those shown in the example below)

...