Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel2

OpenCDS Developer Workstation Configuration Instructions for OpenCDS 1.1 Release

Last updated July 15, 2013

 

-          Document Version History

  • 8/28/2011
    • Created by Kensaku Kawamoto based on configuration instructions for OpenCDS alpha release
    • Changes include:
      • Use of Drools and Guvnor 5.2 instead of 5.1.1
      • More information on 64-bit OS configuration
      • Use of newest releases of software components
  • 11/8/2011
    • Updated by Kensaku Kawamoto, with verification on 32-bit and 64-bit Windows OSs
    • Use of Drools 5.3.0 instead of 5.2.0
  • 11/9/2011
    • Updated by Kensaku Kawamoto to include use of SilkSVN for 32-bit OSs as well
  • 11/10/2011
    • Updated by Kensaku Kawamoto to note need to use latest Tortoise SVN version
  • 11/16/2011
    • Updated by Kensaku Kawamoto to include preliminary Guvnor/Designer installation instructions and to make additional note regarding Tortoise SVN
  • 11/29/2011
    • Updated by David Shields to include solution to failed installation of JBoss Application Server in a path including “Program Files (x86)”.
  • 12/16/2011
    • Updated by David Shields to include alternate installation paths, 2.0  version of JBoss Designer, alternate ports for JBoss, and availability of OpenCDS 1.0 binaries.
  • 12/17/2011
    • Updated by David Shields to include information on extended default timeout for JBoss AS 7.0.2
  • 11/14/2012
    • Major update by David Shields to reflect latest versions of all components, including Drools 5.4, JBPM Designer 5.3, and JBoss 7.1.x
  • 1/11/2013
    • Updated to reflect Drools 5.5, Designer 5.4
  • 5/24/2013
    • Updated to move Guvnor installation instructions to separate document

 

 

 

Table of Contents

 

I.       Installation and Setup of Infrastructure Components. 3

A.         Install Java. 3

B.         Install Maven. 3

C.         Install Apache CXF. 3

D.         Install Tortoise SVN.. 3

E.          Install Tomcat 4

F.     Install Latest Stable Version of Eclipse. 5

G.         Install Eclipse plugins. 7

II.     OpenCDS Configuration in Eclipse. 18

A.         Import Projects into Eclipse. 18

B.         Build OpenCDS Eclipse Project 24

C.         Troubleshooting. 25

1.          Check the results of the Maven Installs. 25

2.          The nuclear option. 25

III.       Drools Guvnor Configuration. 26

 

 

Note:  These instructions have been verified via installations onto a Windows XP 32-bit machine and two Windows 7 64-bit machines.  If you have Windows User Access Control turned on, you may need to disable it in order to complete the installation properly.

 

We also have reports that OpenCDS has been successfully installed on Linux and Macintosh machines, by users who are experts in those environments.

 

Also note:  these instructions do not encompass setting up an Apelon DTS terminology service instance.  Setting up such an instance is not required for use of OpenCDS.  Documentation on setting up an Apelon DTS instance can be found at http://apelon-dts.sourceforge.net/

 

NOTE: we have created a common, publicly accessible Apelon DTS instance for maintaining a central set of concepts for use by the OpenCDS community.  Software to access this is included in the OpenCDS source distribution.

I.                   Installation and Setup of Infrastructure Components

 

A.                 Install Java

1)      Install Java SE SDK version 6 (or 7 if you are comfortable updating the POM files for Maven)

a)      Download appropriate 32-bit or 64-bit Java SE SDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html.

i)        Current Maven POM configuration files expect Java 1.6.  Experts may wish to use Java 1.7 and make appropriate changes to the POMs.

b)      Run executable, install using default options

i)        You can use a non-default installation directory if desired

...


Note:  These instructions have been verified via installations onto a Windows XP 32-bit machine and two Windows 7 64-bit machines.  If you have Windows User Access Control turned on, you may need to disable it in order to complete the installation properly.

We also have reports that OpenCDS has been successfully installed on Linux and Macintosh machines, by users who are experts in those environments.

Also note:  these instructions do not encompass setting up an Apelon DTS terminology service instance.  Setting up such an instance is not required for use of OpenCDS.  Documentation on setting up an Apelon DTS instance can be found at http://apelon-dts.sourceforge.net/

NOTE: we have created a common, publicly accessible Apelon DTS instance for maintaining a central set of concepts for use by the OpenCDS community.  Software to access this is included in the OpenCDS source distribution.


