blob: 826e11c4aab81407bf3127e0a4d16e103527f013 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="keywords" content="SMILA/Development Guidelines/How to set up integration environment,SMILA/Development Guidelines/Howto set up dev environment,SMILA/HowTo" />
<link rel="shortcut icon" href="http://wiki.eclipse.org/SMILA/Development_Guidelines/favicon.ico" />
<link rel="search" type="application/opensearchdescription+xml" href="http://wiki.eclipse.org/opensearch_desc.php" title="Eclipsepedia (English)" />
<link rel="alternate" type="application/rss+xml" title="Eclipsepedia RSS Feed" href="http://wiki.eclipse.org/index.php?title=Special:Recentchanges&amp;feed=rss" />
<link rel="alternate" type="application/atom+xml" title="Eclipsepedia Atom Feed" href="http://wiki.eclipse.org/index.php?title=Special:Recentchanges&amp;feed=atom" />
<title>SMILA/Development Guidelines/How to set up integration environment - Eclipsepedia</title>
<style type="text/css" media="screen,projection">/*<![CDATA[*/ @import "/skins/eclipsenova/novaWide.css?116"; /*]]>*/</style>
<link rel="stylesheet" type="text/css" media="print" href="http://wiki.eclipse.org/skins/eclipsenova/eclipsenovaPrint.css?116" />
<link rel="stylesheet" type="text/css" media="handheld" href="http://wiki.eclipse.org/skins/eclipsenova/handheld.css?116" />
<link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/Nova/css/header.css" media="screen" />
<link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/tabs.css" media="screen" />
<link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/Nova/css/visual.css" media="screen" />
<link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/Nova/css/layout.css" media="screen" />
<link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/Nova/css/footer.css" media="screen" />
<!--[if IE]><link rel="stylesheet" type="text/css" href="/skins/eclipsenova/IEpngfix.css" media="screen" /><![endif]-->
<!--[if lt IE 5.5000]><style type="text/css">@import "/skins/eclipsenova/IE50Fixes.css?116";</style> <![endif]-->
<!--[if IE 5.5000]><style type="text/css">@import "/skins/eclipsenova/IE55Fixes.css?116";</style><![endif]-->
<!--[if IE 6]><style type="text/css">@import "/skins/eclipsenova/IE60Fixes.css?116";</style><![endif]-->
<!--[if IE 7]><style type="text/css">@import "/skins/eclipsenova/IE70Fixes.css?116";</style><![endif]-->
<!--[if lt IE 7]><script type="text/javascript" src="/skins/common/IEFixes.js?116"></script>
<meta http-equiv="imagetoolbar" content="no" /><![endif]-->
<script type= "text/javascript">/*<![CDATA[*/
var skin = "eclipsenova";
var stylepath = "/skins";
var wgArticlePath = "/$1";
var wgScriptPath = "";
var wgScript = "/index.php";
var wgServer = "http://wiki.eclipse.org";
var wgCanonicalNamespace = "";
var wgCanonicalSpecialPageName = false;
var wgNamespaceNumber = 0;
var wgPageName = "SMILA/Development_Guidelines/How_to_set_up_integration_environment";
var wgTitle = "SMILA/Development Guidelines/How to set up integration environment";
var wgAction = "view";
var wgRestrictionEdit = [];
var wgRestrictionMove = [];
var wgArticleId = "18897";
var wgIsArticle = true;
var wgUserName = null;
var wgUserGroups = null;
var wgUserLanguage = "en";
var wgContentLanguage = "en";
var wgBreakFrames = false;
var wgCurRevisionId = "285364";
var wgVersion = "1.12.0";
var wgEnableAPI = true;
var wgEnableWriteAPI = false;
/*]]>*/</script>
<script type="text/javascript" src="http://wiki.eclipse.org/skins/common/wikibits.js?116"><!-- wikibits js --></script>
<!-- Performance mods similar to those for bug 166401 -->
<script type="text/javascript" src="http://wiki.eclipse.org/index.php?title=-&amp;action=raw&amp;gen=js&amp;useskin=eclipsenova"><!-- site js --></script>
<!-- Head Scripts -->
<script type="text/javascript" src="http://wiki.eclipse.org/skins/common/ajax.js?116"></script>
<link rel="stylesheet" type="text/css" href="How_to_set_up_integration_environment.html" /> </head>
<body class="mediawiki ns-0 ltr page-SMILA_Development_Guidelines_How_to_set_up_integration_environment">
<div id="globalWrapper">
<div id="column-one">
<!-- Eclipse Additions for the Top Nav start here M. Ward-->
<div id="header">
<div id="header-graphic">
<img src="http://wiki.eclipse.org/skins/eclipsenova/eclipse.png" alt="Eclipse Wiki">
</div>
<!-- Pulled 101409 Mward -->
<div class="portlet" id="p-personal">
<div class="pBody">
<ul>
<li id="pt-login"><a href="http://wiki.eclipse.org/index.php?title=Special:Userlogin&amp;returnto=SMILA/Development_Guidelines/How_to_set_up_integration_environment">Log in</a></li>
</ul>
</div>
</div>
<div id="header-icons">
<div id="sites">
<ul id="sitesUL">
<li><a href="http://www.eclipse.org"><img src="http://dev.eclipse.org/custom_icons/eclipseIcon.png" width="28" height="28" alt="Eclipse Foundation" title="Eclipse Foundation" /><div>Eclipse Foundation</div></a></li>
<li><a href="http://marketplace.eclipse.org"><img src="http://dev.eclipse.org/custom_icons/marketplace.png" width="28" height="28" alt="Eclipse Marketplace" title="Eclipse Marketplace" /><div>Eclipse Marketplace</div></a></li>
<li><a href="https://bugs.eclipse.org/bugs"><img src="http://dev.eclipse.org/custom_icons/system-search-bw.png" width="28" height="28" alt="Bugzilla" title="Bugzilla" /><div>Bugzilla</div></a></li>
<li><a href="http://live.eclipse.org"><img src="http://dev.eclipse.org/custom_icons/audio-input-microphone-bw.png" width="28" height="28" alt="Live" title="Live" /><div>Eclipse Live</div></a></li>
<li><a href="http://planeteclipse.org"><img src="http://dev.eclipse.org/large_icons/devices/audio-card.png" width="28" height="28" alt="PlanetEclipse" title="Planet" /><div>Planet Eclipse</div></a></li>
<li><a href="http://portal.eclipse.org"><img src="http://dev.eclipse.org/custom_icons/preferences-system-network-proxy-bw.png" width="28" height="28" alt="Portal" title="Portal" /><div>My Foundation Portal</div></a></li>
</ul>
</div>
</div>
</div>
<!-- NEW HEADER STUFF HERE -->
<div id="header-menu">
<div id="header-nav">
<ul> <li><a class="first_one" href="http://wiki.eclipse.org/" target="_self">Home</a></li> <li><a href="http://www.eclipse.org/downloads/" target="_self">Downloads</a></li>
<li><a href="http://www.eclipse.org/users/" target="_self">Users</a></li>
<li><a href="http://www.eclipse.org/membership/" target="_self">Members</a></li>
<li><a href="http://wiki.eclipse.org/index.php/Development_Resources" target="_self">Committers</a></li>
<li><a href="http://www.eclipse.org/resources/" target="_self">Resources</a></li>
<li><a href="http://www.eclipse.org/projects/" target="_self">Projects</a></li>
<li><a href="http://www.eclipse.org/org/" target="_self">About Us</a></li>
</ul>
</div>
<div id="header-utils">
<!-- moved the search window here -->
<form action="http://wiki.eclipse.org/Special:Search" >
<input class="input" name="search" type="text" accesskey="f" value="" />
<input type='submit' onclick="this.submit();" name="go" id="searchGoButton" class="button" title="Go to a page with this exact name if one exists" value="Go" />&nbsp;
<input type='submit' onclick="this.submit();" name="fulltext" class="button" id="mw-searchButton" title="Search Eclipsepedia for this text" value="Search" />
</form>
</div>
</div>
<!-- Eclipse Additions for the Header stop here -->
<!-- Additions and mods for leftside nav Start here -->
<!--Started nav rip here-->
<!-- these are the nav controls main page, changes etc -->
<div id="novaContent" class="faux">
<div id="leftcol">
<ul id="leftnav">
<!-- these are the page controls, edit history etc -->
<li class="separator"><a class="separator">Navigation &#160;&#160;</li>
<li id="n-mainpage"><a href="http://wiki.eclipse.org/Main_Page">Main Page</a></li>
<li id="n-portal"><a href="http://wiki.eclipse.org/Eclipsepedia:Community_Portal">Community portal</a></li>
<li id="n-currentevents"><a href="http://wiki.eclipse.org/Eclipsepedia:Current_events">Current events</a></li>
<li id="n-recentchanges"><a href="http://wiki.eclipse.org/Special:Recentchanges">Recent changes</a></li>
<li id="n-randompage"><a href="http://wiki.eclipse.org/Special:Random">Random page</a></li>
<li id="n-help"><a href="http://wiki.eclipse.org/Help:Contents">Help</a></li>
<li class="separator"><a class="separator">Toolbox &#160;&#160;</a></li>
<li id="t-whatlinkshere"><a href="http://wiki.eclipse.org/Special:Whatlinkshere/SMILA/Development_Guidelines/How_to_set_up_integration_environment">What links here</a></li>
<li id="t-recentchangeslinked"><a href="http://wiki.eclipse.org/Special:Recentchangeslinked/SMILA/Development_Guidelines/How_to_set_up_integration_environment">Related changes</a></li>
<!-- This is the toolbox section -->
<li id="t-upload"><a href="http://wiki.eclipse.org/Special:Upload">Upload file</a></li>
<li id="t-specialpages"><a href="http://wiki.eclipse.org/Special:Specialpages">Special pages</a></li>
<li id="t-print"><a href="http://wiki.eclipse.org/index.php?title=SMILA/Development_Guidelines/How_to_set_up_integration_environment&amp;printable=yes">Printable version</a></li> <li id="t-permalink"><a href="http://wiki.eclipse.org/index.php?title=SMILA/Development_Guidelines/How_to_set_up_integration_environment&amp;oldid=285364">Permanent link</a></li> </ul>
</div>
<!-- Additions and mods for leftside nav End here -->
<div id="column-content">
<div id="content">
<a name="top" id="top"></a>
<div id="tabs">
<ul class="primary">
<li class="active"><a href="How_to_set_up_integration_environment.html"><span class="tab">Page</span></a></li>
<li><a href="http://wiki.eclipse.org/index.php?title=Talk:SMILA/Development_Guidelines/How_to_set_up_integration_environment&amp;action=edit"><span class="tab">Discussion</span></a></li>
<li><a href="http://wiki.eclipse.org/index.php?title=SMILA/Development_Guidelines/How_to_set_up_integration_environment&amp;action=edit"><span class="tab">View source</span></a></li>
<li><a href="http://wiki.eclipse.org/index.php?title=SMILA/Development_Guidelines/How_to_set_up_integration_environment&amp;action=history"><span class="tab">History</span></a></li>
<li><a href="http://wiki.eclipse.org/index.php?title=Special:Userlogin&amp;returnto=SMILA/Development%20Guidelines/How%20to%20set%20up%20integration%20environment"><span class="tab">Edit</span></a></li>
</ul>
</div>
<script type="text/javascript"> if (window.isMSIE55) fixalpha(); </script>
<h1 class="firstHeading">SMILA/Development Guidelines/How to set up integration environment</h1>
<div id="bodyContent">
<h3 id="siteSub">From Eclipsepedia</h3>
<div id="contentSub"><span class="subpages">&lt; <a href="../../SMILA.html" title="SMILA">SMILA</a> | <a href="../Development_Guidelines.1.html" title="SMILA/Development Guidelines">Development Guidelines</a></span></div>
<div id="jump-to-nav">Jump to: <a href="How_to_set_up_integration_environment.html#column-one">navigation</a>, <a href="How_to_set_up_integration_environment.html#searchInput">search</a></div> <!-- start content -->
<p>
</p>
<div class="messagebox" style="background-color: #def3fe; border: 1px solid #c5d7e0; color: black; padding: 5px; margin: 1ex 0; min-height: 35px; padding-left: 45px;">
<div style="float: left; margin-left: -40px;"><a href="http://wiki.eclipse.org/Image:Note.png" class="image" title="Note.png"><img alt="" src="http://wiki.eclipse.org/images/c/cc/Note.png" width="35" height="35" border="0" /></a></div>
<div><b>This is outdated, please refer to <a href="Howto_set_up_dev_environment.html" class="mw-redirect" title="SMILA/Development Guidelines/Howto set up dev environment">How to set up the development environment</a></b><br /></div>
</div>
<p>This how-to describes the necessary steps for setting up SMILA integration environment. Normally this setup is only interesting for SMILA integrators who just want to integrate their components in SMILA. SMILA committers and contributors should work with another setup described at <a href="Howto_set_up_dev_environment.html" class="mw-redirect" title="SMILA/Development Guidelines/Howto set up dev environment">How to set up the development environment</a>.
</p>
<table id="toc" class="toc" summary="Contents"><tr><td><div id="toctitle"><h2>Contents</h2></div>
<ul>
<li class="toclevel-1"><a href="How_to_set_up_integration_environment.html#Preconditions"><span class="tocnumber">1</span> <span class="toctext">Preconditions</span></a></li>
<li class="toclevel-1"><a href="How_to_set_up_integration_environment.html#Install_the_binary_distribution"><span class="tocnumber">2</span> <span class="toctext">Install the binary distribution</span></a></li>
<li class="toclevel-1"><a href="How_to_set_up_integration_environment.html#Create_a_new_Workspace_and_setup_target_platform"><span class="tocnumber">3</span> <span class="toctext">Create a new Workspace and setup target platform</span></a></li>
<li class="toclevel-1"><a href="How_to_set_up_integration_environment.html#Create_a_launch_configuration_for_SMILA"><span class="tocnumber">4</span> <span class="toctext">Create a launch configuration for SMILA</span></a></li>
</ul>
</td></tr></table><script type="text/javascript"> if (window.showTocToggle) { var tocShowText = "show"; var tocHideText = "hide"; showTocToggle(); } </script>
<a name="Preconditions"></a><h4> <span class="mw-headline"> Preconditions </span></h4>
<p>Here is the list of things that you will definitely need for developing SMILA components:
</p>
<ol><li>JDK 1.6
</li><li>Eclipse SDK - This howto was tested with <a href="http://download.eclipse.org/eclipse/downloads/drops/R-3.7.1-201109091335/index.php" class="external text" title="http://download.eclipse.org/eclipse/downloads/drops/R-3.7.1-201109091335/index.php" rel="nofollow">Eclipse SDK 3.7.1 (Indigo SR1)</a> (it might still work with Eclipse SDK 3.6.2, too).
</li><li>SMILA binary distribution
</li></ol>
<a name="Install_the_binary_distribution"></a><h4> <span class="mw-headline"> Install the binary distribution </span></h4>
<p>Just pick up the latest binary distribution of SMILA:
</p>
<ul><li> <a href="http://www.eclipse.org/smila/downloads.php" class="external text" title="http://www.eclipse.org/smila/downloads.php" rel="nofollow">release 0.9 or higher</a> or
</li><li> <a href="http://build.eclipse.org/rt/smila/nightly/" class="external text" title="http://build.eclipse.org/rt/smila/nightly/" rel="nofollow">nightly build</a>
</li></ul>
<p>Simply unzip the file you downloaded into a new directory on your local hard disk and you've done with the installation.
</p>
<a name="Create_a_new_Workspace_and_setup_target_platform"></a><h4> <span class="mw-headline"> Create a new Workspace and setup target platform </span></h4>
<p>Extract your eclipse SDK (be sure, it's just the plain SDK and no JEE-IDE) into another directory, named e.g. eclipse-SDK). This will save you lots of trouble when setting up the target environment.
</p><p>Start your Eclipse SDK and create a new workspace at a location of your choice. Then use the SMILA binaries as the target platform for plugin develoment. This enables you to create own bundles that can use the code in the SMILA bundles:
</p><p><b>To set up the target platform</b>
</p>
<ul><li> Open "Windows" -&gt; "Preferences".
</li><li> Select "Plug-in Development" --&gt; "Target Platform" --&gt; "Add".
</li><li> Initialize the target definition with: "Nothing --&gt; Next".
</li><li> Enter a reasonable name (how about "SMILA", maybe?&nbsp;;-).
</li><li> In the "Locations" tab, click "Add".
<ul><li> Select "Installation" --&gt; Click "Next".
</li><li> Click "Browse" and navigate to the directory where you installed SMILA (do not press &lt;Enter&gt; yet).
</li><li> --&gt; Click "Finish".
</li></ul>
</li><li> Back on the "Locations" tab, click "Add" again.
<ul><li> Select "Features" --&gt; Click "Next"
</li><li> Click "Browse..." and select the eclipse-SDK (see above) and click OK.
</li><li> Select the features "org.eclipse.jdt" and "org.eclipse.platform".
</li><li> --&gt; Click "Finish"
</li></ul>
</li><li> Switch to the "Content" tab:
<ul><li> Filter for "junit" and deselect the bundles "org.junit (4.8.1)" and "org.junit4 (4.8.1)". Only "org.junit (3.8.2)" must be selected.
</li></ul>
</li><li> --&gt; Click "Finish"
</li><li> Select the new target platform.
</li><li> --&gt; Click "OK", you're done.
</li></ul>
<a name="Create_a_launch_configuration_for_SMILA"></a><h4> <span class="mw-headline"> Create a launch configuration for SMILA </span></h4>
<p>Getting right the launch configuration for SMILA is a bit tedious, so we prepared an example package:
</p><p><b>To import the example package</b>
</p>
<ul><li> Either checkout the contents of <a href="https://dev.eclipse.org/svnroot/rt/org.eclipse.smila/trunk/examples" class="external free" title="https://dev.eclipse.org/svnroot/rt/org.eclipse.smila/trunk/examples" rel="nofollow">https://dev.eclipse.org/svnroot/rt/org.eclipse.smila/trunk/examples</a> from our SVN repository into your workspace and your finished.
</li><li> Or download them as one package from <a href="http://www.eclipse.org/downloads/download.php?file=/rt/smila/releases/0.9/SMILA-0.9-integrator-examples.zip" class="external text" title="http://www.eclipse.org/downloads/download.php?file=/rt/smila/releases/0.9/SMILA-0.9-integrator-examples.zip" rel="nofollow">0.9 release</a> or <a href="http://build.eclipse.org/rt/smila/nightly/SMILA-integrator-examples.zip" class="external text" title="http://build.eclipse.org/rt/smila/nightly/SMILA-integrator-examples.zip" rel="nofollow">nightly build</a>, unzip them, and do the following:
<ul><li>Select "File" &gt; "Import".
</li><li>Select "General" &gt; "Existing Projects into Workspace" and click "Next".
</li><li>Click "Browse", navigate to the folder where you have unpacked the ZIP.
</li><li>Confirm with "OK".
</li><li>Select all projects, enable the option "Copy projects into workspace", and click "Finish".
</li></ul>
</li><li>Now you should have the following projects in your workspace:
<ul><li><tt>org.eclipse.smila.integration.feature</tt>
</li><li><tt>org.eclipse.smila.integration.pipelet</tt>
</li><li><tt>org.eclipse.smila.integration.worker</tt>
</li><li><tt>org.eclipse.smila.integration.worker.test</tt>
</li><li><tt>SMILA.application</tt>
</li></ul>
</li></ul>
<p>To launch SMILA, you need only the "SMILA.application" project. The other bundles contain examples for developing integration components like workers, pipelets, etc.
</p><p><b>To launch SMILA</b>
</p>
<ul><li> Select "Run" -&gt; "Run Configurations" or "Debug Configurations".
</li><li> Select "OSGi Frameworks" -&gt; "SMILA".
</li><li> Click "Run" or "Debug" and SMILA should start just like when started from the command line.
</li></ul>
<p>Find the configuration of this SMILA instance in your workspace in "SMILA.application/configuration".
</p><p>For further information on implementing in SMILA see the <a href="../HowTo.html" class="mw-redirect" title="SMILA/HowTo">HowTo manuals</a>.
</p>
<!--
NewPP limit report
Preprocessor node count: 46/1000000
Post-expand include size: 973/2097152 bytes
Template argument size: 443/2097152 bytes
#ifexist count: 0/100
-->
<!-- Saved in parser cache with key wikidb:pcache:idhash:18897-0!1!0!!en!2!edit=0 and timestamp 20120203101410 -->
<div class="printfooter">
Retrieved from "<a href="How_to_set_up_integration_environment.html">http://wiki.eclipse.org/SMILA/Development_Guidelines/How_to_set_up_integration_environment</a>"</div>
<div id="catlinks"><p class='catlinks'><a href="http://wiki.eclipse.org/Special:Categories" title="Special:Categories">Category</a>: <span dir='ltr'><a href="http://wiki.eclipse.org/Category:SMILA" title="Category:SMILA">SMILA</a></span></p></div> <!-- end content -->
<div class="visualClear"></div>
</div>
</div>
</div>
<!-- Yoink of toolbox for phoenix moved up -->
</div>
</div>
<div id="clearFooter"/>
<div id="footer" >
<ul id="footernav">
<li class="first"><a href="http://www.eclipse.org/">Home</a></li>
<li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
<li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
<li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
<li><a href="http://www.eclipse.org/org/foundation/contact.php">Contact</a></li>
<li><a href="http://wiki.eclipse.org/Eclipsepedia:About" title="Eclipsepedia:About">About Eclipsepedia</a></li>
</ul>
<span id="copyright">Copyright &copy; 2012 The Eclipse Foundation. All Rights Reserved</span>
<p id="footercredit">This page was last modified 09:52, 20 January 2012 by <a href="http://wiki.eclipse.org/User:Andreas.schank.attensity.com" title="User:Andreas.schank.attensity.com">A. Schank</a>. Based on work by <a href="http://wiki.eclipse.org/index.php?title=User:Juergen.schumacher.attensity.com&amp;action=edit" class="new" title="User:Juergen.schumacher.attensity.com">Juergen Schumacher</a>, <a href="http://wiki.eclipse.org/index.php?title=User:Nadine.auslaender.attensity.com&amp;action=edit" class="new" title="User:Nadine.auslaender.attensity.com"> </a> and <a href="http://wiki.eclipse.org/User:Drazen.cindric.attensity.com" title="User:Drazen.cindric.attensity.com">Drazen Cindric</a> and <a href="http://wiki.eclipse.org/index.php?title=SMILA/Development_Guidelines/How_to_set_up_integration_environment&amp;action=credits" title="SMILA/Development Guidelines/How to set up integration environment">others</a>.</p>
<p id="footerviews">This page has been accessed 3,594 times.</p>
</div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
var pageTracker = _gat._getTracker("UA-910670-4");
pageTracker._trackPageview();
</script>
<!-- <div class="visualClear"></div> -->
<script type="text/javascript">if (window.runOnloadHook) runOnloadHook();</script>
</div>
<!-- Served in 0.114 secs. --></body></html>