How to configure Magento Enterpise to use Solr as the main search engine?

Question

I tried looking for documentation but it is quite sparse. I wrote the following guide hoping that it might save someone 2-3 hours dealing with installations, setup and configura

Answer 1

Magento - Solr Installation & Configuration

1. Make sure the Java JDK is installed:
   1. sudo add-apt-repository ppa:sun-java-community-team/sun-java6
   2. sudo apt-get update
   3. sudo apt-get install sun-java6-jre sun-java6-jdk
      
      

2. Install & Configure Tomcat:

   • Installation:
     sudo apt-get install tomcat6 tomcat6-admin tomcat6-common tomcat6-user
   • Configuration:
     vi /etc/tomcat6/tomcat-users.xml

   • Add the following roles and user to the configuration.

     <role rolename="admin"/>
     <role rolename="manager"/>
     <user username="tomcat" password="password" roles="admin,manager"/>
     

   • Restart the server: /etc/init.d/tomcat6 restart

     If all goes well, goto http://hostname:8080

3. Install Solr:

   • Check for the latest distro here.. http://apache.rediris.es/lucene/solr/
   • Download release http://apache.rediris.es/lucene/solr/3.3.0/apache-solr-3.3.0.zip

   • Install & Configure

     1. unzip apache-solr-3.3.0.zip
     2. mkdir /usr/share/tomcat6/webapps
     3. cp apache-solr-3.3.0/dist/apache-solr-3.3.0.war /usr/share/tomcat6/webapps/solr.war
     4. cp -r apache-solr-3.3.0/example/solr /usr/share/tomcat6/solr

     5. vi /etc/tomcat6/Catalina/localhost/solr.xml

        <Context docBase="/usr/share/tomcat6/webapps/solr.war" debug="0" 
        privileged="true" allowLinking="true" crossContext="true">
        <Environment name="solr/home" type="java.lang.String" 
        value="/usr/share/tomcat6/solr" override="true" />
        </Context>
        

     6. chown -r tomcat6.tomcat6 /var/lib/tomcat6
     7. /etc/init.d/tomcat6 restart

   • You should see Solr access on your Tomcat admin/manager page (http://hostname:8080/manager/html)

4. Configure Magento to use Solr:

   1. Replace the original Solr conf directory with the Magento conf files. The trick is just to copy the directory from Magento, and replace the one in Solr. That's it!

      • In Magento, the folder is located in: [magento-instance-root]/lib/Apache/Solr/conf.
      • In Solr, the folder is located in [Solr-instance-root]/example/solr/conf.
        
        
   2. Configure Solr in Magento: In admin, goto System -> Configuration -> Catalog -> Catalog Search

---

Troubleshooting:

Make sure all configuration files belong to tomcat6:tomcat6
chown -r tomcat6.tomcat6 ...

• /var/lib/tomcat6/conf/Catalina/localhost
• /usr/share/tomcat6/solr/conf