Installation and Setup of Infrastructure Components

Install Java

  1. 1)      Install Java SE SDK version 6 (or 7 if you are comfortable updating the POM files for Maven)

a)      Download appropriate 32-bit or 64-bit Java SE SDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html.

i)        Current Maven POM configuration files expect Java 1.6.  Experts may wish to use Java 1.7 and make appropriate changes to the POMs.

b)      Run executable, install using default options

i)        You can use a non-default installation directory if desired

c)      Control Panel à System à Advanced à Environment Variables à System Variables

i)        Set JAVA_HOME to Java SE SDK location

(1)   E.g., C:\Program Files\Java\jdk1.6.0_26

ii)      Add %JAVA_HOME%\bin to Path

(1)   In this example, was added to beginning of Path

Install Maven

1)      Download .zip file of latest stable Maven build from http://maven.apache.org/download.html

a)      These instructions have been tested for both Maven 3.0.3 at http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-3.0.3-bin.zip and Maven version 2.2.1 at http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-2.2.1-bin.zip

b)      Unzip archive

c)      Follow instructions in README.txt, provided below

d)     Directory specifications below are not mandatory, but recommended for consistency purposes

i)        Place unzipped folder (apache-maven-3.0.3) in following directory: C:\Program Files\Apache Software Foundation

e)      Control Panel à System à Advanced à Environment Variables à System Variables

i)        Set MAVEN_HOME to “C:\Program Files\Apache Software Foundation\apache-maven-3.0.3”

ii)      Add %MAVEN_HOME%\bin to Path

(1)   In this example, was added to beginning of Path

 

Install Apache CXF

1)      Download latest binary version of Apache CXF from http://cxf.apache.org/download.html

a)   Unzip and move the apache-cxf-2.X.X folder to be under C:\Program Files\Apache Software Foundation

 

Install Tortoise SVN

1)      Download TortoiseSVN from http://tortoisesvn.net/downloads.html

a)      Note: if you already have TortoiseSVN installed, get the latest version if you plan to update Subclipse (the Eclipse Subversion plugin) to the latest version.  You may run into some problems when using TortoiseSVN to check out the OpenCDS project if TortoiseSVN uses a Subversion version that is older than the Subversion version used by Eclipse.

b)      Install using default options, then restart machine

 

Install Tomcat

1)      Download latest Tomcat using “32-bit/64-bit Windows Service Installer” from relevant download page at http://tomcat.apache.org/

a)      OpenCDS has been tested using both Apache Tomcat versions 6 and 7, you can use either

b)      Accept defaults

c)      Installation directory may be changed if desired

d)     Set Tomcat Administrator Login to something secure

  1.                     i.            You may even prefer to remove the administrator login if you have physical access to the server.

2)      Control Panel à System à Advanced à Environment Variables à System Variables

ia)              Set JAVACATALINA_HOME to Java SE SDK location(1)   E, e.g., C“C:\Program Files\Java\jdk1.6.0_26iiApache Software Foundation\Tomcat 7.0”

b)      Add %JAVA%CATALINA_HOME%\bin to Path(1)  

  1.                     i.            In this example, was added to beginning of Path

 

...


Install Latest Stable Version of Eclipse

1)      Download .zip file of latest stable Maven build Eclipse from http://mavenwww.apacheeclipse.org/download.htmldownloads/

a)      These instructions have been tested for both Maven 3.0.3 at http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-3.0.3-bin.zip and Maven version 2.2.1 at http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-2.2.1-bin.zip

b)      Unzip archive

c)      Follow instructions in README.txt, provided below

d)     Directory specifications below are not mandatory, but recommended for consistency purposes

i)        Place unzipped folder (apache-maven-3.0.3) in following directory: C:\Program Files\Apache Software Foundation

e)      Control Panel à System à Advanced à Environment Variables à System Variables

i)        Set MAVEN_HOME to “C:\Program Files\Apache Software Foundation\apache-maven-3.0.3”

ii)      Add %MAVEN_HOME%\bin to Path

(1)   In this example, was added to beginning of Path

 

C.                 Install Apache CXF

1)      Download latest binary version of Apache CXF from http://cxf.apache.org/download.html

a)   Unzip and move the apache-cxf-2.X.X folder to be under C:\Program Files\Apache Software Foundation

 

...

1)      Download TortoiseSVN from http://tortoisesvn.net/downloads.html

