You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by bu...@apache.org on 2012/02/01 20:16:06 UTC
svn commit: r803736 - in /websites/staging/lucene/trunk/content:
css/global.css css/solr.css solr/tutorial.html
Author: buildbot
Date: Wed Feb 1 19:16:06 2012
New Revision: 803736
Log:
Staging update by buildbot for lucene
Modified:
websites/staging/lucene/trunk/content/css/global.css
websites/staging/lucene/trunk/content/css/solr.css
websites/staging/lucene/trunk/content/solr/tutorial.html
Modified: websites/staging/lucene/trunk/content/css/global.css
==============================================================================
--- websites/staging/lucene/trunk/content/css/global.css (original)
+++ websites/staging/lucene/trunk/content/css/global.css Wed Feb 1 19:16:06 2012
@@ -82,8 +82,8 @@ html, body, #wrap {height: 100%;}
body > #wrap {height: auto; min-height: 100%;}
body {
- font: 11px/ 165% "Lucida Grande", Geneva, Verdana, Arial, Helvetica, sans-serif;
- color: #666666;
+ font: 13px/ 165% "Lucida Grande", Geneva, Verdana, Arial, Helvetica, sans-serif;
+ color: black;
margin: 0;
padding: 0;
background: url(../images/bg.png) top left repeat-x #A6A6A6;
Modified: websites/staging/lucene/trunk/content/css/solr.css
==============================================================================
--- websites/staging/lucene/trunk/content/css/solr.css (original)
+++ websites/staging/lucene/trunk/content/css/solr.css Wed Feb 1 19:16:06 2012
@@ -82,8 +82,8 @@ html, body, #wrap {height: 100%;}
body > #wrap {height: auto; min-height: 100%;}
body {
- font: 11px/ 165% "Lucida Grande", Geneva, Verdana, Arial, Helvetica, sans-serif;
- color: #666666;
+ font: 13px/ 165% "Lucida Grande", Geneva, Verdana, Arial, Helvetica, sans-serif;
+ color: black;
margin: 0;
padding: 0;
background: url(../images/bg.png) top left repeat-x #A6A6A6;
@@ -136,7 +136,7 @@ a:hover {
h1,h2,h2 {
font-family: "Trebuchet MS", Tahoma, Arial, Sans-serif;
- color: #555;
+ color: black;
}
h1 {
@@ -270,7 +270,7 @@ td {
input,select {
padding: 4px;
font: normal 1em Verdana, sans-serif;
- color: #666666;
+ color: black;
background: #fff;
}
@@ -280,7 +280,7 @@ textarea {
font: normal 1em Verdana, sans-serif;
height: 100px;
display: block;
- color: #666666;
+ color: black;
}
input,textarea,select {
@@ -295,7 +295,7 @@ input.button {
height: 30px;
margin: 0;
padding: 2px 3px;
- color: #555;
+ color: black;
background: #E6E6E6;
border-width: 1px;
border-style: solid;
@@ -924,4 +924,13 @@ body#full #wrap {
width: 945px;
margin: 0 auto;
text-align: left;
+}
+
+/*Tutorial */
+.tutorial div.cmd{
+ background: #d3d3d3;
+ display: block;
+ white-space: pre;
+
+
}
\ No newline at end of file
Modified: websites/staging/lucene/trunk/content/solr/tutorial.html
==============================================================================
--- websites/staging/lucene/trunk/content/solr/tutorial.html (original)
+++ websites/staging/lucene/trunk/content/solr/tutorial.html Wed Feb 1 19:16:06 2012
@@ -22,7 +22,7 @@
<link href="../css/global.css" rel="stylesheet" type="text/css">
<link href="../css/solr.css" rel="stylesheet" type="text/css">
- <title>Apache Lucene - Solr Tutorial</title>
+ <title>Apache Lucene - </title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
<meta name="Distribution" content="Global"/>
@@ -206,9 +206,12 @@
</div>
<div id="content-wrap" class="clearfix">
<div id="main">
- <h1 class="title">Solr Tutorial</h1>
+ <h1 class="title"></h1>
- <div><h2 id="overview">Overview</h2>
+ <div><div class="tutorial">
+
+<h1 id="solr_tutorial">Solr Tutorial</h1>
+<h2 id="overview">Overview</h2>
<p>This document covers the basics of running Solr using an example
schema, and some sample data.</p>
<h2 id="requirements">Requirements</h2>
@@ -233,27 +236,30 @@ Please run the browser showing this tuto
</em></p>
<p>Begin by unziping the Solr release and changing your working directory
to be the "<code>example</code>" directory. (Note that the base directory name may vary with the version of Solr downloaded.) For example, with a shell in UNIX, Cygwin, or MacOS:</p>
-<div class="codehilite"><pre><span class="n">user:</span><span class="o">~</span><span class="n">solr</span><span class="nv">$</span> <span class="nv">ls</span>
-<span class="n">solr</span><span class="o">-</span><span class="n">nightly</span><span class="o">.</span><span class="n">zip</span>
-<span class="n">user:</span><span class="o">~</span><span class="n">solr</span><span class="nv">$</span> <span class="nv">unzip</span> <span class="o">-</span><span class="sx">q solr-nightly.zip</span>
-<span class="sx">user:~solr$ </span><span class="n">cd</span> <span class="n">solr</span><span class="o">-</span><span class="n">nightly</span><span class="sr">/example/</span>
-</pre></div>
-
+<div class="cmd">
+ user:~solr$ ls
+ solr-nightly.zip
+ user:~solr$ unzip -q solr-nightly.zip
+ user:~solr$ cd solr-nightly/example/
+</div>
<p>Solr can run in any Java Servlet Container of your choice, but to simplify
this tutorial, the example index includes a small installation of Jetty.</p>
<p>To launch Jetty with the Solr WAR, and the example configs, just run the <code>start.jar</code> ...</p>
-<div class="codehilite"><pre><span class="n">user:</span><span class="o">~</span><span class="sr">/solr/</span><span class="n">example</span><span class="nv">$</span> <span class="nv">java</span> <span class="o">-</span><span class="n">jar</span> <span class="n">start</span><span class="o">.</span><span class="n">jar</span>
-<span class="mi">2009</span><span class="o">-</span><span class="mi">10</span><span class="o">-</span><span class="mi">23</span> <span class="mi">16</span><span class="p">:</span><span class="mi">42</span><span class="p">:</span><span class="mf">53.816</span><span class="o">::</span><span class="n">INFO:</span> <span class="n">Logging</span> <span class="n">to</span> <span class="bp">STDERR</span> <span class="n">via</span> <span class="n">org</span><span class="o">.</span><span class="n">mortbay</span><span class="o">.</span><span class="nb">log</span><span class="o">.</span><span class="n">StdErrLog</span>
-<span class="mi">2009</span><span class="o">-</span><span class="mi">10</span><span class="o">-</span><span class="mi">23</span> <span class="mi">16</span><span class="p">:</span><span class="mi">42</span><span class="p">:</span><span class="mf">53.907</span><span class="o">::</span><span class="n">INFO:</span> <span class="n">jetty</span><span class="o">-</span><span class="mf">6.1.26</span>
+<div class="cmd">
+ user:~/solr/example$ java -jar start.jar
+ 2009-10-23 16:42:53.816::INFO: Logging to STDERR via org.mortbay.log.StdErrLog
+ 2009-10-23 16:42:53.907::INFO: jetty-6.1.26
-<span class="o">...</span>
+...
-<span class="n">Oct</span> <span class="mi">23</span><span class="p">,</span> <span class="mi">2009</span> <span class="mi">4</span><span class="p">:</span><span class="mi">41</span><span class="p">:</span><span class="mi">56</span> <span class="n">PM</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">solr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">SolrCore</span> <span class="n">registerSearcher</span>
+<div class="codehilite"><pre><span class="n">Oct</span> <span class="mi">23</span><span class="p">,</span> <span class="mi">2009</span> <span class="mi">4</span><span class="p">:</span><span class="mi">41</span><span class="p">:</span><span class="mi">56</span> <span class="n">PM</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">solr</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">SolrCore</span> <span class="n">registerSearcher</span>
<span class="n">INFO:</span> <span class="o">[]</span> <span class="n">Registered</span> <span class="k">new</span> <span class="n">searcher</span> <span class="n">Searcher</span><span class="nv">@7c3885</span> <span class="n">main</span>
</pre></div>
+</div>
+
<p>This will start up the Jetty application server on port 8983, and use your terminal to display the logging information from Solr.</p>
<p>You can see that the Solr is running by loading <a href="http://localhost:8983/solr/admin/">http://localhost:8983/solr/admin/</a> in your web browser. This is the main starting point for Administering Solr.</p>
<h2 id="indexing_data">Indexing Data</h2>
@@ -269,40 +275,40 @@ this tutorial we'll use the cross-platfo
open a new terminal window, enter the exampledocs directory, and run
"<code>java -jar post.jar</code>" on some of the XML files in that directory,
indicating the URL of the Solr server:</p>
-<div class="codehilite"><pre><span class="n">user:</span><span class="o">~</span><span class="sr">/solr/</span><span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="nv">$</span> <span class="nv">java</span> <span class="o">-</span><span class="n">jar</span> <span class="n">post</span><span class="o">.</span><span class="n">jar</span> <span class="n">solr</span><span class="o">.</span><span class="n">xml</span> <span class="n">monitor</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">version</span> <span class="mf">1.2</span>
-<span class="n">SimplePostTool:</span> <span class="n">WARNING:</span> <span class="n">Make</span> <span class="n">sure</span> <span class="n">your</span> <span class="n">XML</span> <span class="n">documents</span> <span class="n">are</span> <span class="n">encoded</span> <span class="n">in</span> <span class="n">UTF</span><span class="o">-</span><span class="mi">8</span><span class="p">,</span> <span class="n">other</span> <span class="n">encodings</span> <span class="n">are</span> <span class="ow">not</span> <span class="n">currently</span> <span class="n">supported</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">files</span> <span class="n">to</span> <span class="n">http:</span><span class="sr">//</span><span class="n">localhost:8983</span><span class="sr">/solr/</span><span class="n">update</span><span class="o">..</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">solr</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">monitor</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">COMMITting</span> <span class="n">Solr</span> <span class="nb">index</span> <span class="n">changes</span><span class="o">..</span>
-</pre></div>
-
+<div class="cmd">
+ user:~/solr/example/exampledocs$ java -jar post.jar solr.xml monitor.xml
+ SimplePostTool: version 1.2
+ SimplePostTool: WARNING: Make sure your XML documents are encoded in UTF-8, other encodings are not currently supported
+ SimplePostTool: POSTing files to http://localhost:8983/solr/update..
+ SimplePostTool: POSTing file solr.xml
+ SimplePostTool: POSTing file monitor.xml
+ SimplePostTool: COMMITting Solr index changes..
+</div>
<p>You have now indexed two documents in Solr, and committed these changes.<br />
You can now search for "solr" using the "Make a Query" interface on the Admin screen, and you should get one result.<br />
Clicking the "Search" button should take you to the following URL...</p>
<p><a href="http://localhost:8983/solr/select/?q=solr&start=0&rows=10&indent=on">http://localhost:8983/solr/select/?q=solr&start=0&rows=10&indent=on</a></p>
<p>You can index all of the sample data, using the following command (assuming your command line shell supports the *.xml notation):</p>
-<div class="codehilite"><pre><span class="n">user:</span><span class="o">~</span><span class="sr">/solr/</span><span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="nv">$</span> <span class="nv">java</span> <span class="o">-</span><span class="n">jar</span> <span class="n">post</span><span class="o">.</span><span class="n">jar</span> <span class="o">*.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">version</span> <span class="mf">1.2</span>
-<span class="n">SimplePostTool:</span> <span class="n">WARNING:</span> <span class="n">Make</span> <span class="n">sure</span> <span class="n">your</span> <span class="n">XML</span> <span class="n">documents</span> <span class="n">are</span> <span class="n">encoded</span> <span class="n">in</span> <span class="n">UTF</span><span class="o">-</span><span class="mi">8</span><span class="p">,</span> <span class="n">other</span> <span class="n">encodings</span> <span class="n">are</span> <span class="ow">not</span> <span class="n">currently</span> <span class="n">supported</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">files</span> <span class="n">to</span> <span class="n">http:</span><span class="sr">//</span><span class="n">localhost:8983</span><span class="sr">/solr/</span><span class="n">update</span><span class="o">..</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">hd</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">ipod_other</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">ipod_video</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">mem</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">monitor</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">monitor2</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">mp500</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">sd500</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">solr</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">spellchecker</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">utf8</span><span class="o">-</span><span class="n">example</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">POSTing</span> <span class="n">file</span> <span class="n">vidcard</span><span class="o">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool:</span> <span class="n">COMMITting</span> <span class="n">Solr</span> <span class="nb">index</span> <span class="n">changes</span><span class="o">..</span>
-</pre></div>
-
+<div class="cmd">
+ user:~/solr/example/exampledocs$ java -jar post.jar *.xml
+ SimplePostTool: version 1.2
+ SimplePostTool: WARNING: Make sure your XML documents are encoded in UTF-8, other encodings are not currently supported
+ SimplePostTool: POSTing files to http://localhost:8983/solr/update..
+ SimplePostTool: POSTing file hd.xml
+ SimplePostTool: POSTing file ipod_other.xml
+ SimplePostTool: POSTing file ipod_video.xml
+ SimplePostTool: POSTing file mem.xml
+ SimplePostTool: POSTing file monitor.xml
+ SimplePostTool: POSTing file monitor2.xml
+ SimplePostTool: POSTing file mp500.xml
+ SimplePostTool: POSTing file sd500.xml
+ SimplePostTool: POSTing file solr.xml
+ SimplePostTool: POSTing file spellchecker.xml
+ SimplePostTool: POSTing file utf8-example.xml
+ SimplePostTool: POSTing file vidcard.xml
+ SimplePostTool: COMMITting Solr index changes..
+</div>
<p>...and now you can search for all sorts of things using the default <a href="http://wiki.apache.org/solr/SolrQuerySyntax">Solr Query Syntax</a> (a superset of the Lucene query syntax)...</p>
<ul>
@@ -358,35 +364,35 @@ in subsequent searches.</p>
of the document's unique key field, or a query that matches multiple documents (be careful with that one!). Since these commands
are smaller, we will specify them right on the command line rather than reference an XML file.</p>
<p>Execute the following command to delete a document</p>
-<div class="codehilite"><pre>java -Ddata=args -Dcommit=no -jar post.jar "<span class="nt"><delete><id></span>SP2514N<span class="nt"></id></delete></span>"
-</pre></div>
-
+<div class="cmd">
+ java -Ddata=args -Dcommit=no -jar post.jar "<delete><id>SP2514N</id></delete>"
+</div>
<p>Now if you go to the <a href="http://localhost:8983/solr/admin/stats.jsp">statistics</a> page and scroll down
to the UPDATE_HANDLERS section and verify that "<code>deletesById : 1</code>"
If you search for <a href="http://localhost:8983/solr/select?q=id:SP2514N">id:SP2514N</a> it will still be found,
because index changes are not visible until, and a new searcher is opened. To cause
this to happen, send a commit command to Solr (post.jar does this for you by default):</p>
-<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">jar</span> <span class="n">post</span><span class="o">.</span><span class="n">jar</span>
-</pre></div>
-
+<div class="cmd">
+ java -jar post.jar
+</div>
<p>Now re-execute the previous search and verify that no matching documents are found. Also revisit the
statistics page and observe the changes in both the UPDATE_HANDLERS section and the CORE section.
Here is an example of using delete-by-query to delete anything with
<a href="http://localhost:8983/solr/select?q=name:DDR&fl=name">DDR</a> in the name:</p>
-<div class="codehilite"><pre>java -Ddata=args -jar post.jar "<span class="nt"><delete><query></span>name:DDR<span class="nt"></query></delete></span>"
-</pre></div>
-
+<div class="cmd">
+ java -Ddata=args -jar post.jar "<delete><query>name:DDR</query></delete>"
+</div>
<p>Commit can be an expensive operation so it's best to make many changes to an index in a batch and
then send the commit command at the end. There is also an optimize command that does the same thing as commit,
in addition to merging all index segments into a single segment, making it faster to search and causing any
deleted documents to be removed. All of the update commands are documented <a href="http://wiki.apache.org/solr/UpdateXmlMessages">here</a>.</p>
<p>To continue with the tutorial, re-add any documents you may have deleted by going to the <code>exampledocs</code> directory and executing</p>
-<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">jar</span> <span class="n">post</span><span class="o">.</span><span class="n">jar</span> <span class="o">*.</span><span class="n">xml</span>
-</pre></div>
-
+<div class="cmd">
+ java -jar post.jar *.xml
+</div>
<h2 id="querying_data">Querying Data</h2>
<p>Searches are done via HTTP GET on the select URL with the query string in the q parameter.
@@ -537,7 +543,8 @@ and
Explore the <a href="http://wiki.apache.org/solr/FrontPage">Solr Wiki</a> to find out
more details about Solr's many
<a href="features.html">features</a>.</p>
-<p>Have Fun, and we'll see you on the Solr mailing lists!</p></div>
+<p>Have Fun, and we'll see you on the Solr mailing lists!
+</div></p></div>