Difference between revisions of "Lyo/BuildBugzilla"

From Eclipsepedia

< Lyo
Jump to: navigation, search
m
m (Prerequisites)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
This application is an example of what Eclipse Lyo can be used for, in the form of an OSLC-CM compatible adapter for the Bugzilla bugtracker application. It wraps Bugzilla (interacting with it through Bugzilla's native XMLRPC API) with an OSLC-CM provider server accessible through REST calls.
 +
 
= 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/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 12: Line 14:
  
 
*Open the Git Repositories view in Eclipse and click the Clone Git Repository icon  
 
*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.  
+
*Use <tt>git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.server.git</tt> as the URI (browse it also [http://git.eclipse.org/c/lyo/org.eclipse.lyo.server.git/ on line]). User/Password are not required.  
 
*On the Branch Selection page, select the master branch  
 
*On the Branch Selection page, select the master branch  
 
*On the Local Destination page, specify a location or accept the default and click Finish
 
*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.  
+
The repository should now show up in your Git Repositories view.
  
 
== Import Eclipse projects from the git repository  ==
 
== Import Eclipse projects from the git repository  ==
Line 37: Line 39:
  
 
*Edit org.eclipse.lyo.samples.bugzilla/src/main/resources/bugz.properties.  
 
*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 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.  
+
**Change the admin property to your user ID. This ID has authority to manage OAuth consumers.  
 
*Edit org.eclipse.lyo.samples.bugzilla/src/test/resources/test.properties.  
 
*Edit org.eclipse.lyo.samples.bugzilla/src/test/resources/test.properties.  
*Enter your ID and password for the JUnit tests.
+
**Enter your ID and password for the JUnit tests.
  
 
== Build the projects  ==
 
== Build the projects  ==
Line 60: Line 62:
 
**copy slf4j-api-1.6.2.jar from the slf4j distribution to the JAVA_HOME\jre\lib\ext directory  
 
**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
 
**See https://bugs.eclipse.org/bugs/show_bug.cgi?id=338252 if you are interested in the details
 +
 +
* You may need to check [http://git.eclipse.org/c/lyo/org.eclipse.lyo.server.git/tree/org.eclipse.lyo.samples.bugzilla/README.txtorg.eclipse.lyo.server.samples.bugzilla's README.txt] for instructions on how to install the missing <tt>j2bugzilla</tt> dependency in case the Maven install fails for this project.
  
 
== Run the Bugzilla sample web application  ==
 
== Run the Bugzilla sample web application  ==
Line 69: Line 73:
 
[[Image:BugzillaLaunch.png]]  
 
[[Image:BugzillaLaunch.png]]  
  
You should now be able to point a local web browser at '''http://localhost:8282/bugz'''.
+
You should now be able to point a local web browser at '''http://localhost:8282/bugz'''. See the [http://open-services.net/resources/tutorials/integrating-products-with-oslc/ OSLC Tutorial] for more about the Bugzilla adapter and OSLC.

Latest revision as of 15:11, 18 September 2012

This application is an example of what Eclipse Lyo can be used for, in the form of an OSLC-CM compatible adapter for the Bugzilla bugtracker application. It wraps Bugzilla (interacting with it through Bugzilla's native XMLRPC API) with an OSLC-CM provider server accessible through REST calls.

Contents

[edit] Building and Running the Lyo Bugzilla Sample in Eclipse

[edit] Prerequisites

[edit] 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 (browse it also on line). 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.

[edit] 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] 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.bugzilla/src/test/resources/test.properties.
    • Enter your ID and password for the JUnit tests.

[edit] 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:
  • You may need to check README.txt for instructions on how to install the missing j2bugzilla dependency in case the Maven install fails for this project.

[edit] 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. See the OSLC Tutorial for more about the Bugzilla adapter and OSLC.