...

The software and environment consists of these components:

• Sun (Oracle) Java 7
• PostgreSQL database
• A Java Servlet container, normally Apache Tomcat 7.x
• Java Server Faces 2 (JSF 2)
• X Faces add-on to JSF
• XHTML and Java code written for this project
• Eclipse IDE for Java EE for development/testing

When the application is first run, it detects if the postgresql database exists and creates it if necessary.

...

1. Start Eclipse; it will request a folder name. Our practice is to use a folder name that makes it clear this is an Eclipse workspace. For example:
   1. cdacontentevaluation-workspace
2. Edit the Git configuration.
   1. From the Eclipse menu bar, select View > Preferences.
   2. In the Preferences dialog left side menu tree, open Team > Git > Configuration.
   3. In the Configuration dialog, select the User Settings tab (may already be selected).

   4. Edit the key-value pairs to look like this (your name and email, of course):

      Image Added
3. Close the Welcome window and open the view: Git Repository Exploring
4. The left panel should indicate three options; you will select the option: Cline a Git repository
5. A form will popup that you need to complete.
   1. Use this value for the URI: https://code.imphub.org/scm/cda/cdacontentevaluation.git
   2. The software will automatically fill in values for Host, Repository path and protocol
   3. You need to add your authentication information below (User, Password). These are the credentials you have established for www.imphub.org
   4. Select "Next". On our MacOS systems, this step aborted because of configuration error. See the Notes for MacOS section below.
6. A different form will popup that lists the branches of the software. We only have the master. Select Next on this form (not Finish).
7. the Git Repository Exploring perspective.
   1. Click on the Open Perspective icon: Image Added which is in the upper right area of the screen.

   2. In the Open Perspective dialog, select Git Repository Exploring and Click OK.

      Image Added

8. The left panel of the Git Repository Exploring perspective contains the Git Repositories tab. Since this is a new project and has no identified Git Repositories, the following links will appear in the middle of the tab:

   Image Added

9. Click on "Clone a Git repository" link, which will start the wizard. Fill in the first dialog as shown, using your own imphub login and password, and click Next

   Image Added

10. In the Branch Selection dialog, select the master branch and click Next.
    Image Added
11. In the Local Destination dialog,
     Image Added The next form indicates where you will place your git repository.
    1. This is not the same folder as your workspace. Use a folder name that makes this clear; for example:  cdacontentevaluation-repository
    2. Enter the directory where your local Git repository will be placed. This should not be in your workspace.
    3. CheckOn that form, select the box labeled: Import all existing projects after clone finishes.
    4. Select Click Finish
12. This will complete with errors that you will correct.
    1. Ralph, I need your help here.

Notes for MacOS

We found some issues when using git on a MacOS system. The article with a solution is found here: http://www.pur-logic.com/2012/04/21/egit-self-signed-certificate/

If you get the error: "cannot open git-upload-pack", you can read the article listed above. The steps to correct the problem are:

...

• http.sslVerify = false

1. The wizard will clone the Git repository to your local system and import the CDA Content Evaluation project to Eclipse.
2. Switch to the Java EE perspective.
3. Update Eclipse with the project maven configuration.
   1. In the Project Explorer tab, right click on the CDAContentEvaluation line.
   2. On the context menu, select Maven > Update Project...
   3. In the Update Maven Project

...

Attach Tomcat to Eclipse

...