Integrating Solr 4.5 in Enterprise Server 10

Integrating Solr 4.5 in Enterprise Server 10 consists of performing the following steps (listed in the order in which they should be carried out):

Note: It is assumed here that Solr runs within Tomcat.

1. Installing Solr

For information about installing Solr, please refer to the Apache Solr Reference Guide (PDF).

2. Configuring Solr

Tip: (For Enterprise Server 10.1 or higher only) Easily manage and configure settings of all configuration files by adding them to a single configuration file.

For use with Enterprise Server, configure Solr as follows:

Step 1. Edit the <tomcat>/conf/tomcat-users.xml file to:

<xml version='1.0' encoding='utf-8'?>
	<tomcat-users>
		<role rolename="manager-gui"/>
		<role rolename="standard"/>
	<user username="woodwing" password="ww" roles="standard,manager-gui"/>
</tomcat-users>

Note: The user specified in “username” is needed to manage Tomcat; it is not an Enterprise user.

Step 2. Open the Solr configuration file on Enterprise Server:

<Enterprise installation directory>/config/config_solr.php

Step 3. Verify if the correct URL is defined in the SOLR_SERVER_URL setting.

Example: define ('SOLR_SERVER_URL', 'http://localhost:8080/solr');

Step 4. Verify if the correct collection is defined in the SOLR_CORE setting.

Example: define ('SOLR_CORE', 'collection1');

Step 5. (Optional) Define the time-out duration in the SOLR_TIMEOUT setting.

Example: define ('SOLR_TIMEOUT', 5);

Note: Changing this value may be necessary when time-outs occur while indexing many objects. However, usually it is better to adjust the solrconfig.xml file by changing settings such as ramBufferSizeMB, mergeFactor, and autoCommit.

3. Installing the Enterprise Schema

In this step, the default Solr schema file is replaced by the Enterprise version.

Step 1. Unpack the file SolrEnterprise_10.x.x_Buildyz.zip that is delivered together with the Enterprise Server installation.

Step 2. Copy the file named schema.xml to <solr>/<corename>/conf/. Confirm that you want to overwrite the already existing schema.xml file.

Note: The core name is usually 'collection1'.

Step 3. Copy the file named solrconfig.xml to <solr>/<corename>/conf/. Confirm that you want to overwrite the already existing solrconfig.xml file.

Step 4. Do one of the following:

• Restart Tomcat server.
• On the admin page of Solr 4, click Reload for the appropriate collection.

4. Testing the integration

Step 1. In Enterprise Server, access the Server Plug-ins Maintenance page in order to activate the Solr Search plug-in.

Step 2. In Enterprise Server, access the Health Check page and run the Solr Search Server test.

Troubleshooting

Error when (re-)indexing Solr 4.5: "Operation timed out after 5000 milliseconds with 0 bytes received"

When this error is shown in the log files after (re-)indexing Solr 4.5, increase the value of the SOLR_TIMEOUT setting (for example by doubling it) in the <Enterprise installation directory>/config/config_solr.php file.