| <!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" /> |
| <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&feed=rss" /> |
| <link rel="alternate" type="application/atom+xml" title="Eclipsepedia Atom Feed" href="http://wiki.eclipse.org/index.php?title=Special:Recentchanges&feed=atom" /> |
| |
| |
| <title>SMILA/FAQ - 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/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 = "255522"; |
| 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=-&action=raw&gen=js&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="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&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" /> |
| <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   </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   </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&printable=yes">Printable version</a></li> <li id="t-permalink"><a href="http://wiki.eclipse.org/index.php?title=SMILA/FAQ&oldid=255522">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&action=edit"><span class="tab">Discussion</span></a></li> |
| <li><a href="http://wiki.eclipse.org/index.php?title=SMILA/FAQ&action=edit"><span class="tab">View source</span></a></li> |
| <li><a href="http://wiki.eclipse.org/index.php?title=SMILA/FAQ&action=history"><span class="tab">History</span></a></li> |
| <li><a href="http://wiki.eclipse.org/index.php?title=Special:Userlogin&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">< <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><SMILA>/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#Building_SMILA"><span class="tocnumber">1</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">1.1</span> <span class="toctext">I receive an Out of Memory error? What can I do?</span></a></li> |
| </ul> |
| </li> |
| <li class="toclevel-1"><a href="FAQ.html#Launching_SMILA"><span class="tocnumber">2</span> <span class="toctext">Launching SMILA</span></a> |
| <ul> |
| <li class="toclevel-2"><a href="FAQ.html#Linux"><span class="tocnumber">2.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">2.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">2.2</span> <span class="toctext">Bundles</span></a> |
| <ul> |
| <li class="toclevel-3"><a href="FAQ.html#Launching_crawler_bundles_-_How_to_solve:_.22Could_not_find_crawler_id.22_error_message.3F"><span class="tocnumber">2.2.1</span> <span class="toctext">Launching crawler bundles - How to solve: "Could not find crawler id" error message?</span></a></li> |
| <li class="toclevel-3"><a href="FAQ.html#I_changed_the_implementation_of_a_bundle.2C_deployed_it_and_restarted_SMILA.2C_but_SMILA_still_seems_to_use_the_old_bundle"><span class="tocnumber">2.2.2</span> <span class="toctext">I changed the implementation of a bundle, deployed it and restarted SMILA, but SMILA still seems to use the old bundle</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">2.2.3</span> <span class="toctext">I changed bundle settings in my config.ini, but after SMILA restart nothing changed</span></a></li> |
| </ul> |
| </li> |
| <li class="toclevel-2"><a href="FAQ.html#JConsole"><span class="tocnumber">2.3</span> <span class="toctext">JConsole</span></a> |
| <ul> |
| <li class="toclevel-3"><a href="FAQ.html#Why_is_the_SMILA_package_not_in_the_JConsole_tree.3F"><span class="tocnumber">2.3.1</span> <span class="toctext">Why is the SMILA package not in the JConsole tree?</span></a></li> |
| <li class="toclevel-3"><a href="FAQ.html#Why_is_the_SMILA.2FCrawlerController_MBean_not_in_the_JConsole_tree.3F"><span class="tocnumber">2.3.2</span> <span class="toctext">Why is the SMILA/CrawlerController MBean not in the JConsole tree?</span></a></li> |
| <li class="toclevel-3"><a href="FAQ.html#Cannot_connect_with_JConsole_to_a_remote_machine_running_Ubuntu_8.04_or_newer"><span class="tocnumber">2.3.3</span> <span class="toctext">Cannot connect with JConsole to a remote machine running Ubuntu 8.04 or newer</span></a></li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="toclevel-1"><a href="FAQ.html#Configuring.2FRunning_SMILA"><span class="tocnumber">3</span> <span class="toctext">Configuring/Running SMILA</span></a> |
| <ul> |
| <li class="toclevel-2"><a href="FAQ.html#Crawler"><span class="tocnumber">3.1</span> <span class="toctext">Crawler</span></a> |
| <ul> |
| <li class="toclevel-3"><a href="FAQ.html#I_tried_to_crawl.2Findex_a_data_source.2C_JConsole_says_.22Crawl_..._sucessfully_started.22_but_nothing_seems_to_happen"><span class="tocnumber">3.1.1</span> <span class="toctext">I tried to crawl/index a data source, JConsole says "Crawl ... sucessfully started" but nothing seems to happen</span></a></li> |
| </ul> |
| </li> |
| <li class="toclevel-2"><a href="FAQ.html#Pipeline"><span class="tocnumber">3.2</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">3.2.1</span> <span class="toctext">Why do I get a timeout exception during a (long running) pipeline execution?</span></a></li> |
| </ul> |
| </li> |
| <li class="toclevel-2"><a href="FAQ.html#Lucene_Indexing_.2F_Search"><span class="tocnumber">3.3</span> <span class="toctext">Lucene Indexing / Search</span></a> |
| <ul> |
| <li class="toclevel-3"><a href="FAQ.html#How_can_I_browse.2Fsearch_an_existing_Lucene_index_without_SMILA_.28for_debug_purposes.29.3F"><span class="tocnumber">3.3.1</span> <span class="toctext">How can I browse/search an existing Lucene index without SMILA (for debug purposes)?</span></a></li> |
| <li class="toclevel-3"><a href="FAQ.html#Why_are_attributes_in_my_Lucene_index_missing_.2F_permuted.3F"><span class="tocnumber">3.3.2</span> <span class="toctext">Why are attributes in my Lucene index missing / permuted?</span></a></li> |
| <li class="toclevel-3"><a href="FAQ.html#SMILA_doesn.27t_return_search_results.2C_although_I_see_appropriate_entries_for_.28some_fields_of.29_my_query_in_the_Lucene_index"><span class="tocnumber">3.3.3</span> <span class="toctext">SMILA doesn't return search results, although I see appropriate entries for (some fields of) my query in the Lucene index</span></a></li> |
| <li class="toclevel-3"><a href="FAQ.html#Test_search_application_.28http:.2F.2Flocalhost:8080.2FSMILA.2Fsearch.29_returns_HTTP_Status_500_with_the_stack_trace"><span class="tocnumber">3.3.4</span> <span class="toctext">Test search application (http://localhost:8080/SMILA/search) returns HTTP Status 500 with the stack trace</span></a></li> |
| <li class="toclevel-3"><a href="FAQ.html#.22Too_many_open_files.22_error_message"><span class="tocnumber">3.3.5</span> <span class="toctext">"Too many open files" error message</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">4</span> <span class="toctext">Implementing Pipelets / OSGi Services / Bundles</span></a> |
| <ul> |
| <li class="toclevel-2"><a href="FAQ.html#Configuration"><span class="tocnumber">4.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">4.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">4.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">4.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">4.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> |
| </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="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="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 &</tt>”, the console can be accessed from any computer simply by opening a telnet session: |
| </p><p><tt> |
| $ telnet <smila_host_name> <console_port> |
| </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/ganymede/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/misc/runtime-options.html" class="external free" title="http://help.eclipse.org/ganymede/index.jsp?topic=/org.eclipse.platform.doc.isv/reference/misc/runtime-options.html" rel="nofollow">http://help.eclipse.org/ganymede/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="Launching_crawler_bundles_-_How_to_solve:_.22Could_not_find_crawler_id.22_error_message.3F"></a><h4> <span class="mw-headline"> Launching crawler bundles - How to solve: "Could not find crawler id" error message? </span></h4> |
| <p>While launching SMILA I receive the following error message: |
| </p><p><code>Could not find crawler id</code> |
| </p><p>If you started <b><tt>SMILA.launch</tt></b> to launch SMILA: The launcher didn't start your new crawler bundle. Try this: |
| </p> |
| <ol><li> Add your bundle by selecting "Open Run dialog" 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>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_the_implementation_of_a_bundle.2C_deployed_it_and_restarted_SMILA.2C_but_SMILA_still_seems_to_use_the_old_bundle"></a><h4> <span class="mw-headline"> I changed the implementation of a bundle, deployed it and restarted SMILA, but SMILA still seems to use the old bundle </span></h4> |
| <p>Close SMILA, delete the following directories in your configuration folder and restart SMILA again: |
| </p> |
| <ul><li> <tt>org.eclipse.core.runtime/</tt> |
| </li><li> <tt>org.eclipse.equinox.app/</tt> |
| </li><li> <tt>org.eclipse.osgi/</tt> |
| </li><li> <tt>org.eclipse.update/</tt> |
| </li></ul> |
| <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 - and remove them. |
| </p><p>If that doesn't help, see question (resp. answer) before. |
| </p><p><br /> |
| </p> |
| <a name="JConsole"></a><h3> <span class="mw-headline"> JConsole </span></h3> |
| <a name="Why_is_the_SMILA_package_not_in_the_JConsole_tree.3F"></a><h4> <span class="mw-headline"> Why is the <i>SMILA</i> package not in the JConsole tree? </span></h4> |
| <p>I've started <tt>SMILA.exe</tt> but the SMILA package isn't in the tree of JConsole. |
| </p><p>To solve this try the following: |
| </p> |
| <ol><li> Create a new connection. |
| </li><li> Change your connection by setting the port "9004" on the <i>Remote</i> tab. |
| </li><li> Click the <i>Connect</i> button, switch to the <i>MBeans</i> tab, and check the tree again. |
| </li></ol> |
| <a name="Why_is_the_SMILA.2FCrawlerController_MBean_not_in_the_JConsole_tree.3F"></a><h4> <span class="mw-headline"> Why is the <i>SMILA/CrawlerController</i> MBean not in the JConsole tree? </span></h4> |
| <p>Check if all needed bundles are active. Open the equinox console and type: |
| </p> |
| <ul><li> <tt>ss crawler</tt> |
| </li><li> <tt>ss deltaindexing.impl</tt> |
| </li></ul> |
| <p>If one of these is not active: |
| </p> |
| <ul><li> check the <tt>configuration/config.ini</tt> |
| </li><li> check the log file for errors |
| </li></ul> |
| <a name="Cannot_connect_with_JConsole_to_a_remote_machine_running_Ubuntu_8.04_or_newer"></a><h4> <span class="mw-headline"> Cannot connect with JConsole to a remote machine running Ubuntu 8.04 or newer </span></h4> |
| <p>For some reason the JConsole cannot make a <i><b>remote</b></i> connection to JVM running on Ubuntu 8.04 or newer installations. (We did some tests with SuSE Linux and had no problems.) |
| </p><p>This can be easily circumvented by modifying <tt>/etc/hosts</tt> file. |
| Simply replace <tt>127.0.1.1</tt> with the real IP address of your Ubuntu machine and you're ready to go. |
| </p><p>For example, if you have a line in /etc/hosts that looks like this: |
| </p><p><tt>127.0.1.1 jupiter</tt> (Where "jupiter" it the actual name of the Ubuntu machine in this example. You will almost certainly have some other name here ;-) |
| </p><p>then replace it with: |
| </p><p><tt>192.168.220.101 jupiter</tt> (Where 192.168.220.101 is the actual IP address of the Ubuntu machine in this example.) |
| </p> |
| <a name="Configuring.2FRunning_SMILA"></a><h2> <span class="mw-headline"> Configuring/Running SMILA </span></h2> |
| <a name="Crawler"></a><h3> <span class="mw-headline"> Crawler </span></h3> |
| <a name="I_tried_to_crawl.2Findex_a_data_source.2C_JConsole_says_.22Crawl_..._sucessfully_started.22_but_nothing_seems_to_happen"></a><h4> <span class="mw-headline"> I tried to crawl/index a data source, JConsole says "Crawl ... sucessfully started" but nothing seems to happen </span></h4> |
| <p>Check if your queue is receiving records: |
| </p> |
| <ol><li> Open the JConsole's MBeans tab and go to: <code>org.apache.activemq/localhost/Queue/<queue>/Attributes</code> |
| </li><li> if <code>EnqueueCount</code> is increased your queue is receiving records, so it's not a crawler issue. |
| </li></ol> |
| <p>If your queue didn't receive any records from the crawler: |
| </p> |
| <ol><li> Did you crawl the data source before? If so, try a <code>clearAll</code> on the DeltaIndexing-MBean in your JConsole |
| </li><li> Check your crawler configuration file (see <tt>configuration/org.eclipse.smila.connectivity.framework/</tt>) |
| </li><li> Check the queue routing configuration: <tt>org.eclipse.smila.connectivity.queue.worker.jms/QueueWorkerRouterConfig.xml</tt> |
| </li><li> Check the queue connection: <tt>org.eclipse.smila.connectivity.queue.worker.jms/QueueWorkerConnectionConfig.xml</tt> |
| </li><li> If queue is running in a separate SMILA instance (e.g. on another PC), make sure that "Queue-SMILA" is started before "Crawler-SMILA" |
| </li></ol> |
| <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><p><br /> |
| </p> |
| <a name="Lucene_Indexing_.2F_Search"></a><h3> <span class="mw-headline"> Lucene Indexing / Search </span></h3> |
| <a name="How_can_I_browse.2Fsearch_an_existing_Lucene_index_without_SMILA_.28for_debug_purposes.29.3F"></a><h4> <span class="mw-headline"> How can I browse/search an existing Lucene index without SMILA (for debug purposes)? </span></h4> |
| <p>Try <a href="http://www.getopt.org/luke/" class="external text" title="http://www.getopt.org/luke/" rel="nofollow">LUKE</a> |
| </p> |
| <a name="Why_are_attributes_in_my_Lucene_index_missing_.2F_permuted.3F"></a><h4> <span class="mw-headline"> Why are attributes in my Lucene index missing / permuted? </span></h4> |
| <p>Open your configuration files: |
| </p> |
| <ul><li> <tt>configuration/org.eclipse.smila.lucene/Mappings.xml</tt> |
| </li><li> <tt>configuration/org.eclipse.smila.search.datadictionary/DataDictionary.xml</tt> |
| </li></ul> |
| <p>Check: |
| </p> |
| <ul><li> if all index fields are specified in these two files |
| </li><li> if the field numbers are compatible to each other |
| </li></ul> |
| <p>Still the same problem? |
| </p> |
| <ul><li> Close SMILA, remove file (if exists): <tt>workspace/org.eclipse.smila.search.datadictionary/DataDictionary.xml</tt> and restart SMILA |
| </li></ul> |
| <a name="SMILA_doesn.27t_return_search_results.2C_although_I_see_appropriate_entries_for_.28some_fields_of.29_my_query_in_the_Lucene_index"></a><h4> <span class="mw-headline"> SMILA doesn't return search results, although I see appropriate entries for (some fields of) my query in the Lucene index </span></h4> |
| <p>Open the file: <tt>configuration/org.eclipse.smila.search.datadictionary/DataDictionary.xml</tt> |
| </p> |
| <ul><li> Check the <code>Constraint</code> entries for all fields: If a <code>Constraint</code> is set <code>required</code> and this field is set in your query, the query value <i>must</i> match the indexed value! (regardless of other fields) |
| </li></ul> |
| <p>Still problems? Try removing the workspace version of that file if it exists: |
| </p> |
| <ul><li> Close SMILA, remove <tt>workspace/org.eclipse.smila.search.datadictionary/DataDictionary.xml</tt>, and restart SMILA. |
| </li></ul> |
| <a name="Test_search_application_.28http:.2F.2Flocalhost:8080.2FSMILA.2Fsearch.29_returns_HTTP_Status_500_with_the_stack_trace"></a><h4> <span class="mw-headline"> Test search application (<a href="http://localhost:8080/SMILA/search" class="external free" title="http://localhost:8080/SMILA/search" rel="nofollow">http://localhost:8080/SMILA/search</a>) returns <tt>HTTP Status 500</tt> with the stack trace</span></h4> |
| <p>This error usually happens when no index has been build but the user tries to do the search (directly after installing SMILA) by calling the test search application. Prior to 0.5 M3 user gets in this case a long stack trace with the real cause of the problem at the end of it: <tt>org.eclipse.smila.search.index.IndexException: index does not exist in data dictionary [test_index]</tt>. This means that the test index named "test_index" has not been created yet. This can easily be done by starting a crawler or an agent. In 0.5 M3 we improved the error handling in search servlet so that only error messages are displayed and highlighted. (Stack trace can still be seen by simply clicking on "Details...".) |
| </p> |
| <a name=".22Too_many_open_files.22_error_message"></a><h4> <span class="mw-headline"> "Too many open files" error message </span></h4> |
| <p>During indexing process Lucene opens a lots of files which may lead to the error described above. We recommend to increase the number of opened files: |
| </p><p><tt>ulimit –n 16384</tt> |
| </p><p>Permanent system configuration changes can be done at: |
| </p><p>- System configuration file /etc/security/limits.conf: Add or adapt the limits |
| for nofile. If it is undefined, the default value is usually 1,024 on most systems. |
| </p><p>- System profiles or configuration, e.g. /etc/profile, /etc/initscript, /etc/ |
| profile.local: Check if the ulimit command is used. |
| </p><p>- User profiles, e.g. ~/.profile: Check if the ulimit command is used. |
| </p> |
| <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><SMILA>/configuration/<bundle-name>/<config-file></tt> |
| </li><li> <tt><config-file></tt> in the root path of the bundle jar-file |
| </li></ol> |
| <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/<myService>.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><component name="<myService>" immediate="true"></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/<myService>.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> |
| <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> |
| <!-- |
| NewPP limit report |
| Preprocessor node count: 101/1000000 |
| Post-expand include size: 0/2097152 bytes |
| Template argument size: 0/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 20110617074918 --> |
| <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 © 2011 The Eclipse Foundation. All Rights Reserved</span> |
| <p id="footercredit">This page was last modified 14:26, 14 June 2011 by <a href="http://wiki.eclipse.org/index.php?title=User:Igor.novakovic.attensity.com&action=edit" class="new" title="User:Igor.novakovic.attensity.com">Igor Novakovic</a>. Based on work by <a href="http://wiki.eclipse.org/index.php?title=User:Juergen.schumacher.attensity.com&action=edit" class="new" title="User:Juergen.schumacher.attensity.com">Juergen Schumacher</a>, <a href="http://wiki.eclipse.org/User:Daniel.stucky.empolis.com" title="User:Daniel.stucky.empolis.com">Daniel Stucky</a> and <a href="http://wiki.eclipse.org/User:Igor.novakovic.empolis.com" title="User:Igor.novakovic.empolis.com">Igor Novakovic</a> and <a href="http://wiki.eclipse.org/index.php?title=SMILA/FAQ&action=credits" title="SMILA/FAQ">others</a>.</p> |
| <p id="footerviews">This page has been accessed 4,348 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.193 secs. --></body></html> |
