blob: e4882f0ab59c9053088a2c60f00e397e7a96f7a3 [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/FAQ,SMILA/Documentation/HowTo/How to filter and access record data in BPEL,SMILA/Documentation/JettyHttpServer,SMILA/Project Concepts/Simple configuration handler" />
<link rel="shortcut icon" href="http://wiki.eclipse.org/SMILA/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/FAQ - Eclipsepedia</title>
<style type="text/css" media="screen,projection">/*<![CDATA[*/ @import "http://wiki.eclipse.org/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/FAQ";
var wgTitle = "SMILA/FAQ";
var wgAction = "view";
var wgRestrictionEdit = [];
var wgRestrictionMove = [];
var wgArticleId = "15796";
var wgIsArticle = true;
var wgUserName = null;
var wgUserGroups = null;
var wgUserLanguage = "en";
var wgContentLanguage = "en";
var wgBreakFrames = false;
var wgCurRevisionId = "322385";
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>
<style type="text/css">/*<![CDATA[*/
.source-text {line-height: normal; font-size: medium;}
.source-text li {line-height: normal;}
/**
* GeSHi Dynamically Generated Stylesheet
* --------------------------------------
* Dynamically generated stylesheet for text
* CSS class: source-text, CSS id:
* GeSHi (C) 2004 - 2007 Nigel McNie (http://qbnz.com/highlighter)
*/
.source-text .de1, .source-text .de2 {font-family: 'Courier New', Courier, monospace; font-weight: normal;}
.source-text {}
.source-text .head {}
.source-text .foot {}
.source-text .imp {font-weight: bold; color: red;}
.source-text .ln-xtra {color: #cc0; background-color: #ffc;}
.source-text li {font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;}
.source-text li.li2 {font-weight: bold;}
/*]]>*/
</style>
<style type="text/css">/*<![CDATA[*/
@import "http://wiki.eclipse.org/index.php?title=MediaWiki:Geshi.css&usemsgcache=yes&action=raw&ctype=text/css&smaxage=18000";
/*]]>*/
</style><style type="text/css">/*<![CDATA[*/
.source-java {line-height: normal; font-size: medium;}
.source-java li {line-height: normal;}
/**
* GeSHi Dynamically Generated Stylesheet
* --------------------------------------
* Dynamically generated stylesheet for java
* CSS class: source-java, CSS id:
* GeSHi (C) 2004 - 2007 Nigel McNie (http://qbnz.com/highlighter)
*/
.source-java .de1, .source-java .de2 {font-family: 'Courier New', Courier, monospace; font-weight: normal;}
.source-java {}
.source-java .head {}
.source-java .foot {}
.source-java .imp {font-weight: bold; color: red;}
.source-java .ln-xtra {color: #cc0; background-color: #ffc;}
.source-java li {font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;}
.source-java li.li2 {font-weight: bold;}
.source-java .kw1 {color: #7F0055; font-weight: bold;}
.source-java .kw2 {color: #7F0055; font-weight: bold;}
.source-java .kw3 {color: #000000; font-weight: normal}
.source-java .kw4 {color: #7F0055; font-weight: bold;}
.source-java .co1 {color: #3F7F5F; font-style: italic;}
.source-java .co2 {color: #3F7F5F;}
.source-java .co3 {color: #3F7F5F; font-style: italic; font-weight: bold;}
.source-java .coMULTI {color: #3F5FBF; font-style: italic;}
.source-java .es0 {color: #000000;}
.source-java .br0 {color: #000000;}
.source-java .st0 {color: #2A00ff;}
.source-java .nu0 {color: #000000;}
.source-java .me1 {color: #000000;}
.source-java .me2 {color: #000000;}
/*]]>*/
</style>
<style type="text/css">/*<![CDATA[*/
@import "http://wiki.eclipse.org/index.php?title=MediaWiki:Geshi.css&usemsgcache=yes&action=raw&ctype=text/css&smaxage=18000";
/*]]>*/
</style><link rel="stylesheet" type="text/css" href="FAQ.html" /> </head>
<body class="mediawiki ns-0 ltr page-SMILA_FAQ">
<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/FAQ">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/FAQ">What links here</a></li>
<li id="t-recentchangeslinked"><a href="http://wiki.eclipse.org/Special:Recentchangeslinked/SMILA/FAQ">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/FAQ&amp;printable=yes">Printable version</a></li> <li id="t-permalink"><a href="http://wiki.eclipse.org/index.php?title=SMILA/FAQ&amp;oldid=322385">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="FAQ.html"><span class="tab">Page</span></a></li>
<li><a href="http://wiki.eclipse.org/index.php?title=Talk:SMILA/FAQ&amp;action=edit"><span class="tab">Discussion</span></a></li>
<li><a href="http://wiki.eclipse.org/index.php?title=SMILA/FAQ&amp;action=edit"><span class="tab">View source</span></a></li>
<li><a href="http://wiki.eclipse.org/index.php?title=SMILA/FAQ&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/FAQ"><span class="tab">Edit</span></a></li>
</ul>
</div>
<script type="text/javascript"> if (window.isMSIE55) fixalpha(); </script>
<h1 class="firstHeading">SMILA/FAQ</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></span></div>
<div id="jump-to-nav">Jump to: <a href="FAQ.html#column-one">navigation</a>, <a href="FAQ.html#searchInput">search</a></div> <!-- start content -->
<p>This pages contains the frequently asked questions of the SMILA project.
</p><p><b>General Hint:</b> When you have problems during a SMILA launch / run, please have a look at the <b>SMILA log</b> file first. (<tt>&lt;SMILA&gt;/SMILA.log</tt>)
</p>
<table id="toc" class="toc" summary="Contents"><tr><td><div id="toctitle"><h2>Contents</h2></div>
<ul>
<li class="toclevel-1"><a href="FAQ.html#General"><span class="tocnumber">1</span> <span class="toctext">General</span></a>
<ul>
<li class="toclevel-2"><a href="FAQ.html#Where_do_I_find_the_log_file.3F"><span class="tocnumber">1.1</span> <span class="toctext">Where do I find the log file?</span></a></li>
<li class="toclevel-2"><a href="FAQ.html#How_can_I_see_that_SMILA_started_correctly.3F"><span class="tocnumber">1.2</span> <span class="toctext">How can I see that SMILA started correctly?</span></a></li>
</ul>
</li>
<li class="toclevel-1"><a href="FAQ.html#Building_SMILA"><span class="tocnumber">2</span> <span class="toctext">Building SMILA</span></a>
<ul>
<li class="toclevel-2"><a href="FAQ.html#I_receive_an_Out_of_Memory_error.3F_What_can_I_do.3F"><span class="tocnumber">2.1</span> <span class="toctext">I receive an Out of Memory error? What can I do?</span></a></li>
<li class="toclevel-2"><a href="FAQ.html#Build_fails_with_.27java.net.MalformedURLException:_no_protocol:_.24.7BeclipseBaseURL.7D.27_message"><span class="tocnumber">2.2</span> <span class="toctext">Build fails with 'java.net.MalformedURLException: no protocol: ${eclipseBaseURL}' message</span></a></li>
</ul>
</li>
<li class="toclevel-1"><a href="FAQ.html#Launching_SMILA"><span class="tocnumber">3</span> <span class="toctext">Launching SMILA</span></a>
<ul>
<li class="toclevel-2"><a href="FAQ.html#Linux"><span class="tocnumber">3.1</span> <span class="toctext">Linux</span></a>
<ul>
<li class="toclevel-3"><a href="FAQ.html#How_to_start.2Fstop_and_manage_SMILA_as_a_background_process_on_a_Linux_machine.3F"><span class="tocnumber">3.1.1</span> <span class="toctext">How to start/stop and manage SMILA as a background process on a Linux machine?</span></a></li>
</ul>
</li>
<li class="toclevel-2"><a href="FAQ.html#Bundles"><span class="tocnumber">3.2</span> <span class="toctext">Bundles</span></a>
<ul>
<li class="toclevel-3"><a href="FAQ.html#new_bundle_was_not_started"><span class="tocnumber">3.2.1</span> <span class="toctext">new bundle was not started</span></a></li>
<li class="toclevel-3"><a href="FAQ.html#I_changed_bundle_settings_in_my_config.ini.2C_but_after_SMILA_restart_nothing_changed"><span class="tocnumber">3.2.2</span> <span class="toctext">I changed bundle settings in my config.ini, but after SMILA restart nothing changed</span></a></li>
</ul>
</li>
</ul>
</li>
<li class="toclevel-1"><a href="FAQ.html#Configuring.2FRunning_SMILA"><span class="tocnumber">4</span> <span class="toctext">Configuring/Running SMILA</span></a>
<ul>
<li class="toclevel-2"><a href="FAQ.html#Basics"><span class="tocnumber">4.1</span> <span class="toctext">Basics</span></a>
<ul>
<li class="toclevel-3"><a href="FAQ.html#How_do_I_change_the_HTTP_port_of_SMILA.3F"><span class="tocnumber">4.1.1</span> <span class="toctext">How do I change the HTTP port of SMILA?</span></a></li>
</ul>
</li>
<li class="toclevel-2"><a href="FAQ.html#Crawler"><span class="tocnumber">4.2</span> <span class="toctext">Crawler</span></a>
<ul>
<li class="toclevel-3"><a href="FAQ.html#I_started_a_crawl_job.2C_the_job_was_started_successfully.2C_but_nothing_seems_to_happen"><span class="tocnumber">4.2.1</span> <span class="toctext">I started a crawl job, the job was started successfully, but nothing seems to happen</span></a></li>
</ul>
</li>
<li class="toclevel-2"><a href="FAQ.html#Pipeline"><span class="tocnumber">4.3</span> <span class="toctext">Pipeline</span></a>
<ul>
<li class="toclevel-3"><a href="FAQ.html#Why_do_I_get_a_timeout_exception_during_a_.28long_running.29_pipeline_execution.3F"><span class="tocnumber">4.3.1</span> <span class="toctext">Why do I get a timeout exception during a (long running) pipeline execution?</span></a></li>
<li class="toclevel-3"><a href="FAQ.html#My_xpath_expression_doesnt_work"><span class="tocnumber">4.3.2</span> <span class="toctext">My xpath expression doesnt work</span></a></li>
</ul>
</li>
</ul>
</li>
<li class="toclevel-1"><a href="FAQ.html#Implementing_Pipelets_.2F_OSGi_Services_.2F_Bundles"><span class="tocnumber">5</span> <span class="toctext">Implementing Pipelets / OSGi Services / Bundles</span></a>
<ul>
<li class="toclevel-2"><a href="FAQ.html#Configuration"><span class="tocnumber">5.1</span> <span class="toctext">Configuration</span></a>
<ul>
<li class="toclevel-3"><a href="FAQ.html#I_want_to_use_the_ConfigUtils_class_in_my_Pipelet_to_read_the_configuration.2C_where_do_I_have_to_put_my_configuration_files.3F"><span class="tocnumber">5.1.1</span> <span class="toctext">I want to use the ConfigUtils class in my Pipelet to read the configuration, where do I have to put my configuration files?</span></a></li>
</ul>
</li>
<li class="toclevel-2"><a href="FAQ.html#Deploy_.2F_Launch"><span class="tocnumber">5.2</span> <span class="toctext">Deploy / Launch</span></a>
<ul>
<li class="toclevel-3"><a href="FAQ.html#I_implemented.2Fdeployed_a_OSGi_Service_in_a_new_bundle_but_SMILA_log_says_that_it_couldn.27t_be_found"><span class="tocnumber">5.2.1</span> <span class="toctext">I implemented/deployed a OSGi Service in a new bundle but SMILA log says that it couldn't be found</span></a></li>
<li class="toclevel-3"><a href="FAQ.html#I_get_classloading_errors_in_invocations_of_my_own_Pipelet_when_running_SMILA_outside_the_IDE._In_the_IDE_it_works"><span class="tocnumber">5.2.2</span> <span class="toctext">I get classloading errors in invocations of my own Pipelet when running SMILA outside the IDE. In the IDE it works</span></a></li>
<li class="toclevel-3"><a href="FAQ.html#I_get_classloading_errors_when_I_try_to_access_an_external_Web_Service_using_JAX-WS"><span class="tocnumber">5.2.3</span> <span class="toctext">I get classloading errors when I try to access an external Web Service using JAX-WS</span></a></li>
<li class="toclevel-3"><a href="FAQ.html#More_classloader_errors_-_part_1"><span class="tocnumber">5.2.4</span> <span class="toctext">More classloader errors - part 1</span></a></li>
</ul>
</li>
</ul>
</li>
</ul>
</td></tr></table><script type="text/javascript"> if (window.showTocToggle) { var tocShowText = "show"; var tocHideText = "hide"; showTocToggle(); } </script>
<a name="General"></a><h2> <span class="mw-headline"> General </span></h2>
<a name="Where_do_I_find_the_log_file.3F"></a><h3> <span class="mw-headline"> Where do I find the log file? </span></h3>
<p>The SMILA log file's name is <tt>SMILA.log</tt> and is to be found at the applications working folder:
</p><p>If you extracted SMILA from a zip, you can find the log file in the folder, where you extracted the SMILA.
</p>
<pre>
/&lt;SMILA&gt;
/about_files
/configuration
/features
/jmxclient
/plugins
/workspace
.eclipseproduct
...
SMILA
SMILA.ini
-&gt; SMILA.log &lt;-
</pre>
<p>If you started SMILA from within the Eclipse IDE using the launcher, you can find the log file at the project <tt>SMILA.application</tt> in your workspace.
</p>
<a name="How_can_I_see_that_SMILA_started_correctly.3F"></a><h3> <span class="mw-headline"> How can I see that SMILA started correctly? </span></h3>
<p>1. Open your browser at <code><a href="http://localhost:8080/smila" class="external free" title="http://localhost:8080/smila" rel="nofollow">http://localhost:8080/smila</a></code>, you should see a system state overview and links to different APIs.
</p><p>2. You should see no stacktraces in the log&nbsp;;) and it should end with an entry like the following if SMILA has just started:
</p>
<pre>
... INFO ... internal.HttpServiceImpl - HTTP server started successfully on port 8080.
</pre>
<a name="Building_SMILA"></a><h2> <span class="mw-headline"> Building SMILA </span></h2>
<a name="I_receive_an_Out_of_Memory_error.3F_What_can_I_do.3F"></a><h3> <span class="mw-headline"> I receive an <i>Out of Memory</i> error? What can I do? </span></h3>
<p>While building with <tt>SMILA.builder</tt> I receive the following errror message:
</p><p><code>Build Failed - Out of Memory - Java heap space</code>
</p><p>The reason for this is that Ant hasn´t enough heap space to build the project. You will have to expand the heap space by setting the VM arguments accordingly. In eclipse try the following:
</p>
<ol><li> Click <i>Open external tools dialog</i> and select your Ant build profile.
</li><li> Switch to the <i>JRE</i> tab and add the following VM arguments: <tt>-Xms40m -Xmx512m</tt>.
</li><li> Save and build again.
</li></ol>
<p><br />
</p>
<a name="Build_fails_with_.27java.net.MalformedURLException:_no_protocol:_.24.7BeclipseBaseURL.7D.27_message"></a><h3> <span class="mw-headline"> Build fails with 'java.net.MalformedURLException: no protocol: ${eclipseBaseURL}' message </span></h3>
<p>The complete error looks like this:
</p>
<div dir="ltr" style="text-align: left;"><pre class="source-text">...
build.core:
[java] Buildfile: /home/scum36/Eclipse/helios-sr2-build/plugins/org.eclipse.pde.build_3.6.2.R36x_20110203/scripts/productBuild/productBuild.xml
[java]
[java] main:
[java]
[java] preBuild:
[java]
[java] preSetup:
[java]
[java] checkLocalMaps:
[java]
[java] getMapFiles:
[java] [cvs] Caught exception: Cannot run program &quot;cvs&quot; (in directory &quot;/home/scum36/workspace/SMILA/smila.build/maps&quot;): java.io.IOException: error=2, No such file or directory
[java]
[java] postSetup:
[java]
[java] checkLocalBase:
[java]
[java] getBaseComponents:
[java]
[java] BUILD FAILED
[java] /home/scum36/Eclipse/helios-sr2-build/plugins/org.eclipse.pde.build_3.6.2.R36x_20110203/scripts/productBuild/productBuild.xml:33: The following error occurred while executing this line:
[java] /home/scum36/Eclipse/helios-sr2-build/plugins/org.eclipse.pde.build_3.6.2.R36x_20110203/scripts/build.xml:53: The following error occurred while executing this line:
[java] /home/scum36/workspace/SMILA/SMILA.builder/customTargets.xml:80: The following error occurred while executing this line:
[java] /home/scum36/workspace/SMILA/SMILA.builder/customTargets.xml:25: java.net.MalformedURLException: no protocol: ${eclipseBaseURL}
[java]
[java] Total time: 0 seconds
[java] An error has occurred. See the log file
[java] /home/scum36/workspace/.metadata/.log.</pre></div>
<p><br />
Probably you did forget to copy <code>build.properties.template</code> to <code>build.properties</code> in <code>SMILA.builder</code> and adapt it. See
<a href="Development_Guidelines/Howto_build_a_SMILA-Distribution.html#Setting_the_Target_Build_Platform" class="external text" title="http://wiki.eclipse.org/SMILA/Development_Guidelines/Howto_build_a_SMILA-Distribution#Setting_the_Target_Build_Platform" rel="nofollow">How to build SMILA</a>.
</p>
<a name="Launching_SMILA"></a><h2> <span class="mw-headline"> Launching SMILA </span></h2>
<a name="Linux"></a><h3> <span class="mw-headline"> Linux </span></h3>
<a name="How_to_start.2Fstop_and_manage_SMILA_as_a_background_process_on_a_Linux_machine.3F"></a><h4> <span class="mw-headline"> How to start/stop and manage SMILA as a background process on a Linux machine? </span></h4>
<p>Since the default configuration (stored in SMILA.ini) of the OSGi runtime (in our case Equinox) launcher expects that you execute it in foreground and therefore have an OSGi console running in your shell and listening to the standard input, the first thing we have to do is to advise the launcher (and thereby Equinox) to listen on some TCP port instead. This is done by adding a new line with the port number just after the "-console" line.
</p><p>For example, to set console to listen at TCP port 9999, SMILA.ini would look like this:
</p><p><code>
</p>
<pre>-console
9999
...
</pre>
<p></code>
</p><p>Now, after SMILA has been started with “<tt>$ nohup ./SMILA &amp;</tt>”, the console can be accessed from any computer simply by opening a telnet session:
</p><p><tt>
$ telnet &lt;smila_host_name&gt; &lt;console_port&gt;
</tt>
</p><p><br />
</p>
<table style="border:1px solid #AAA; background:#f9f9f9; width:100%; margin:0 auto 1em auto; padding:.2em; text-align:justify;">
<tr>
<td style="width:50px;"> <a href="http://wiki.eclipse.org/Image:Symbol_comment_vote.png" class="image" title="Symbol comment vote.png"><img alt="" src="http://wiki.eclipse.org/images/9/9e/Symbol_comment_vote.png" width="50" height="51" border="0" /></a>
</td><td style="padding-left:.2em;"> If you are logged in via telnet and just want to close this connection and not to stop Equinox running SMILA, than just type “<tt>disconnect</tt>”. Otherwise, if you want to stop SMILA and close the connection, use “<tt>close</tt>” - as you normally would do on a console running in your shell.
</td></tr></table>
<p>For the complete documentation on eclipse runtime options please see: <a href="http://help.eclipse.org/indigo/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/misc/runtime-options.html" class="external free" title="http://help.eclipse.org/indigo/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/misc/runtime-options.html" rel="nofollow">http://help.eclipse.org/indigo/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/misc/runtime-options.html</a>
</p>
<a name="Bundles"></a><h3> <span class="mw-headline"> Bundles </span></h3>
<a name="new_bundle_was_not_started"></a><h4> <span class="mw-headline"> new bundle was not started </span></h4>
<p>After launching SMILA my new bundle doesn't seem to be started.
</p><p>If you started <b><tt>SMILA.launch</tt></b> in eclipse to launch SMILA: The launcher didn't start your new bundle. Try this:
</p>
<ol><li> Add your bundle by selecting "Run Configurations" in eclipse and choose your SMILA profile.
</li><li> Select your bundle in the list and set the checkmark.
</li><li> Set the start level to "4" and the autostart to "true".
</li></ol>
<p>If you started <b><tt>SMILA.EXE</tt></b> to launch SMILA: Your bundle isn`t defined in <tt>config.ini</tt> or the start level isn´t correct. Try this:
</p>
<ol>
<li>Open the file <tt>configuration/config.ini</tt> and add your bundle as shown below:<br />
<code>org.eclipse.smila.connectivity.framework.crawler.owncrawler@5:start, \</code></li>
<li>Open the <tt>build.properties</tt> file of your bundle and include the folders <tt>schemas/</tt>, <tt>OSGI-INF/</tt>, and the file <tt>plugin.xml</tt>.</li>
</ol>
<a name="I_changed_bundle_settings_in_my_config.ini.2C_but_after_SMILA_restart_nothing_changed"></a><h4> <span class="mw-headline"> I changed bundle settings in my <tt>config.ini</tt>, but after SMILA restart nothing changed </span></h4>
<p>Check your <tt>config.ini</tt> for unusual whitespaces (e.g. a tab) between the (edited) bundle entries or after the backslashes on line ends - and remove them.
</p><p>If that doesn't help, see question (resp. answer) before.
</p><p><br />
</p>
<a name="Configuring.2FRunning_SMILA"></a><h2> <span class="mw-headline"> Configuring/Running SMILA </span></h2>
<a name="Basics"></a><h3> <span class="mw-headline"> Basics </span></h3>
<a name="How_do_I_change_the_HTTP_port_of_SMILA.3F"></a><h4> <span class="mw-headline"> How do I change the HTTP port of SMILA? </span></h4>
<p>The HTTP port is configured in fie <tt>configuration/org.eclipse.smila.clusterconfig.simple/clusterconfig.json</tt>. Change it there and restart SMILA.
</p><p>See <a href="Documentation/JettyHttpServer.html#Setting_the_HTTP_port" title="SMILA/Documentation/JettyHttpServer">SMILA/Documentation/JettyHttpServer#Setting_the_HTTP_port</a> for details.
</p>
<a name="Crawler"></a><h3> <span class="mw-headline"> Crawler </span></h3>
<a name="I_started_a_crawl_job.2C_the_job_was_started_successfully.2C_but_nothing_seems_to_happen"></a><h4> <span class="mw-headline"> I started a crawl job, the job was started successfully, but nothing seems to happen </span></h4>
<p>Check the SMILA log file for errors.
</p><p>Check the state of the crawl job in <a href="http://localhost:8080/smila/jobmanager/jobs" class="external text" title="http://localhost:8080/smila/jobmanager/jobs" rel="nofollow">jobmanager state API</a>
</p>
<ul><li> if the state in your crawl job is "RUNNING", check the mode it has been started
<ul><li> if it says <span style="font-family:monospace;">"mode": "STANDARD"</span>, stop the job run (<span style="font-family:monospace;">POST <a href="http://localhost:8080/smila/jobmanager/jobs/" class="external free" title="http://localhost:8080/smila/jobmanager/jobs/" rel="nofollow">http://localhost:8080/smila/jobmanager/jobs/</a>&lt;job name&gt;/&lt;job run id&gt;/finish</span>) and start it again with mode "runOnce", e.g. <span style="font-family:monospace;">POST <a href="http://localhost:8080/smila/jobmanager/jobs/" class="external free" title="http://localhost:8080/smila/jobmanager/jobs/" rel="nofollow">http://localhost:8080/smila/jobmanager/jobs/</a>&lt;job name&gt; {"mode": "runOnce"</span>}
</li></ul>
</li><li> if the state is FINISHING
<ul><li> check the job into which the crawl job pushes its records for processed records or errors.
</li></ul>
</li><li> if everything up to now is OK
<ul><li> just wait some time, the autocommit handler maybe hasn't yet committed the data to the Solr index
</li><li> check <span style="font-family:monospace;">autoCommit</span> settings in the <tt>solrconfig.xml</tt> file of your Solr core.
</li></ul>
</li></ul>
<a name="Pipeline"></a><h3> <span class="mw-headline"> Pipeline </span></h3>
<a name="Why_do_I_get_a_timeout_exception_during_a_.28long_running.29_pipeline_execution.3F"></a><h4> <span class="mw-headline"> Why do I get a timeout exception during a (long running) pipeline execution? </span></h4>
<p>In SMILA there's a timeout configured for a pipeline execution:
</p>
<dl><dd> <tt>configuration/org.eclipse.smila.processing.bpel/processor.properties</tt>
</dd></dl>
<p>See entry: <code>pipeline.timeout</code>
</p>
<a name="My_xpath_expression_doesnt_work"></a><h4> <span class="mw-headline"> My xpath expression doesnt work </span></h4>
<ol><li> Check that the expression is correct with a XPath tool
</li><li> ensure that the attributes are not filtered out, see <a href="Documentation/HowTo/How_to_filter_and_access_record_data_in_BPEL.html" title="SMILA/Documentation/HowTo/How to filter and access record data in BPEL">SMILA/Documentation/HowTo/How_to_filter_and_access_record_data_in_BPEL</a>
</li></ol>
<p><b>Helpful log points</b>
</p>
<table width="100%" style="font-family: Trebuchet MS;vertical-align:text-top;" border="1">
<tr style="font-weight:bold;font-size:larger;color:white;background:gray;text-align:center;">
<td> Area </td><td> id </td><td> level </td><td> Comment
</td></tr>
<tr>
<td> BPEL </td><td> org.eclipse.smila.processing.bpel.PipeletManager </td><td> debug </td><td> Log BPEL request XML before and after pipelet invocation. Note: this contains the XML for the records but only their filtered version.
</td></tr>
<tr>
<td> BPEL </td><td> org.eclipse.smila.processing.bpel.PipeletManager </td><td> trace</td><td> Log full XML of records after pipelet invocation. Note: this is the real thing unfiltered.
</td></tr></table>
<a name="Implementing_Pipelets_.2F_OSGi_Services_.2F_Bundles"></a><h2> <span class="mw-headline"> Implementing Pipelets / OSGi Services / Bundles </span></h2>
<a name="Configuration"></a><h3> <span class="mw-headline"> Configuration </span></h3>
<a name="I_want_to_use_the_ConfigUtils_class_in_my_Pipelet_to_read_the_configuration.2C_where_do_I_have_to_put_my_configuration_files.3F"></a><h4> <span class="mw-headline"> I want to use the <code>ConfigUtils</code> class in my Pipelet to read the configuration, where do I have to put my configuration files? </span></h4>
<p>Configuration files are searched for in the following order:
</p>
<ol><li> <tt>&lt;SMILA&gt;/configuration/&lt;bundle-name&gt;/&lt;config-file&gt;</tt>
</li><li> <tt>&lt;config-file&gt;</tt> in the root path of the bundle jar-file
</li></ol>
<p>See <a href="Project_Concepts/Simple_configuration_handler.html" title="SMILA/Project Concepts/Simple configuration handler">Configuration Handler</a> for more information.
</p>
<a name="Deploy_.2F_Launch"></a><h3> <span class="mw-headline"> Deploy / Launch </span></h3>
<a name="I_implemented.2Fdeployed_a_OSGi_Service_in_a_new_bundle_but_SMILA_log_says_that_it_couldn.27t_be_found"></a><h4> <span class="mw-headline"> I implemented/deployed a OSGi Service in a new bundle but SMILA log says that it couldn't be found </span></h4>
<p>Check your new bundle, it should contain a file like that:
</p>
<ul><li> <tt>OSGI-INF/&lt;myService&gt;.xml</tt>
</li></ul>
<p>In this file your new service has to be referenced. If you have copied the file from some other service, be sure to change the component name in the root element to something unique, because DS does not start multiple services with the same component name.
</p>
<ul><li> <tt>&lt;component name="&lt;myService&gt;" immediate="true"&gt;</tt>
</li></ul>
<p>Also the file has to be referenced from the MANIFEST.MF file of your bundle as a service component:
</p>
<ul><li> <tt>Service-Component: OSGI-INF/&lt;myService&gt;.xml</tt>
</li></ul>
<p>Also, you may need to include <tt>Import-Package:</tt> declarations for super-classes of your service implementation class even if there are no compile errors.
</p><p>On the "Build" page of the manifest editor, you must add the OSGI-INF directory to the binary build.
</p><p>And finally, your bundle has to be started at SMILA launch, e.g. by adding it to the config.ini.
</p><p>If you are using <b><tt>SMILA.launch</tt></b> to launch SMILA, you also have to open the run/debug configuration of SMILA, check the new bundle and set Auto-Start to "true".
</p>
<a name="I_get_classloading_errors_in_invocations_of_my_own_Pipelet_when_running_SMILA_outside_the_IDE._In_the_IDE_it_works"></a><h4> <span class="mw-headline"> I get classloading errors in invocations of my own Pipelet when running SMILA outside the IDE. In the IDE it works </span></h4>
<p>The error could look like this:
</p><p><code>
2010-11-19 11:28:36,101 ERROR [ODEServerImpl-1
] vpu.JacobVPU - Method "run" in class "org.apache.ode.bpel.rtrep.v2.EXTENSIONACTIVITY" threw an unexpected exception.
java.lang.LinkageError: loader constraint violation: loader (instance of org/eclipse/osgi/internal/baseadaptor/DefaultClassLoader) previously initiated loading for a different type with name "org/w3c/dom/Document"
</code>
</p><p>We are not completely sure, why this happens, but a solution is to set this system property in the SMILA.ini file:
</p><p><code>-Dosgi.java.profile.bootdelegation=override</code>
</p><p>Thamks to Bogdan Sacaleanu for the solution. See this <a href="http://smila.markmail.org/thread/sj4vhcikq2wndtdp" class="external text" title="http://smila.markmail.org/thread/sj4vhcikq2wndtdp" rel="nofollow">thread in the smila-dev mailing list</a> for additional details.
</p>
<a name="I_get_classloading_errors_when_I_try_to_access_an_external_Web_Service_using_JAX-WS"></a><h4> <span class="mw-headline"> I get classloading errors when I try to access an external Web Service using JAX-WS </span></h4>
<p>Class loading problems often occur when using third party libraries that use the "thread context classloader" in OSGi, and standard implementations of Java specifications by Sun/Oracle (or other non-OSGi-aware parties...) do this very often.
</p><p>The only solution we currently know of is to wrap the critical section (in this case it's the construction of the webservice client class) in a piece of code like this:
</p>
<div dir="ltr" style="text-align: left;"><pre class="source-java"><span class="kw3">ClassLoader</span> tccl = <span class="kw3">Thread</span>.<span class="me1">currentThread</span><span class="br0">&#40;</span><span class="br0">&#41;</span>.<span class="me1">getContextClassLoader</span><span class="br0">&#40;</span><span class="br0">&#41;</span>;
<span class="kw1">try</span> <span class="br0">&#123;</span>
<span class="kw3">Thread</span>.<span class="me1">currentThread</span><span class="br0">&#40;</span><span class="br0">&#41;</span>.<span class="me1">setContextClassLoader</span><span class="br0">&#40;</span>getClass<span class="br0">&#40;</span><span class="br0">&#41;</span>.<span class="me1">getClassLoader</span><span class="br0">&#40;</span><span class="br0">&#41;</span><span class="br0">&#41;</span>;
<span class="coMULTI">/*
* initialize the client
*/</span>
<span class="br0">&#125;</span> <span class="kw1">finally</span> <span class="br0">&#123;</span>
<span class="kw3">Thread</span>.<span class="me1">currentThread</span><span class="br0">&#40;</span><span class="br0">&#41;</span>.<span class="me1">setContextClassLoader</span><span class="br0">&#40;</span>tccl<span class="br0">&#41;</span>;
<span class="br0">&#125;</span></pre></div>
<p>See also <a href="http://www.eclipse.org/forums/index.php/t/266362/" class="external text" title="http://www.eclipse.org/forums/index.php/t/266362/" rel="nofollow">this forum thread</a>.
</p>
<a name="More_classloader_errors_-_part_1"></a><h4> <span class="mw-headline"> More classloader errors - part 1 </span></h4>
<p>If you get an error like this:
</p>
<div dir="ltr" style="text-align: left;"><pre class="source-text">Caused by: java.lang.LinkageError: loader constraint violation: when resolving field &quot;DATETIME&quot; the class loader (instance of
org/eclipse/osgi/internal/baseadaptor/DefaultClassLoader) of the referring class, javax/xml/datatype/DatatypeConstants, and the class loader (instance of &lt;bootloader&gt;) for the field's resolved type, javax/xml/namespace/QName, have different Class objects for that type</pre></div>
<p>the reason is most likely that you have classes in the bundle classpath of your bundle that contains classes which are also part of the JDK runtime library (java.*, javax.*). Remove these classes from the bundle and it should work.
</p><p>See also <a href="http://www.eclipse.org/forums/index.php/t/266362/" class="external text" title="http://www.eclipse.org/forums/index.php/t/266362/" rel="nofollow">this forum thread</a>.
</p>
<!--
NewPP limit report
Preprocessor node count: 116/1000000
Post-expand include size: 542/2097152 bytes
Template argument size: 185/2097152 bytes
#ifexist count: 0/100
-->
<!-- Saved in parser cache with key wikidb:pcache:idhash:15796-0!1!0!!en!2!edit=0 and timestamp 20130416072454 -->
<div class="printfooter">
Retrieved from "<a href="FAQ.html">http://wiki.eclipse.org/SMILA/FAQ</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; 2013 The Eclipse Foundation. All Rights Reserved</span>
<p id="footercredit">This page was last modified 10:38, 16 November 2012 by <a href="http://wiki.eclipse.org/User:Andreas.weber.empolis.com" title="User:Andreas.weber.empolis.com">Andreas Weber</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/User:Tmenzel.brox.de" title="User:Tmenzel.brox.de">thomas menzel</a> and <a href="http://wiki.eclipse.org/User:Andreas.schank.attensity.com" title="User:Andreas.schank.attensity.com">A. Schank</a> and <a href="http://wiki.eclipse.org/index.php?title=SMILA/FAQ&amp;action=credits" title="SMILA/FAQ">others</a>.</p>
<p id="footerviews">This page has been accessed 8,608 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.054 secs. --></body></html>