a)      Note: if you already have TortoiseSVN installed, get the latest version if you plan to update Subclipse (the Eclipse Subversion plugin) to the latest version.  You may run into some problems when using TortoiseSVN to check out the OpenCDS project if TortoiseSVN uses a Subversion version that is older than the Subversion version used by Eclipse.

b)      Install using default options, then restart machine

 

E.                 Install Tomcat

1)      Download latest Tomcat using “32-bit/64-bit Windows Service Installer” from relevant download page at http://tomcat.apache.org/

a)      OpenCDS has been tested using both Apache Tomcat versions 6 and 7, you can use either

b)      Accept defaults

c)      Installation directory may be changed if desired

d)     Set Tomcat Administrator Login to something secure

  1.                     i.            You may even prefer to remove the administrator login if you have physical access to the server.

2)      Control Panel à System à Advanced à Environment Variables à System Variables

a)      Set CATALINA_HOME to, e.g., “C:\Program Files\Apache Software Foundation\Tomcat 7.0”

b)      Add %CATALINA_HOME%\bin to Path

  1.                     i.            In this example, was added to beginning of Path

 

F.                  Install Latest Stable Version of Eclipse

1)      Download Eclipse from http://www.eclipse.org/downloads/

a)      Compatibility note:  as of 11/8/2011, the JBoss Drools Eclipse Workbench is not available as a stable release for Eclipse version 3.7.X (Eclipse Indigo).  Therefore, it is recommended that Eclipse Helios (version 3.6.X) or newer Eclipse is used instead.

i)        Update as of 11/14/2012: the above issue is no longer a problem

b)      In this example, installed Eclipse Helios version 3.6.2 from http://www.eclipse.org/downloads/packages/release/helios/sr2

 

 

c)      Select 32 or 64-bit version, whichever is appropriate for your machine/OS. 

2)      Create an Eclipse instance by unzipping the zip archive into a directory of choice

a)      NOTE: if you already have eclipse installed (e.g., at C:\Program Files\eclipse) for other projects you are working on, we strongly recommend that you install eclipse in a different directory (e.g., C:\Program Files\eclipseOpenCDS).  This way, you will not impact any existing code or Eclipse settings (e.g., with regard to plugins).  Furthermore, in the event that you need to uninstall and reinstall OpenCDS, you will be able to delete the OpenCDS eclipse folder without impacting any other projects.

b)      The default directory used for these instructions is C:\Program Files\eclipse, which is where the Eclipse instance will be created if you unzip the zip archive directly into C:\Program Files

3)      Notes

a)      You do not need to modify your path or add environment variables to use eclipse

b)      Read the release notes (especially if you have problems) found at C:\Program Files\eclipse\readme\readme_eclipse.html

c)      Remember that you can often fix weird problems in eclipse from a command prompt by running “eclipse –clean” which will start eclipse with a clean slate (and make it forget all the in-process state of files you were currently working on)

4)      Create a shortcut for Eclipse that passes in Java Virtual Machine parameters that a) ensures that the JDK is used rather than the JRE and b) ensures sufficient memory is allocated.  Then, use the shortcut for launching Eclipse.  Different shortcuts can be created if different Eclipse configurations are desired.

a)      E.g., edit target of shortcut to:

"C:\Program Files\eclipse\eclipse.exe" -vm "C:\Program Files\Java\jdk1.6.0_26\bin" -vmargs -Xmx900m

 

 

b)      Alternatively, the C:\Program Files\eclipse\eclipse.ini can be edited.

i)        For more information, see http://wiki.eclipse.org/FAQ_How_do_I_increase_the_heap_size_available_to_Eclipse%3F, http://wiki.eclipse.org/Eclipse.ini.

 

5)      When first starting Eclipse, set workspace to appropriate directory

a)      Suggested location is “C:\OpenCDS”

b)      An alternate suggested location if installing multiple versions of OpenCDS on the same machine is “C:\OpenCDS_[version]”

i)        e.g., “C:\OpenCDS_v1.0_preview”, “C:\OpenCDS_alpha”, “C:\OpenCDS_v1.1.2”, etc.

G.                 Install Eclipse plugins

Eclipse has built-in tools to locate and install plug-ins, and to update them when necessary.  Use the built-in tools whenever possible. 

 

There are two ways to do this.  The new method is called Eclipse Marketplace.  Use it whenever you can by going to

Help à Eclipse Marketplace

