View source for EPP/Obsolete/Wizard/Demonstration HowTo

== Introduction ==

This wiki page outlines the steps necessary to run the EPP Wizard.


== Setup ==

=== Eclipse ===

The EPP Wizard is currently being developed against Eclipse 3.5 ([http://wiki.eclipse.org/Galileo_Simultaneous_Release Due to release in June 2009]).  The CVS head version requires an [http://download.eclipse.org/eclipse/downloads/ Eclipse 3.5 SDK] >= 3.5M6. The P2 installer part of the EPP Wizard is being developed against Eclipse 3.4 (see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=262331 bug 262331] for more information).

=== Sources ===

The EPP Wizard relies on a number of additional projects.  A project file is provided to make downloading all of the dependencies easy:

# Download the [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.epp/plugins/org.eclipse.epp.wizard.releng/eppwizard.psf?root=Technology_Project&view=log Eclipse Project Set - "eppwizard.psf"] file and save it to your local machine by clicking on 'Download' next to the version number (Note: be sure to download the latest version).  
# In Eclipse go to File->Import->Team->Team Project Set and click on 'Next'.  
# In the next dialogue box click on 'Browse' and find the 'eppwizard.psf' file you downloaded earlier
# Then click on 'Finish' to import the set of projects that make up the EPP Wizard.  If you don't have write access to any of the repositories, use 'anonymous' as the user name and leave the password empty.

You might want to consider using a workspace devoted to just the EPP wizrd due to the number of projects that will be retrieved.

=== Target Platform ===

After downloading the sources the target platform have to be set up to Eclipse 3.5 (M6 or later). 
Download the latest stable 3.5 stream build of Eclipse at [http://download.eclipse.org/eclipse/downloads/].
The target platform can be defined by setting a preference. In Plug-in Development -> Target Platform point the field 'Location' to the downloaded 3.5 Eclipse.

=== Generate metadata (optional) ===

This step generates a metadata repository (essentially a file called content.xml) from IU definitions (see [[../Proposal for better P2 Integration]]).

This step can be started with the Launch configuration "Metadata generator.launch" (the launch configuration currently seems to contain unresolved bundles, and thus throw exceptions, the content generation should work anyway)

=== Repositories ===

The EPP wizard needs two different repository source, one for the standard Eclipse/Ganymede IUs and one for the EPP IUs create in the previous step (c.f. [[../RepositorySetup]]). Although the official update sites can be used for the former (standard), for testing it is more efficient to use a local mirror. The latter repository is basically just the generated content.xml accessible by a web server. The easiest thing to do is to set up a local Apache server and host the files from there.

=== Configuration ===

The project "org.eclipse.epp.wizard" contains two properties files for configuration (eppwizard.properties and installerbuilder.properties) that determine the configuration of the wizard. Usually only the paths and URLs need to be changed, see the comments in the files for further information. Note that the directory containing the content.xml described in the step above must be accessible at the property value of "epp.metadata", either via "file:" or "http:" protocol.

== Starting ==

The Launch configuration "EPP Wizard OSGi" launches an OSGi application with an embedded Jetty servlet container serving on port 8888. The EPP wizard can then be reached at [http://localhost:8888/rap http://localhost:8888/rap].


[[Category:EPP]]