Difference between revisions of "Lyo/BuildBugzilla"

From Eclipsepedia

< Lyo
Jump to: navigation, search
(Building and Running the Lyo Bugzilla Sample in Eclipse)
Line 1: Line 1:
= Building and Running the Lyo Bugzilla Sample in Eclipse =
+
= Building and Running the Lyo Bugzilla Sample in Eclipse =
  
== Prerequisites ==
+
== Prerequisites ==
* [http://eclipse.org/downloads Eclipse 3.6 or 3.7 IDE]
+
* [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
+
  
== Clone the Lyo Server git repository ==
+
*[http://eclipse.org/downloads Eclipse 3.6 or 3.7 IDE]
This example assumes EGit is being used.
+
*[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
  
* Open the Git Repositories view in Eclipse and click the Clone Git Repository icon
+
== Clone the Lyo Server git repository ==
* Use git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.server.git as the URI. User/Password are not required.
+
* 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.
+
This example assumes EGit is being used.  
  
== Import Eclipse projects from the git repository ==
+
*Open the Git Repositories view in Eclipse and click the Clone Git Repository icon
* In the Git Repositories view, right click org.eclipse.lyo.server and select Import Projects
+
*Use git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.server.git as the URI. User/Password are not required.
* Select the Import Existing Projects wizard and click Next
+
*On the Branch Selection page, select the master branch
* Import the following projects:
+
*On the Local Destination page, specify a location or accept the default and click Finish
** org.eclipse.lyo.samples.bugzilla
+
 
** org.eclipse.lyo.server.oauth.consumerstore
+
The repository should now show up in your Git Repositories view.
** org.eclipse.lyo.server.oauth.core
+
 
** org.eclipse.lyo.server.oauth.webapp
+
== Import Eclipse projects from the git repository ==
 +
 
 +
*In the Git Repositories view, right click org.eclipse.lyo.server and select Import Projects  
 +
*Select the Import Existing Projects wizard and click Next  
 +
*Import the following projects:  
 +
**org.eclipse.lyo.samples.bugzilla  
 +
**org.eclipse.lyo.server.oauth.consumerstore  
 +
**org.eclipse.lyo.server.oauth.core  
 +
**org.eclipse.lyo.server.oauth.webapp
 +
 
 +
[[Image:BugzillaImport.png]]
 +
 
 +
*[Optional] Add the projects to a new working set.
 +
 
 +
== Edit the Bugzilla configuration  ==
 +
 
 +
The sample requires Bugzilla 4.0. By default, it uses the [http://landfill.bugzilla.org/ Bugzilla Landfill] test server, but you can specify your own.
 +
 
 +
*Edit org.eclipse.lyo.samples.bugzilla/src/main/resources/bugz.properties.
 +
*Change the bugzilla_uri property to the URL of your Bugzilla server.
 +
*Change the admin property to your user ID. This ID has authority to manage OAuth consumers.
 +
*Edit org.eclipse.lyo.samples.guzilla/src/test/resources/test.properties.
 +
*Enter your ID and password for the JUnit tests.
  
 
== Build the projects  ==
 
== Build the projects  ==
  
*In the Eclipse Package Explorer view, select all the projects you've imported, right click, and select Maven-&gt;Update Project Configuration. Click OK.
+
*In the Eclipse Package Explorer view, select all the projects you've imported, right click, and select Maven-&gt;Update Project Configuration. Click OK.  
*For each project,
+
*Run Maven Install on each project in this order,
 +
** org.eclipse.lyo.server.oauth.core
 +
** org.eclipse.lyo.server.oauth.consumerstore
 +
** org.eclipse.lyo.server.oauth.webapp
 +
** org.eclipse.lyo.server.samples.bugzilla
 +
*To run Maven Install,  
 
**Expand the project  
 
**Expand the project  
**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.
+
**Right click pom.xml and select Run As-&gt;Maven install.
*'''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
+
  
== Edit the Bugzilla configuration ==
+
[[Image:MavenInstall.png]]
  
The sample requires Bugzilla 4.0. By default, it uses the [http://landfill.bugzilla.org/ Bugzilla Landfill] test server, but you can specify your own.
+
*'''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
  
* Edit org.eclipse.lyo.samples.bugzilla/src/main/resources/bugz.properties.
+
== Run the Bugzilla sample web application  ==
* Change the bugzilla_uri property to the URL of your Bugzilla server.
+
* Change the admin property to your user ID. This ID has authority to manage OAuth consumers.
+
* Edit org.eclipse.lyo.samples.guzilla/src/test/resources/test.properties.
+
* Enter your ID and password for the JUnit tests.
+
  
== Run the Bugzilla sample web application ==
+
*Select Run-&gt;Run Configurations and double click Maven Build
 +
*Give the configuration a name
 +
*Specify a base directory of '''${workspace_loc:/org.eclipse.lyo.samples.bugzilla}''' and a goal of '''jetty:run-exploded''' and Click Run
  
* Select Run->Run Configurations and double click Maven Build
+
[[Image:BugzillaLaunch.png]]
* Give the configuration a name
+
* Specify a base directory of '''${workspace_loc:/org.eclipse.lyo.samples.bugzilla}''' and a goal of '''jetty:run-exploded''' and Click Run
+
  
You should now be able to point a local web browser at '''http://localhost:8888/bugz'''.
+
You should now be able to point a local web browser at '''http://localhost:8282/bugz'''.

Revision as of 13:12, 13 February 2012

Contents

Building and Running the Lyo Bugzilla Sample in Eclipse

Prerequisites

Clone the Lyo Server git repository

This example assumes EGit is being used.

  • Open the Git Repositories view in Eclipse and click the Clone Git Repository icon
  • Use git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.server.git as the URI. User/Password are not required.
  • 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.server and select Import Projects
  • Select the Import Existing Projects wizard and click Next
  • Import the following projects:
    • org.eclipse.lyo.samples.bugzilla
    • org.eclipse.lyo.server.oauth.consumerstore
    • org.eclipse.lyo.server.oauth.core
    • org.eclipse.lyo.server.oauth.webapp

BugzillaImport.png

  • [Optional] Add the projects to a new working set.

Edit the Bugzilla configuration

The sample requires Bugzilla 4.0. By default, it uses the Bugzilla Landfill test server, but you can specify your own.

  • Edit org.eclipse.lyo.samples.bugzilla/src/main/resources/bugz.properties.
  • Change the bugzilla_uri property to the URL of your Bugzilla server.
  • Change the admin property to your user ID. This ID has authority to manage OAuth consumers.
  • Edit org.eclipse.lyo.samples.guzilla/src/test/resources/test.properties.
  • Enter your ID and password for the JUnit tests.

Build the projects

  • In the Eclipse Package Explorer view, select all the projects you've imported, right click, and select Maven->Update Project Configuration. Click OK.
  • Run Maven Install on each project in this order,
    • org.eclipse.lyo.server.oauth.core
    • org.eclipse.lyo.server.oauth.consumerstore
    • org.eclipse.lyo.server.oauth.webapp
    • org.eclipse.lyo.server.samples.bugzilla
  • To run Maven Install,
    • Expand the project
    • Right click pom.xml and select Run As->Maven install.

MavenInstall.png

  • 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:

Run the Bugzilla sample web application

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

BugzillaLaunch.png

You should now be able to point a local web browser at http://localhost:8282/bugz.