The traditional method is more tedious, and will need to be used if you can’t find the software you are looking for in the Eclipse Marketplace.  It is also used for some plugins that don’t install all the required options when run from the Marketplace menu.  This method is used by going to

Help à Install New Software

 

a)      Install M2Eclipse

i)        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.

ii)      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)…

iii)    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.

 

 

b)      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)

 

 

 

 

c)      Install Subclipse

i)        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.

ii)      From Install New Software

(1)   Select all options from the menu after you enter / select the path as shown below

(a)    URL = http://subclipse.tigris.org/update_1.8.x

(b)   Name = anything; suggest “Subclipse”

(2)    

(3)   Click on Next

(a)    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

d)     Set Eclipse Preferences for Subversion

i)        Window à Preferences à Team à SVN

ii)      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

iii)    Window à Preferences à Team à SVN à Menu icons

(1)   Select Tortoise SVN

 

e)      Set up Tomcat Server in Eclipse

i)        File à New à Other à Server à Server

(1)   Select Apache Tomcat (e.g., Tomcat 7.0) and use default settings

(2)  

 

ii)      Select installation directory, Finish

 

 

f)       Set Eclipse Preferences for Maven

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

 

ii)      Create a settings.xml file in location specified in Eclipse under Window à Preferences à Maven à User Settings

 

iii)    Sample XML (used for this example):

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

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" Compatibility note:  as of 11/8/2011, the JBoss Drools Eclipse Workbench is not available as a stable release for Eclipse version 3.7.X (Eclipse Indigo).  Therefore, it is recommended that Eclipse Helios (version 3.6.X) or newer Eclipse is used instead.

i)        Update as of 11/14/2012: the above issue is no longer a problem

b)      In this example, installed Eclipse Helios version 3.6.2 from http://www.eclipse.org/downloads/packages/release/helios/sr2

 

 

c)      Select 32 or 64-bit version, whichever is appropriate for your machine/OS. 

2)      Create an Eclipse instance by unzipping the zip archive into a directory of choice

a)      NOTE: if you already have eclipse installed (e.g., at C:\Program Files\eclipse) for other projects you are working on, we strongly recommend that you install eclipse in a different directory (e.g., C:\Program Files\eclipseOpenCDS).  This way, you will not impact any existing code or Eclipse settings (e.g., with regard to plugins).  Furthermore, in the event that you need to uninstall and reinstall OpenCDS, you will be able to delete the OpenCDS eclipse folder without impacting any other projects.

b)      The default directory used for these instructions is C:\Program Files\eclipse, which is where the Eclipse instance will be created if you unzip the zip archive directly into C:\Program Files

3)      Notes

a)      You do not need to modify your path or add environment variables to use eclipse

b)      Read the release notes (especially if you have problems) found at C:\Program Files\eclipse\readme\readme_eclipse.html

c)      Remember that you can often fix weird problems in eclipse from a command prompt by running “eclipse –clean” which will start eclipse with a clean slate (and make it forget all the in-process state of files you were currently working on)

4)      Create a shortcut for Eclipse that passes in Java Virtual Machine parameters that a) ensures that the JDK is used rather than the JRE and b) ensures sufficient memory is allocated.  Then, use the shortcut for launching Eclipse.  Different shortcuts can be created if different Eclipse configurations are desired.

a)      E.g., edit target of shortcut to:

"C:\Program Files\eclipse\eclipse.exe" -vm "C:\Program Files\Java\jdk1.6.0_26\bin" -vmargs -Xmx900m

 

 

b)      Alternatively, the C:\Program Files\eclipse\eclipse.ini can be edited.

i)        For more information, see http://wiki.eclipse.org/FAQ_How_do_I_increase_the_heap_size_available_to_Eclipse%3F, http://wiki.eclipse.org/Eclipse.ini.

 

5)      When first starting Eclipse, set workspace to appropriate directory

a)      Suggested location is “C:\OpenCDS”

b)      An alternate suggested location if installing multiple versions of OpenCDS on the same machine is “C:\OpenCDS_[version]”

i)        e.g., “C:\OpenCDS_v1.0_preview”, “C:\OpenCDS_alpha”, “C:\OpenCDS_v1.1.2”, etc.


Install Eclipse plugins

Eclipse has built-in tools to locate and install plug-ins, and to update them when necessary.  Use the built-in tools whenever possible. 

 

There are two ways to do this.  The new method is called Eclipse Marketplace.  Use it whenever you can by going to

