Quick Start

Beginner Level
This is a one pager on how to get up and running with a geographical search engine.
Later on we will discuss how to configure LocalSolr to meet your needs, as well as
LocalLucene which is the set of libraries used for geographical searching.

To begin with we will down load the a demo version of local solr, this demo contains a recent
version of local lucene and local solr with some sample data and a html / javascript UI.
It's designed to give you a quick view of local solr and help you get up and running with it quickly.


Requirements

  1. Java 1.5 configured and in your path, or at least a knowledge of how to run java.

Yes seriously that's about it...

First download the demo from http://www.nsshutdown.com/solr-example.tgz
Even though it's a .tgz (tarred, gzip) file winzip will open it for windows users.
Unix users can issue
tar -zvxf solr-example.tgz

After exploding / unzipping the file, you should be left with a solr-example directory
with the following layout


solr-example/

apache-solr-1.*/

dist/

example/

lib/

data/

ny_cinemas.xml


This shows that we have supplied localsolr with solr, and set it up with some data already.
Using a terminal, or windows dos prompt go to solr-example>apache-solr-1.*
(replace * with whatever version of apache-solr is supplied)

Then run

java -jar start.jar

The demo data has already been indexed, and the UI has been set up.
All you need to do is open up a browser and go to http://localhost:8983/localcinema/
Note:

As we are using google maps as a demo, google requires an API key which is bound to an url.
The one supplied in the demo is bound to "http://localhost:8983/localcinema/", if you wish to run it on
something other than your localhost, you need to register and apply for an API key from
http://code.google.com/apis/maps/

Click the "go" button on the page, and drag the map around.
LocalSolr supports sorting by score, distance, or any other indexed field that solr itself can sort on.