As an alternative to using the Apache Solr Search Integration module, Acquia Search supports using the Search API module. For most Drupal 7-based websites, we recommend that you use the Apache Solr Search Integration and related modules instead. Based on our extensive experience helping Acquia Search customers with both the Apache Solr Search Integration module and the Search API module, we have found that using the Apache Solr Search Integration module results in a search solution that is more scalable, better performing, better integrated with Apache Solr, and easier to configure and maintain.

Best practices for using Search API

The biggest thing to consider, if you choose Search API, is the time it takes to learn how to configure the module as intended. Since Search API has such extensive configuration options, mistakes are more common. When you consider scaling a website you must make conscious choices.

For example:

• Never do any text processing in Drupal. For example, the Search API processors, such as stopwords and synonyms, can be configured in Solr itself.

• Ensure you understand the memory footprint of the search page, and that the page is consistent with your server resources and configuration. Consider that search is a random result based on user input. When you use views and view modes to render your search results, you should either use the Solr fields to theme, or ensure your cache is large enough and your server is fast enough to render the entities returned on the search page. Entity caching makes a huge difference.

• Multisite searching in Search API (not multi-index searching, which is called search_api_multi) is difficult to achieve due to the architecture of Search API. The main intention wasn’t to display content not relying on entities in the current website. Multisite can mean Drupal multisite, or a combination of Drupal websites with a different codebase.

Setting up the Search API module with Acquia Search

If you want to use the Search API module with Acquia Search, complete the following steps:

1. Install and enable the following Drupal modules:

   • Search API Solr

   • Search API

   • Entity API

2. Connect your website to your Acquia subscription. For more information, see the Acquia Connector module.

3. Run cron manually to have Acquia confirm your search subscription status and allow you to enable the Acquia Search module.

   To run cron manually, complete the following steps:

   1. In the admin menu, select Reports.

   2. Click the Status report link.

   3. In the Cron maintenance tasks section, click the run cron manually link.

   After cron has finished, Acquia provisions Acquia Search for your website. The provisioning process can take several minutes to complete.

4. In the Acquia Search page of the Cloud Platform interface, click the gear icon to open the Acquia Search settings box.

5. Under ApacheSolr module version, select the version corresponding to the version of the Search API Solr module you are using, and click .

Unlike the Apache Solr Search module, the Search API module does not add a new option for the existing index search block and form. To search and display results, you’ll want to enable and configure either the Views module or the Search API pages module.

Using the Search API module

As the Drupal website administrator, configure the Search API Solr module by completing the following steps:

1. Navigate to Configuration > Search API settings > Add.

2. When adding a server for the Search API, set the Service class to Acquia Search; do not select Solr service.

3. Add or configure an existing index to use the new search server that you added.