Help à Eclipse Marketplace

The traditional method is more tedious, and will need to be used if you can’t find the software you are looking for in the Eclipse Marketplace.  It is also used for some plugins that don’t install all the required options when run from the Marketplace menu.  This method is used by going to

Help à Install New Software

 

a)      Install M2Eclipse

i)        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.

ii)      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)…

iii)    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.

 

 


b)      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)

 

 

 

 


c)      Install Subclipse

i)        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.

ii)      From Install New Software

(1)   Select all options from the menu after you enter / select the path as shown below

(a)    URL = http://subclipse.tigris.org/update_1.8.x

(b)   Name = anything; suggest “Subclipse”

(2)    

(3)   Click on Next

(a)    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


d)     Set Eclipse Preferences for Subversion

i)        Window à Preferences à Team à SVN

ii)      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

iii)    Window à Preferences à Team à SVN à Menu icons

(1)   Select Tortoise SVN

 

e)      Set up Tomcat Server in Eclipse

i)        File à New à Other à Server à Server

(1)   Select Apache Tomcat (e.g., Tomcat 7.0) and use default settings

(2)  

 

ii)      Select installation directory, Finish

 

 


f)       Set Eclipse Preferences for Maven

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

 

ii)      Create a settings.xml file in location specified in Eclipse under Window à Preferences à Maven à User Settings

 


iii)    Sample XML (used for this example):

<?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.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

...

(2)   Select the Drools runtime for use (Use the current version, not 5.3 as shown below)

 

 

(3)   Restart Eclipse

 

...


OpenCDS Configuration in Eclipse

 

All OpenCDS sub-projects are contained within a parent project called “opencds-parent”.  An overview of these sub-projects will be made available in a separate document in the near future.

 

...

Import Projects into Eclipse

1)      Add the OpenCDS repository to the list of repositories available to Eclipse.

...

(1)   From the command line, go to the opencds-parent folder in the workpace (e.g., C:\OpenCDS\opencds-parent)

(2)   Run the command

(a) mvn clean

(3)   Run the command

(a) mvn install

(4)   Run the command

(a) mvn eclipse:eclipse

(b) 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

a)      Open Eclipse

b)      Import the OpenCDS parent project into Eclipse OpenCDS workspace as a Maven project, as follows:

i)        File à Import à Maven à Existing Maven Projects à Next

 

 

 

ii)      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)

 

 

B.                 Build OpenCDS Eclipse Project

 

1)      Following the process above, you should see something similar to the following in Eclipse as built projects (there are more modules as time goes on, and some get renamed as well):

 

 

 

  1. A build has already taken place from the command line as a part of the setup process.  For future builds, you can do through the following procedure:
    1.                                                               i.      Right click on opencds-parent à Run as à Maven Clean
    2.                                                             ii.      Right click on opencds-parent à Run as à Maven Install

 

C.                 Troubleshooting

Maven is great when things are working.  However, it can be challenging to get things to work when Maven is not working.  The most common problem will look something like this:

 

 

Here are a couple suggestions to fix the problem:

1.                  Check the results of the Maven Installs

Maven will sometimes report a successful installation when the specified file (the “-Dfile=…” parameter) does not exist.  This will then cause downstream failures of Maven builds.  Verify that the local Maven repository contains the jar files you installed by looking in your local Maven repository (found as a folder named “.m2”  in your “User” directory).  For example, this path for the SpringSource jar will be:

.m2\repository\org\apache\jasper\springsource\com.springsource.org.apache.jasper.org.eclipse.jdt.springsource\6.0.20.S2-r5956\com.springsource.org.apache.jasper.org.eclipse.jdt.springsource-6.0.20.S2-r5956.jar

 

If you find that one of the jars that you installed with a “mvn install …” command is missing, then rerun the installation, making sure that you have used the correct path for the source file, and spelled everything correctly.  The most common error is to download the files to the default download path on your machine (eg, “C:\yourUserName\Downloads”), but to install it using the sample command that we furnished which has a different path.  Another common problem is that the downloaded package might have a “.zip” extension, and needs to be changed to a “.jar” extension before use.

2.                  The nuclear option

If you cannot get things to work using the above approach (usually due to a Maven issue), you can reset your system to the state just prior to the Eclipse installation (section I.F) via the following:

-          Delete Eclipse folder (e.g., C:\Program Files\eclipse)

