Jump to: navigation, search

Difference between revisions of "Lyo/BuildRIO"

< Lyo
m
(Build the projects)
(6 intermediate revisions by one other user not shown)
Line 2: Line 2:
  
 
== Prerequisites ==
 
== Prerequisites ==
* [http://eclipse.org/downloads Eclipse 3.6 or 3.7 IDE]
+
* [http://eclipse.org/downloads Eclipse 3.6 or higher IDE]
 
* [http://eclipse.org/egit/download/ EGit] team provider for git (recommended) or [http://git-scm.com/download git command line package].
 
* [http://eclipse.org/egit/download/ EGit] team provider for git (recommended) or [http://git-scm.com/download git command line package].
 
* [http://www.eclipse.org/m2e/download/ m2eclipse] for Maven support in the Eclipse IDE
 
* [http://www.eclipse.org/m2e/download/ m2eclipse] for Maven support in the Eclipse IDE
Line 23: Line 23:
 
[[Image:Lyo-rio-import-projects.png]]
 
[[Image:Lyo-rio-import-projects.png]]
  
== Build the projects ==
+
== Build the projects ==
* In the Eclipse Package Explorer view, select all RIO projects, right click and select Maven->Update Project Configuration and click OK
+
 
* Build each project starting with org.eclipse.lyo.rio.core
+
*In the Eclipse Package Explorer view, select all RIO projects, right click and select Maven-&gt;Update Project Configuration and click OK  
** Expand the project  
+
*Build each project (in the order described below) as follows:
** Right click pom.xml and select Run As->Maven install. Depending on what plugins are in your Eclipse install, Maven might have to download dependencies
+
**Expand the project  
** After org.eclipse.lyo.rio.core, build org.eclipse.lyo.rio.template-webabb followed by the three reference webapps (CM, RM, AM) in any order.
+
**Right click pom.xml and select Run As-&gt;Maven install. (Depending on what plugins are in your Eclipse install, Maven might have to download dependencies.)
* If org.eclipse.lyo.rio.core still shows an error, right click the project and select Maven->Update Project Configuration again.
+
*Build order for RIO projects:
 +
** org.eclipse.lyo.rio.core
 +
** org.eclipse.lyo.rio.template-webapp
 +
** the others (e.g. AM, CM, RM), in any order
 +
*If org.eclipse.lyo.rio.core still shows an error, right click the project and select Maven-&gt;Update Project Configuration again.
 +
*'''IBM JVM/JRE Users:'''  There is an issue with m2eclipse and the the IBM JRE.  If you have see the error '''java.lang.NoClassDefFoundError: org.slf4j.impl.StaticLoggerBinder''' when running a Maven install, you need to copy a newer slf4j api jar into your JRE directory to work around the issue until it is fixed:
 +
** Download [http://slf4j.org/dist/slf4j-1.6.2.zip slf4j-1.6.2.zip] and extract the zip.
 +
** copy slf4j-api-1.6.2.jar from the slf4j distribution to the JAVA_HOME\jre\lib\ext directory
 +
** See https://bugs.eclipse.org/bugs/show_bug.cgi?id=338252 if you are interested in the details
 +
* '''If there is still a workspace error at this point, add target/generated-sources/antlr3 to the project build path.'''  This will be fixed by https://bugs.eclipse.org/bugs/show_bug.cgi?id=362524
  
 
== Run a reference implementation web application ==
 
== Run a reference implementation web application ==
Line 60: Line 69:
  
 
You should now be able to point a local web browser at '''http://localhost:8080/rio-cm''' and start working with the reference implementation.
 
You should now be able to point a local web browser at '''http://localhost:8080/rio-cm''' and start working with the reference implementation.
 +
 +
Ctrl-C will stop it.

Revision as of 15:54, 11 October 2012

Building and Running Lyo reference implementations (RIOs) in Eclipse

Prerequisites

Clone the Lyo RIO git repository

This example assumes EGit is being used

Lyo-rio-git-repo.png

  • On the Branch Selection page, select the master branch
  • On the Local Destination page, specify a location or accept the default and click Finish

The repository should now show up in your Git Repositories view

Import Eclipse projects from the git repository

  • In the Git Repositories view, right click org.eclipse.lyo.rio and select Import Projects
  • Select the Import Existing Projects wizard and click next
  • Select all components of RIO

Lyo-rio-import-projects.png

Build the projects

  • In the Eclipse Package Explorer view, select all RIO projects, right click and select Maven->Update Project Configuration and click OK
  • Build each project (in the order described below) as follows:
    • Expand the project
    • Right click pom.xml and select Run As->Maven install. (Depending on what plugins are in your Eclipse install, Maven might have to download dependencies.)
  • Build order for RIO projects:
    • org.eclipse.lyo.rio.core
    • org.eclipse.lyo.rio.template-webapp
    • the others (e.g. AM, CM, RM), in any order
  • If org.eclipse.lyo.rio.core still shows an error, right click the project and select Maven->Update Project Configuration again.
  • IBM JVM/JRE Users: There is an issue with m2eclipse and the the IBM JRE. If you have see the error java.lang.NoClassDefFoundError: org.slf4j.impl.StaticLoggerBinder when running a Maven install, you need to copy a newer slf4j api jar into your JRE directory to work around the issue until it is fixed:
  • If there is still a workspace error at this point, add target/generated-sources/antlr3 to the project build path. This will be fixed by https://bugs.eclipse.org/bugs/show_bug.cgi?id=362524

Run a reference implementation web application

This example is for the CM provider.

  • Select Run->Run Configurations and double click Maven Build
  • Give the configuration a name
  • Specify a base directory of ${workspace_loc:/org.eclipse.lyo.rio.cm} and a goal of jetty:run-exploded and Click Run

Lyo-rio-launch-config-2.png

You should now be able to point a local web browser at http://localhost:8080/rio-cm and start working with the reference implementation.

Building and Running the Lyo RIO project using Git and Maven

Prerequistes

Clone the RIO git repository

Build the projects

  • Build Core
    • cd to org.eclipse.lyo.rio.core in git repository
    • mvn install
    • cd to org.eclipse.lyo.rio.template-webapp in git repository
    • mvn install
  • Build CM RIO (for example)
    • cd to org.eclipse.lyo.rio.cm
    • mvn install

Run a reference implementation web application

    • cd to the desired RIO directory (am/cm/rm)
    • mvn jetty:run-exploded

You should now be able to point a local web browser at http://localhost:8080/rio-cm and start working with the reference implementation.

Ctrl-C will stop it.