Prepare Solr for production

After you’ve tested the Solr solution, you should perform the following tasks to get it ready for production:

• See more Solr configuration options in the Magento Commerce User Guide (available with the Magento Commerce release)
• Set up firewall rules to enable Solr and Magento to communicate
• Implement a custom web application deployed to a scalable application server
• Consider a dedicated Solr server, or at least deploying Solr to a different server than Magento
• Consider scalability by clustering Solr

• Customize Solr

  Customize the Solr search engine at your own risk. Magento supports only the options displayed in the Admin. Customizing the Solr engine itself, while potentially useful, can cause issues with Magento. If you encounter problems with your customizations, do not contact Magento Support; instead, consult the resources available from the Apache Solr Wiki.

• If you choose to enable SELinux, set up rules to allow Magento and Solr to communicate with each other

  SELinux settings are entirely up to you; Magento does not recommend either enabling it or disabling it. Because SELinux is very complex, make sure you have an experienced system administrator who can configure it.

• Script Solr startup and shutdown as discussed in Script Solr startup and shutdown

Multiple core configuration

If you have created multiple cores, make sure the value of the maxBooleanClauses parameter is the same on each. This parameter is defined in each core’s solrconfig.xml file. Solr uses the value defined for the core that initialized most recently as the value for all cores. The default value for the Magento installation is 10240.

If one or more of the maxBooleanClauses parameters is set too low, the search results page could display no results.

Script Solr startup and shutdown

In a production environment, you should start and stop Solr using a script.

Create a script named /etc/init.d/solr with options similar to the following:

#!/bin/sh

#Starts, stops, and restarts Apache Solr.
#chkconfig: 35 92 08
#description: Starts and stops Apache Solr

SOLR_DIR="<your Solr install dir>"
JAVA_OPTIONS="-Xmx1024m -DSTOP.PORT=<jetty-stop-port> -DSTOP.KEY=<jetty-stop-key> -jar  start.jar"
LOG_FILE="<path-to-solr-log-file>"
JAVA="<java_home>"

case $1 in
start)
echo -n "Starting Solr"
cd $SOLR_DIR
$JAVA $JAVA_OPTIONS 2> $LOG_FILE &
;;
stop)
echo -n "Stopping Solr"
cd $SOLR_DIR
$JAVA $JAVA_OPTIONS --stops
;;
restart)
$0 stop
sleep 1
$0 start
;;
*)
echo "Usage: $0 {start|stop|restart}" >&2
exit 1
;;
esac

All parameters shown in the following table are required.

An example follows:

#!/bin/sh

#Starts, stops, and restarts Apache Solr.
#chkconfig: 35 92 08
#description: Starts and stops Apache Solr

SOLR_DIR="/opt/solr/apache-solr-4-10-4/example"
JAVA_OPTIONS="-Xmx1024m -DSTOP.PORT=8079 -DSTOP.KEY=mykey -jar  start.jar"
LOG_FILE="/var/log/solr.log"
JAVA="/usr/bin/java"

case $1 in
start)
echo -n "Starting Solr"
cd $SOLR_DIR
$JAVA $JAVA_OPTIONS 2> $LOG_FILE &
;;
stop)
echo -n "Stopping Solr"
cd $SOLR_DIR
$JAVA $JAVA_OPTIONS --stop
;;
restart)
$0 stop
sleep 1
$0 start
;;
*)
echo "Usage: $0 {start|stop|restart}" >&2
exit 1
;;
esac

To complete the script:

• Make sure you saved the edited version of the script.

• Give the script executable permissions as follows:

  chmod +x /etc/init.d/solr
  

• You can now start, stop, and restart Solr as follows:

  Start Solr: /etc/init.d/solr start

  Stop Solr: /etc/init.d/solr stop

• Restart Solr: /etc/init.d/solr restart