adding documentation on solr setup

docs/source/getting_started.rst

@@ -7,6 +7,7 @@ There are several steps involved to setting up your ecommerce project:
    :maxdepth: 2
 
    getting_started/installation
+   getting_started/search
    getting_started/customising_models
    getting_started/overriding_core_classes
    getting_started/create_product_catalogue

docs/source/getting_started/installation.rst

@@ -54,6 +54,7 @@ Add the following to your `INSTALLED_APPS`::
     'oscar.image',
     'oscar.shipping',
     'oscar.customer',
+    'oscar.search',
     
 Now fill in the normal settings (not related to django-oscar) within ``settings.py`` - eg ``DATABASES``, ``TIME_ZONE`` etc    
 

docs/source/getting_started/search.rst

@@ -0,0 +1,54 @@
+.. _solr-debian-installing:
+
+Search within Oscar
+*******************
+
+Oscar makes use of Solr for searching, faceting and 'more like this' handling.
+
+This guide details the process of install solr on debian based systems.
+
+
+Installing Solr
+===============
+
+Solr is a java application which needs to run inside a Java servlet container (e.g. Tomcat).
+On Debian based system (including Ubuntu) you can install it directly from the apt repository::
+
+    $ apt-get install solr-tomcat
+
+.. _solr-debian-configuring:
+
+Configuring Solr
+================
+
+1. Export the solr schema from the project::
+
+    $ ./manage.py build_solr_schema > schema.xml
+
+2. copy ``schema.xml`` over existing solr ``schema.xml``::
+
+    $ cp schema.xml /etc/solr/conf/schema.xml
+
+3. Enable the ``More Like This`` request handler::
+
+    $ vim /etc/solr/conf/solrconfig.xml
+
+4. Add the following somewhere before the final closing tag::
+
+    <requestHandler name="/mlt" class="org.apache.solr.handler.MoreLikeThisHandler">
+        <lst name="defaults">
+        <str name="mlt.interestingTerms">list</str>
+        </lst>
+    </requestHandler>
+
+5. Restart tomcat::
+
+    $ /etc/init.d/tomcat6 restart
+
+6. Rebuild the complete index::
+
+    $ ./manage.py rebuild_index
+
+You can also update the index with::
+
+    $ ./manage.py update_index