-          Delete OpenCDS workspace (e.g., C:\OpenCDS)

-          Delete Maven repository (e.g., C:\Users\Ken\.m2)

 

You can then re-attempt the installation and configuration process.)   Run the command

(a) mvn clean

(3)   Run the command

(a) mvn install

(4)   Run the command

(a) mvn eclipse:eclipse

(b) 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

a)      Open Eclipse

b)      Import the OpenCDS parent project into Eclipse OpenCDS workspace as a Maven project, as follows:

i)        File à Import à Maven à Existing Maven Projects à Next

 

 

 

ii)      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)

 

 


Build OpenCDS Eclipse Project

 

1)      Following the process above, you should see something similar to the following in Eclipse as built projects (there are more modules as time goes on, and some get renamed as well):

 

 

 

  1. A build has already taken place from the command line as a part of the setup process.  For future builds, you can do through the following procedure:
    1.                                                               i.      Right click on opencds-parent à Run as à Maven Clean
    2.                                                             ii.      Right click on opencds-parent à Run as à Maven Install

 


Troubleshooting

Maven is great when things are working.  However, it can be challenging to get things to work when Maven is not working.  The most common problem will look something like this:

 

 

Here are a couple suggestions to fix the problem:

1.                  Check the results of the Maven Installs

Maven will sometimes report a successful installation when the specified file (the “-Dfile=…” parameter) does not exist.  This will then cause downstream failures of Maven builds.  Verify that the local Maven repository contains the jar files you installed by looking in your local Maven repository (found as a folder named “.m2”  in your “User” directory).  For example, this path for the SpringSource jar will be:

.m2\repository\org\apache\jasper\springsource\com.springsource.org.apache.jasper.org.eclipse.jdt.springsource\6.0.20.S2-r5956\com.springsource.org.apache.jasper.org.eclipse.jdt.springsource-6.0.20.S2-r5956.jar

 

If you find that one of the jars that you installed with a “mvn install …” command is missing, then rerun the installation, making sure that you have used the correct path for the source file, and spelled everything correctly.  The most common error is to download the files to the default download path on your machine (eg, “C:\yourUserName\Downloads”), but to install it using the sample command that we furnished which has a different path.  Another common problem is that the downloaded package might have a “.zip” extension, and needs to be changed to a “.jar” extension before use.

2.                  The nuclear option

If you cannot get things to work using the above approach (usually due to a Maven issue), you can reset your system to the state just prior to the Eclipse installation (section I.F) via the following:

-          Delete Eclipse folder (e.g., C:\Program Files\eclipse)

-          Delete OpenCDS workspace (e.g., C:\OpenCDS)

-          Delete Maven repository (e.g., C:\Users\Ken\.m2)

 

You can then re-attempt the installation and configuration process.

 

Document Version History

  • 8/28/2011
    • Created by Kensaku Kawamoto based on configuration instructions for OpenCDS alpha release
    • Changes include:
      • Use of Drools and Guvnor 5.2 instead of 5.1.1
      • More information on 64-bit OS configuration
      • Use of newest releases of software components
  • 11/8/2011
    • Updated by Kensaku Kawamoto, with verification on 32-bit and 64-bit Windows OSs
    • Use of Drools 5.3.0 instead of 5.2.0
  • 11/9/2011
    • Updated by Kensaku Kawamoto to include use of SilkSVN for 32-bit OSs as well
  • 11/10/2011
    • Updated by Kensaku Kawamoto to note need to use latest Tortoise SVN version
  • 11/16/2011
    • Updated by Kensaku Kawamoto to include preliminary Guvnor/Designer installation instructions and to make additional note regarding Tortoise SVN
  • 11/29/2011
    • Updated by David Shields to include solution to failed installation of JBoss Application Server in a path including “Program Files (x86)”.
  • 12/16/2011
    • Updated by David Shields to include alternate installation paths, 2.0  version of JBoss Designer, alternate ports for JBoss, and availability of OpenCDS 1.0 binaries.
  • 12/17/2011
    • Updated by David Shields to include information on extended default timeout for JBoss AS 7.0.2
  • 11/14/2012
    • Major update by David Shields to reflect latest versions of all components, including Drools 5.4, JBPM Designer 5.3, and JBoss 7.1.x
  • 1/11/2013
    • Updated to reflect Drools 5.5, Designer 5.4
  • 5/24/2013
    • Updated to move Guvnor installation instructions to separate document