Close [x]

Prepare Solr for production

Edit this page on GitHub

This topic applies to Enterprise Edition only

Prepare Solr for production

After you鈥檝e tested the Solr solution, you should perform the following tasks to get it ready for production:

  • See more Solr configuration options in the Magento EE User Guide (available with the Magento 2 EE 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

  • Apache Solr WikiCustomize Solr</a>

    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 the next section

Script Solr startup and shutdown

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

You must perform all tasks discussed in this section as a user with root privileges.

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.

Value Description
<your Solr install dir> The absolute file system path to your Solr installation. (For example, /etc/solr/apache-solr-3.6.2
<jetty-stop-port>
<jetty-stop-key>		 Security parameters used to prevent malicious attempts to stop Jetty. For -DSTOP.PORT=, specify any unused port. For -DSTOP.KEY=, specify a string. If you omit a value for -DSTOP.KEY=, Jetty generates a random key you must enter to stop Jetty. For more information, see Securing Jetty.
<path-to-solr-log-file> Absolute file system path to the Solr log file. (For example, /var/log/solr.log)
<java_home> Absolute file system path to your Java executable. (For example, /usr/bin/java)

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