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 2015/02/20 19:20:22 UTC
svn commit: r940868 [2/2] - in /websites/staging/lucene/trunk/content: ./
core/ openrelevance/ solr/ solr/assets/images/
Modified: websites/staging/lucene/trunk/content/solr/quickstart.html
==============================================================================
--- websites/staging/lucene/trunk/content/solr/quickstart.html (original)
+++ websites/staging/lucene/trunk/content/solr/quickstart.html Fri Feb 20 18:20:22 2015
@@ -31,7 +31,7 @@
<link rel="stylesheet" href="/solr/assets/styles/base.css" />
- <title>Apache Solr - Quick Start</title>
+ <title>Apache Solr - </title>
@@ -180,40 +180,32 @@
<div class="row">
<div class="small-12 columns">
- <ul class="breadcrumbs">
- <li><a href="/solr">Home</a></li>
- <li><a href="/solr/resources.html">Resources</a></li>
-</ul>
-
-<h1 id="solr-quick-start">Solr Quick Start</h1>
-<hr />
+ <h1 id="solr-quick-start">Solr Quick Start</h1>
<h2 id="overview">Overview</h2>
-<p>This document covers getting Solr up and running, ingesting a variety of data sources into multiple collections, and getting a feel
-for the Solr administrative and search interfaces.</p>
-<hr />
+<p>This document covers getting Solr up and running, ingesting a variety of data sources into multiple collections,
+and getting a feel for the Solr administrative and search interfaces.</p>
<h2 id="requirements">Requirements</h2>
<p>To follow along with this tutorial, you will need...</p>
<ol>
-<li>Java 1.7 or greater. Some places you can get it are from Oracle or Open JDK.<ul>
-<li>Running <code>java -version</code> at the command line should indicate a version number starting with 1.7.</li>
-<li>Gnu's GCJ is not supported and does not work with Solr.</li>
-</ul>
-</li>
-<li>An Apache Solr release. This Quick Start was written using Apache Solr 4.10.2. Some fiddly details will be different/clunkier for earlier versions and more streamlined in later versions.</li>
+<li>To meet the <a href="/solr/api/SYSTEM_REQUIREMENTS.html">system requirements</a></li>
+<li>An Apache Solr release. This tutorial was written using Apache Solr 5.0.0.</li>
</ol>
-<hr />
<h2 id="getting-started">Getting Started</h2>
-<p>Please run the browser showing this tutorial and the Solr server on the same machine so tutorial links will correctly point to your Solr server.</p>
-<p>Begin by unzipping the Solr release and changing your working directory to the subdirectory where Solr was installed. 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>
+<p>Please run the browser showing this tutorial and the Solr server on the same machine so tutorial links will correctly
+point to your Solr server.</p>
+<p>Begin by unzipping the Solr release and changing your working directory to the subdirectory where Solr was installed.
+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="o">/</span><span class="p">:</span>$ <span class="n">ls</span> <span class="n">solr</span><span class="o">*</span>
-<span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">.</span><span class="n">zip</span>
-<span class="o">/</span><span class="p">:</span>$ <span class="n">unzip</span> <span class="o">-</span><span class="n">q</span> <span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">.</span><span class="n">zip</span>
-<span class="o">/</span><span class="p">:</span>$ <span class="n">cd</span> <span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="o">/</span>
+<span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">.</span><span class="n">zip</span>
+<span class="o">/</span><span class="p">:</span>$ <span class="n">unzip</span> <span class="o">-</span><span class="n">q</span> <span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">.</span><span class="n">zip</span>
+<span class="o">/</span><span class="p">:</span>$ <span class="n">cd</span> <span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="o">/</span>
</pre></div>
<p>To launch Solr, run: <code>bin/solr start -e cloud -noprompt</code></p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">solr</span> <span class="n">start</span> <span class="o">-</span><span class="n">e</span> <span class="n">cloud</span> <span class="o">-</span><span class="n">noprompt</span>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">solr</span> <span class="n">start</span> <span class="o">-</span><span class="n">e</span> <span class="n">cloud</span> <span class="o">-</span><span class="n">noprompt</span>
+
<span class="n">Welcome</span> <span class="n">to</span> <span class="n">the</span> <span class="n">SolrCloud</span> <span class="n">example</span>!
@@ -228,139 +220,162 @@ for the Solr administrative and search i
<span class="n">SolrCloud</span> <span class="n">example</span> <span class="n">running</span><span class="p">,</span> <span class="n">please</span> <span class="n">visit</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span>
-<span class="o">/</span><span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">:</span>$
+<span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">:</span>$ <span class="n">_</span>
</pre></div>
-<p>You can see that the Solr is running by loading the Solr Admin UI in your web browser: <a href="http://localhost:8983/solr/">http://localhost:8983/solr/</a>. This is the main starting point for administering Solr.</p>
-<p>Solr will now be running two "nodes", one on port 7574 and one on port 8983. There are two collections created automatically, <code>collection1</code> and <code>gettingstarted</code>. These collections are different in a couple of ways: <code>collection1</code> is a single shard collection with two replicas and <code>gettingstarted</code> is a two shard
-collection, each with two replicas. The <a href="http://localhost:8983/solr/#/~cloud">Cloud tab</a> in the Admin UI diagrams the collection nicely:</p>
-<p><img alt="Solr Quick Start: SolrCloud diagram" class="float-right" src="/solr/assets/images/quickstart-solrcloud.png" /></p>
-<p>We will only be using <code>collection1</code> in this guide; it makes things easier in part because the indexing commands default to using that collection.</p>
-<hr />
-<section class="orange full-width">
- <h1>That wasn't too hard!</h1>
- <p>
- You nailed step 1. Take a deep breath, relax a bit before round 2 below.
- </p>
- <div class="down-arrow"><a data-scroll href="#indexing-data"><i class="fa fa-angle-down fa-2x red"></i></a></div>
-</section>
-
+<p>You can see that the Solr is running by loading the Solr Admin UI in your web browser: <a href="http://localhost:8983/solr/">http://localhost:8983/solr/</a>.
+This is the main starting point for administering Solr.</p>
+<p>Solr will now be running two "nodes", one on port 7574 and one on port 8983. There is one collection created
+automatically, <code>gettingstarted</code>, a two shard collection, each with two replicas.
+The <a href="http://localhost:8983/solr/#/~cloud">Cloud tab</a> in the Admin UI diagrams the collection nicely:</p>
+<p><img alt="Solr Quick Start: SolrCloud diagram" src="/solr/assets/images/quickstart-solrcloud.png" /></p>
<h2 id="indexing-data">Indexing Data</h2>
-<p>Your Solr server is up and running, but it doesn't contain any data. The Solr install includes, literally, a <code>SimplePostTool</code> in order to facilitate getting various types of documents into Solr easy from the start. We'll be using this tool for the indexing examples below.</p>
-<p>You'll need a command shell to run these examples, rooted in the Solr install directory; the shell from where you launched Solr works just fine.</p>
-<p>Running the <code>SimplePostTool</code> can be made easier/cleaner to run by setting this in your environment:</p>
-<div class="codehilite"><pre><span class="n">export</span> <span class="n">CLASSPATH</span><span class="p">=</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">.</span><span class="n">jar</span>
-</pre></div>
-
-
-<p>Or if you prefer, you can make every java command start with <code>java -classpath dist/solr-core-4.10.2.jar ...</code> The examples provided below omit the <code>-classpath</code> argument and assume the <code>$CLASSPATH</code> environment variable is set.</p>
+<p>Your Solr server is up and running, but it doesn't contain any data. The Solr install includes the <code>bin/post</code>* tool in
+order to facilitate getting various types of documents easily into Solr from the start. We'll be
+using this tool for the indexing examples below.</p>
+<p>You'll need a command shell to run these examples, rooted in the Solr install directory; the shell from where you
+launched Solr works just fine.</p>
+<ul>
+<li>NOTE: Currently the <code>bin/post</code> tool does not have a comparable Windows script, but the underlying Java program invoked
+is available. See the <a href="https://cwiki.apache.org/confluence/display/solr/Post+Tool#PostTool-Windows">Post Tool, Windows section</a>
+for details.</li>
+</ul>
<h3 id="indexing-a-directory-of-rich-files">Indexing a directory of "rich" files</h3>
-<p>Let's first index local "rich" files including HTML, PDF, Microsoft Office formats (such as MS Word), plain text and many other formats. <code>SimplePostTool</code> features the ability to crawl a directory of files, optionally recursively even, sending the raw content of each file into Solr for extraction and indexing. A Solr install includes a <code>docs/</code> subdirectory, so that makes a convenient set of (mostly) HTML files built-in to start with.</p>
-<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">Dauto</span> <span class="o">-</span><span class="n">Drecursive</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">docs</span><span class="o">/</span>
+<p>Let's first index local "rich" files including HTML, PDF, Microsoft Office formats (such as MS Word), plain text and
+many other formats. <code>bin/post</code> features the ability to crawl a directory of files, optionally recursively even,
+sending the raw content of each file into Solr for extraction and indexing. A Solr install includes a <code>docs/</code>
+subdirectory, so that makes a convenient set of (mostly) HTML files built-in to start with.</p>
+<div class="codehilite"><pre><span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">docs</span><span class="o">/</span>
</pre></div>
<p>Here's what it'll look like:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">:</span>$ <span class="n">java</span> <span class="o">-</span><span class="n">Dauto</span> <span class="o">-</span><span class="n">Drecursive</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">docs</span><span class="o">/</span>
-<span class="n">SimplePostTool</span> <span class="n">version</span> 1<span class="p">.</span>5
-<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="n">base</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">update</span><span class="p">..</span>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">docs</span><span class="o">/</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="o">-</span><span class="n">Drecursive</span><span class="p">=</span><span class="n">yes</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><
span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">docs</span><span class="o">/</span>
+<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>0<span class="p">.</span>0
+<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span class="n">otp</span><span class="p">,</span><span class
="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
<span class="n">Entering</span> <span class="n">recursive</span> <span class="n">mode</span><span class="p">,</span> <span class="n">max</span> <span class="n">depth</span><span class="p">=</span>999<span class="p">,</span> <span class="n">delay</span><span class="p">=</span>0<span class="n">s</span>
<span class="n">Indexing</span> <span class="n">directory</span> <span class="n">docs</span> <span class="p">(</span>3 <span class="n">files</span><span class="p">,</span> <span class="n">depth</span><span class="p">=</span>0<span class="p">)</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">index</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">SYSTEM_REQUIREMENTS</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">tutorial</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">index</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span><span class="o">/</span><span class="n">extract</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">quickstart</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span><span class="o">/</span><span class="n">extract</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">SYSTEM_REQUIREMENTS</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span><span class="o">/</span><span class="n">extract</span>
<span class="n">Indexing</span> <span class="n">directory</span> <span class="n">docs</span><span class="o">/</span><span class="n">changes</span> <span class="p">(</span>1 <span class="n">files</span><span class="p">,</span> <span class="n">depth</span><span class="p">=</span>1<span class="p">)</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">Changes</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span>
-<span class="n">Indexing</span> <span class="n">directory</span> <span class="n">docs</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">analysis</span><span class="o">-</span><span class="n">extras</span> <span class="p">(</span>8 <span class="n">files</span><span class="p">,</span> <span class="n">depth</span><span class="p">=</span>1<span class="p">)</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">Changes</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span><span class="o">/</span><span class="n">extract</span>
<span class="p">...</span>
-2945 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
-<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">update</span><span class="p">..</span>
-<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>37<span class="p">.</span>537
+3248 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
+<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
+<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>41<span class="p">.</span>660
</pre></div>
<p>The command-line breaks down as follows:</p>
<ul>
-<li><code>-Dauto -Drecursive</code>: Settings for automatic content-type detection and directory recursing</li>
-<li><code>org.apache.solr.util.SimplePostTool</code>: Our easy to use POSTing friend in this tutorial</li>
+<li><code>-c gettingstarted</code>: name of the collection to index into</li>
<li><code>docs/</code>: a relative path of the Solr install <code>docs/</code> directory</li>
</ul>
-<p>You have now indexed thousands of documents into the <code>collection1</code> collection in Solr and committed these changes. You can search for "solr" by loading the Admin UI <a href="http://localhost:8983/solr/#/collection1/query">Query tab</a>, and enter "solr" in the <code>q</code> param (replacing <code>*:*</code>, which matches all documents). See the <a href="#searching">Searching</a> section below for more information. </p>
-<p>To index your own data, re-run the directory indexing command pointed to your own directory of documents. For example, on a Mac instead of <code>docs/</code> try <code>~/Documents/</code> or <code>~/Desktop/</code> ! You may want to start from a clean, empty system again, rather than have your content in addition to the Solr <code>docs/</code> directory; see the Cleanup section <a href="#cleanup">below</a> for how to get back to a clean starting point.</p>
+<p>You have now indexed thousands of documents into the <code>gettingstarted</code> collection in Solr and committed these changes.
+You can search for "solr" by loading the Admin UI <a href="#admin-collection">Query tab</a>, enter "solr" in the <code>q</code> param
+(replacing <code>*:*</code>, which matches all documents), and "Execute Query". See the <a href="#searching">Searching</a>
+section below for more information.</p>
+<p>To index your own data, re-run the directory indexing command pointed to your own directory of documents. For example,
+on a Mac instead of <code>docs/</code> try <code>~/Documents/</code> or <code>~/Desktop/</code>! You may want to start from a clean, empty system
+again rather than have your content in addition to the Solr <code>docs/</code> directory; see the Cleanup section <a href="#cleanup">below</a>
+for how to get back to a clean starting point.</p>
<h3 id="indexing-solr-xml">Indexing Solr XML</h3>
-<p>Solr supports indexing structured content in a variety of incoming formats. The historically predominant format for getting structured content into Solr has been <a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-XMLFormattedIndexUpdates">Solr XML</a>. Many Solr indexers have been coded to process domain content into Solr XML output, generally HTTP POSTed directly to Solr's <code>/update</code> endpoint.</p>
-<p>Solr's install includes a handful of Solr XML formatted files with example data (mostly mocked tech product data). </p>
-<p>Using <code>SimplePostTool</code>, index the example Solr XML files in <code>example/exampledocs/</code>:</p>
-<div class="codehilite"><pre><span class="n">java</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/*</span><span class="p">.</span><span class="n">xml</span>
+<p>Solr supports indexing structured content in a variety of incoming formats. The historically predominant format for
+getting structured content into Solr has been <a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-XMLFormattedIndexUpdates">Solr XML</a>.
+Many Solr indexers have been coded to process domain content into Solr XML output, generally HTTP POSTed directly to
+Solr's <code>/update</code> endpoint.</p>
+<p><a name="techproducts"></a>
+Solr's install includes a handful of Solr XML formatted files with example data (mostly mocked tech product data).
+NOTE: This tech product data as a more domain-specific configuration, including schema and browse UI. The <code>bin/solr</code>
+script includes built-in support for this by running <code>bin/solr start -e techproducts</code> which not only starts Solr but
+also then indexes this data too (be sure to <code>bin/solr stop -all</code> before trying it out).
+beforehand).</p>
+<p>Using <code>bin/post</code>, index the example Solr XML files in <code>example/exampledocs/</code>:</p>
+<div class="codehilite"><pre><span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/*</span><span class="p">.</span><span class="n">xml</span>
</pre></div>
<p>Here's what you'll see:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">:</span>$ <span class="n">java</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/*</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">SimplePostTool</span> <span class="n">version</span> 1<span class="p">.</span>5
-<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="n">base</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">update</span> <span class="n">using</span> <span class="n">content</span><span class="o">-</span><span class="n">type</span> <span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">..</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">gb18030</span><span class="o">-</span><span class="n">example</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">hd</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">ipod_other</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">ipod_video</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">manufacturers</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">mem</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">money</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">monitor</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">monitor2</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">mp500</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">sd500</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">solr</span><span class="p">.</span><span class="n">xml</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="p">.</span><span class="n">xml</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">vidcard</span><span class="p">.</span><span class="n">xml</span>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/*</span><span class="p">.</span><span class="n">xml</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">SNAPSHOT</span><span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><sp
an class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">gb18030</span><span class="o">-</span><span class="n">example</span><span class="p">.</span><span class="n">xml</span> <span class="p">...</span>
+<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>0<span class="p">.</span>0
+<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
+<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span class="n">otp</span><span class="p">,</span><span class
="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">gb18030</span><span class="o">-</span><span class="n">example</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">hd</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">ipod_other</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">ipod_video</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">manufacturers</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">mem</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">money</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">monitor</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">monitor2</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">mp500</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">sd500</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">solr</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</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="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">vidcard</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
14 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
-<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">update</span><span class="p">..</span>
-<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>453
+<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
+<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>01<span class="p">.</span>857
</pre></div>
-<p>...and now you can search for all sorts of things using the default <a href="https://cwiki.apache.org/confluence/display/solr/The+Standard+Query+Parser#TheStandardQueryParser-SpecifyingTermsfortheStandardQueryParser">Solr Query Syntax</a> (a superset of the Lucene query syntax)...</p>
+<p>...and now you can search for all sorts of things using the default <a href="https://cwiki.apache.org/confluence/display/solr/The+Standard+Query+Parser#TheStandardQueryParser-SpecifyingTermsfortheStandardQueryParser">Solr Query Syntax</a>
+(a superset of the Lucene query syntax)...</p>
<p>NOTE:
-You can browse the documents indexed at <a href="http://localhost:8983/solr/collection1/browse">http://localhost:8983/solr/collection1/browse</a>. The <code>/browse</code> UI allows getting a feel for how Solr's technical capabilities can be worked with in a familiar, though a bit rough and prototypical, interactive HTML view. (The <code>/browse</code> view defaults to assuming the <code>collection1</code> schema and data are a catch-all mix of structured XML, JSON, CSV example data, and unstructured rich documents. Your own data may not look ideal at first, though the <code>/browse</code> templates are customizable.)</p>
+You can browse the documents indexed at <a href="http://localhost:8983/solr/gettingstarted/browse">http://localhost:8983/solr/gettingstarted/browse</a>. The <code>/browse</code> UI allows getting
+a feel for how Solr's technical capabilities can be worked with in a familiar, though a bit rough and prototypical,
+interactive HTML view. (The <code>/browse</code> view defaults to assuming the <code>gettingstarted</code> schema and data are a catch-all mix
+of structured XML, JSON, CSV example data, and unstructured rich documents. Your own data may not look ideal at first,
+though the <code>/browse</code> templates are customizable.)</p>
<h3 id="indexing-json">Indexing JSON</h3>
-<p>Solr supports indexing JSON, either arbitrary structured JSON or "Solr JSON" (which is similiar to Solr XML).</p>
-<p>Solr includes a small sample Solr JSON file to illustrate this capability. Again using <code>SimplePostTool</code>, index the sample JSON file:</p>
-<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">Dauto</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
+<p>Solr supports indexing JSON, either arbitrary structured JSON or "Solr JSON" (which is similar to Solr XML).</p>
+<p>Solr includes a small sample Solr JSON file to illustrate this capability. Again using <code>bin/post</code>, index the
+sample JSON file:</p>
+<div class="codehilite"><pre><span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
</pre></div>
<p>You'll see:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">:</span>$ <span class="n">java</span> <span class="o">-</span><span class="n">Dauto</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
-<span class="n">SimplePostTool</span> <span class="n">version</span> 1<span class="p">.</span>5
-<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="n">base</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">update</span><span class="p">..</span>
-<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,...</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">books</span><span class="p">.</span><span class="n">json</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">json</span><span class="p">)</span>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">SNAPSHOT</span><span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><sp
an class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
+<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>0<span class="p">.</span>0
+<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
+<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span class="n">otp</span><span class="p">,</span><span class
="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">books</span><span class="p">.</span><span class="n">json</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">json</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
1 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
-<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">update</span><span class="p">..</span>
-<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>084
+<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
+<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>377
</pre></div>
-<p>Because the <code>SimplePostTool</code> defaults to assuming files are in Solr XML format, the <code>-Dauto</code> switch is used to post JSON files so that it uses the appropriate content type.</p>
-<p>To flatten (and/or split) and index arbitrary structured JSON, a topic beyond this quick start guide, check out <a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-TransformingandIndexingcustomJSONdata">Transforming and Indexing Custom JSON data</a>.</p>
+<p>To flatten (and/or split) and index arbitrary structured JSON, a topic beyond this quick start guide, check out
+<a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-TransformingandIndexingcustomJSONdata">Transforming and Indexing Custom JSON data</a>.</p>
<h3 id="indexing-csv-commacolumn-separated-values">Indexing CSV (Comma/Column Separated Values)</h3>
-<p>A great conduit of data into Solr is via CSV, especially when the documents are homogonenous and generally all have the same set of fields. CSV can be conveniently exported from a spreadsheet such as Excel, or exported from databases such as MySQL. When getting started with Solr, it can often be easiest to get your structured data into CSV format and then index that into Solr rather than a more sophisticated single step operation.</p>
-<p>Using SimplePostTool and the included example CSV data file, index it:</p>
-<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">Dauto</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
+<p>A great conduit of data into Solr is via CSV, especially when the documents are homogeneous by all having the
+same set of fields. CSV can be conveniently exported from a spreadsheet such as Excel, or exported from databases such
+as MySQL. When getting started with Solr, it can often be easiest to get your structured data into CSV format and then
+index that into Solr rather than a more sophisticated single step operation.</p>
+<p>Using <code>bin/post</code> index the included example CSV file:</p>
+<div class="codehilite"><pre><span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
</pre></div>
<p>In your terminal you'll see:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2<span class="p">:</span>$ <span class="n">java</span> <span class="o">-</span><span class="n">Dauto</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
-<span class="n">SimplePostTool</span> <span class="n">version</span> 1<span class="p">.</span>5
-<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="n">base</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">update</span><span class="p">..</span>
-<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,...</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">books</span><span class="p">.</span><span class="n">csv</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">csv</span><span class="p">)</span>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">SNAPSHOT</span><span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><sp
an class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
+<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>0<span class="p">.</span>0
+<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
+<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span class="n">otp</span><span class="p">,</span><span class
="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">books</span><span class="p">.</span><span class="n">csv</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">csv</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
1 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
-<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">update</span><span class="p">..</span>
-<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>084
+<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
+<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>099
</pre></div>
@@ -370,57 +385,68 @@ You can browse the documents indexed at
<p>Import records from a database using the <a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Structured+Data+Store+Data+with+the+Data+Import+Handler">Data Import Handler (DIH)</a>.</p>
</li>
<li>
-<p>Use <a href="https://cwiki.apache.org/confluence/display/solr/Using+SolrJ">SolrJ</a> for Java or other Solr clients to programatically create documents to send to Solr.</p>
+<p>Use <a href="https://cwiki.apache.org/confluence/display/solr/Using+SolrJ">SolrJ</a> from JVM-based languages or
+other <a href="https://cwiki.apache.org/confluence/display/solr/Client+APIs">Solr clients</a> to programatically create documents
+to send to Solr.</p>
</li>
<li>
-<p>Use the Admin UI <a href="http://localhost:8983/solr/#/collection1/documents">Documents tab</a> to paste in a document to be indexed, or select <code>Document Builder</code> from the <code>Document Type</code> dropdown to build a document one field at a time. Click on the <code>Submit Document</code> button below the form to index your document.</p>
+<p>Use the Admin UI core-specific Documents tab to paste in a document to be
+indexed, or select <code>Document Builder</code> from the <code>Document Type</code> dropdown to build a document one field at a time.
+Click on the <code>Submit Document</code> button below the form to index your document.</p>
</li>
</ul>
<hr />
<h2 id="updating-data">Updating Data</h2>
-<p>You may notice that even if you index content in this guide more than once, it does not duplicate the results found. This is because the example <code>schema.xml</code> specifies a "<code>uniqueKey</code>" field called "<code>id</code>". Whenever you POST commands to Solr to add a document with the same value for the <code>uniqueKey</code> as an existing document, it automatically replaces it for you. You can see that that has happened by looking at the values for <code>numDocs</code> and <code>maxDoc</code> in the "CORE"/searcher section of the statistics page...</p>
-<p><a href="http://localhost:8983/solr/#/collection1/plugins/core?entry=searcher">http://localhost:8983/solr/#/collection1/plugins/core?entry=searcher</a></p>
-<p><code>numDocs</code> represents the number of searchable documents in the index (and will be larger than the number of XML, JSON, or CSV files since some files contained more than one document). The maxDoc value may be larger as the maxDoc count includes logically deleted documents that have not yet been removed from the index. You can re-post the sample files over and over again as much as you want and <code>numDocs</code> will never increase, because the new documents will constantly be replacing the old.</p>
-<p>Go ahead and edit any of the existing example data files, change some of the data, and re-run the SimplePostTool command. You'll see your changes reflected in subsequent searches.</p>
+<p>You may notice that even if you index content in this guide more than once, it does not duplicate the results found.
+This is because the example <code>schema.xml</code> specifies a "<code>uniqueKey</code>" field called "<code>id</code>". Whenever you POST commands to
+Solr to add a document with the same value for the <code>uniqueKey</code> as an existing document, it automatically replaces it
+for you. You can see that that has happened by looking at the values for <code>numDocs</code> and <code>maxDoc</code> in the core-specific
+Overview section of the Solr Admin UI.</p>
+<p><code>numDocs</code> represents the number of searchable documents in the index (and will be larger than the number of XML, JSON,
+or CSV files since some files contained more than one document). The maxDoc value may be larger as the maxDoc count
+includes logically deleted documents that have not yet been physically removed from the index. You can re-post the sample files
+over and over again as much as you want and <code>numDocs</code> will never increase, because the new documents will constantly be
+replacing the old.</p>
+<p>Go ahead and edit any of the existing example data files, change some of the data, and re-run the SimplePostTool command.
+You'll see your changes reflected in subsequent searches.</p>
<h2 id="deleting-data">Deleting Data</h2>
-<p>You can delete data by POSTing a delete command to the update URL and specifying the value 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 specify them right on the command line rather than reference a JSON or XML file.</p>
-<p>Execute the following command to delete a specific document</p>
-<div class="codehilite"><pre>java -Ddata=args org.apache.solr.util.SimplePostTool "<span class="nt"><delete><id></span>SP2514N<span class="nt"></id></delete></span>"
+<p>You can delete data by POSTing a delete command to the update URL and specifying the value 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
+specify them right on the command line rather than reference a JSON or XML file.</p>
+<p>Execute the following command to delete a specific document:</p>
+<div class="codehilite"><pre>bin/post -c gettingstarted -d "<span class="nt"><delete><id></span>SP2514N<span class="nt"></id></delete></span>"
</pre></div>
-<hr />
-<section class="orange full-width">
- <h1>Way to go!!!</h1>
- <p>
- Round 2, check. Now get up and do some jumping jacks. Heck, go for a run and leave your house, you deserve it.
- </p>
- <div class="down-arrow"><a data-scroll href="#searching"><i class="fa fa-angle-down fa-2x red"></i></a></div>
-</section>
-
<h2 id="searching">Searching</h2>
-<p>Solr can be queried via REST clients cURL, wget, Chrome POSTMAN, etc., as well as via the native clients available for many programming languages.</p>
-<p>The Solr Admin UI includes a query builder interface - see the <code>collection1</code> query tab at <a href="http://localhost:8983/solr/#/collection1/query">http://localhost:8983/solr/#/collection1/query</a>. If you click the <code>Execute Query</code> button without changing anything in the form, you'll get 10 random documents in JSON format (<code>*:*</code> in the <code>q</code> param matches all documents):</p>
-<p><img style="border:1px solid #ccc" src="/solr/assets/images/quickstart-query-screen.png" alt="Solr Quick Start: collection1 Query tab" class="float-right"/></p>
-<p>The URL sent by the Admin UI to Solr is shown in light grey near the top right of the above screenshot - if you click on it, your browser will show you the raw response. To use cURL, just give the same URL in quotes on the <code>curl</code> command line:</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="c">%3A*&wt=json&indent=true"</span>
+<p>Solr can be queried via REST clients, cURL, wget, Chrome POSTMAN, etc., as well as via the native clients available for
+many programming languages.</p>
+<p>The Solr Admin UI includes a query builder interface - see the <code>gettingstarted</code> query tab at <a href="http://localhost:8983/solr/#/gettingstarted_shard1_replica1/query">http://localhost:8983/solr/#/gettingstarted_shard1_replica1/query</a>.
+If you click the <code>Execute Query</code> button without changing anything in the form, you'll get 10 documents in JSON
+format (<code>*:*</code> in the <code>q</code> param matches all documents):</p>
+<p><img style="border:1px solid #ccc" src="/solr/assets/images/quickstart-query-screen.png" alt="Solr Quick Start: gettingstarted Query tab"/></p>
+<p>The URL sent by the Admin UI to Solr is shown in light grey near the top right of the above screenshot - if you click on
+it, your browser will show you the raw response. To use cURL, give the same URL in quotes on the <code>curl</code> command line:</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="c">%3A*&wt=json&indent=true"</span>
</pre></div>
-<p>In the above URL, the "<code>:</code>" in "<code>q=*:*</code>" has been URL-encoded as "<code>%3A</code>", but since "<code>:</code>" has no reserved purpose in the query component of the URL (after the "<code>?</code>"), you don't need to URL encode it. So the following also works:</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="p">:</span><span class="o">*&</span><span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span>"
+<p>In the above URL, the "<code>:</code>" in "<code>q=*:*</code>" has been URL-encoded as "<code>%3A</code>", but since "<code>:</code>" has no reserved purpose in the
+query component of the URL (after the "<code>?</code>"), you don't need to URL encode it. So the following also works:</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="p">:</span><span class="o">*&</span><span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span>"
</pre></div>
<h3 id="basics">Basics</h3>
<h4 id="search-for-a-single-term">Search for a single term</h4>
-<p>To search for a term, give it as the <code>q</code> param value - in the Admin UI <a href="http://localhost:8983/solr/#/collection1/query">Query tab</a>, replace <code>*:*</code> with the term you want to find. To search for "foundation":</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">foundation</span>"
+<p>To search for a term, give it as the <code>q</code> param value in the core-specific Solr Admin UI Query section, replace <code>*:*</code>
+with the term you want to find. To search for "foundation":</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">foundation</span>"
</pre></div>
<p>You'll see:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>4<span class="p">.</span>10<span class="p">.</span>2$ <span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">foundation</span>"
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>0<span class="p">.</span>0$ <span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">foundation</span>"
<span class="p">{</span>
"<span class="n">responseHeader</span>"<span class="p">:{</span>
"<span class="n">status</span>"<span class="p">:</span>0<span class="p">,</span>
@@ -438,14 +464,19 @@ You can browse the documents indexed at
</pre></div>
-<p>The response indicates that there are 2,812 hits (<code>"numFound":2812</code>), of which the first 10 were returned, since by default <code>start</code>=<code>0</code> and <code>rows</code>=<code>10</code>. You can specify these params to page through results, where <code>start</code> is the position of the first result to return, and <code>rows</code> is the page size.</p>
-<p>To restrict fields returned in the response, use the <code>fl</code> param, which takes a comma-separated list of field names. E.g. to only return the <code>id</code> field:</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">foundation</span><span class="o">&</span><span class="n">fl</span><span class="p">=</span><span class="n">id</span>"
+<p>The response indicates that there are 2,812 hits (<code>"numFound":2812</code>), of which the first 10 were returned, since by
+default <code>start=0</code> and <code>rows=10</code>. You can specify these params to page through results, where <code>start</code> is the
+(zero-based) position of the first result to return, and <code>rows</code> is the page size.</p>
+<p>To restrict fields returned in the response, use the <code>fl</code> param, which takes a comma-separated list of field names.
+E.g. to only return the <code>id</code> field:</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">foundation</span><span class="o">&</span><span class="n">fl</span><span class="p">=</span><span class="n">id</span>"
</pre></div>
-<p><code>q=foundation</code> matches nearly all of the docs we've indexed, since most of the files under <code>docs/</code> contain "The Apache Software Foundation". To restrict search to a particular field, use the syntax "<code>q=field:value</code>", e.g. to search for <code>foundation</code> only in the <code>name</code> field:</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">name</span><span class="p">:</span><span class="n">foundation</span>"
+<p><code>q=foundation</code> matches nearly all of the docs we've indexed, since most of the files under <code>docs/</code> contain
+"The Apache Software Foundation". To restrict search to a particular field, use the syntax "<code>q=field:value</code>",
+e.g. to search for <code>foundation</code> only in the <code>name</code> field:</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">name</span><span class="p">:</span><span class="n">foundation</span>"
</pre></div>
@@ -461,8 +492,10 @@ You can browse the documents indexed at
<h4 id="phrase-search">Phrase search</h4>
-<p>To search for a multi-term phrase, enclose it in double quotes: <code>q="multiple terms here"</code>. E.g. to search for "CAS latency" - note that the space between terms must be converted to "<code>+</code>" in a URL (the Admin UI will handle URL encoding for you automatically):</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="o">\</span>"<span class="n">CAS</span><span class="o">+</span><span class="n">latency</span><span class="o">\</span>""
+<p>To search for a multi-term phrase, enclose it in double quotes: <code>q="multiple terms here"</code>. E.g. to search for
+"CAS latency" - note that the space between terms must be converted to "<code>+</code>" in a URL (the Admin UI will handle URL
+encoding for you automatically):</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="o">\</span>"<span class="n">CAS</span><span class="o">+</span><span class="n">latency</span><span class="o">\</span>""
</pre></div>
@@ -488,28 +521,40 @@ You can browse the documents indexed at
<h4 id="combining-searches">Combining searches</h4>
-<p>By default, when you search for multiple terms and/or phrases in a single query, Solr will only require that one of them is present in order for a document to match. Documents containing more terms will be sorted higher in the results list.</p>
-<p>You can require that a term or phrase is present by prefixing it with a "<code>+</code>"; conversely, to disallow the presence of a term or phrase, prefix it with a "<code>-</code>".</p>
-<p>To find documents that contain both terms "<code>one</code>" and "<code>three</code>", enter <code>+one +three</code> in the <code>q</code> param in the Admin UI <a href="http://localhost:8983/solr/#/collection1/query">Query tab</a>. Because the "<code>+</code>" character has a reserved purpose in URLs (encoding the space character), you must URL encode it for <code>curl</code> as "<code>%2B</code>": </p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="c">%2Bone+%2Bthree"</span>
+<p>By default, when you search for multiple terms and/or phrases in a single query, Solr will only require that one of them
+is present in order for a document to match. Documents containing more terms will be sorted higher in the results list.</p>
+<p>You can require that a term or phrase is present by prefixing it with a "<code>+</code>"; conversely, to disallow the presence of a
+term or phrase, prefix it with a "<code>-</code>".</p>
+<p>To find documents that contain both terms "<code>one</code>" and "<code>three</code>", enter <code>+one +three</code> in the <code>q</code> param in the
+core-specific Admin UI Query tab. Because the "<code>+</code>" character has a reserved purpose in URLs
+(encoding the space character), you must URL encode it for <code>curl</code> as "<code>%2B</code>":</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="c">%2Bone+%2Bthree"</span>
</pre></div>
-<p>To search for documents that contain the term "<code>two</code>" but <strong>don't</strong> contain the term "<code>one</code>", enter <code>+two -one</code> in the <code>q</code> param in the Admin UI. Again, URL encode "<code>+</code>" as "<code>%2B</code>":</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">collection1</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="c">%2Btwo+-one"</span>
+<p>To search for documents that contain the term "<code>two</code>" but <strong>don't</strong> contain the term "<code>one</code>", enter <code>+two -one</code> in the
+<code>q</code> param in the Admin UI. Again, URL encode "<code>+</code>" as "<code>%2B</code>":</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="c">%2Btwo+-one"</span>
</pre></div>
<h4 id="in-depth">In depth</h4>
-<p>For more Solr search options, see the Solr Reference Guide's <a href="https://cwiki.apache.org/confluence/display/solr/Searching">Searching</a> section.</p>
+<p>For more Solr search options, see the Solr Reference Guide's <a href="https://cwiki.apache.org/confluence/display/solr/Searching">Searching</a>
+section.</p>
<h3 id="faceting">Faceting</h3>
-<p>One of Solr's most popular features is faceting. Faceting allows the search results to be arranged into subsets (or buckets or categories), providing a count for each subset. There are several types of faceting: field values, numeric and date ranges, pivots (decison tree), and arbitrary query faceting. </p>
+<p>One of Solr's most popular features is faceting. Faceting allows the search results to be arranged into subsets (or
+buckets or categories), providing a count for each subset. There are several types of faceting: field values, numeric
+and date ranges, pivots (decision tree), and arbitrary query faceting.</p>
<h4 id="field-facets">Field facets</h4>
[... 142 lines stripped ...]