Using the Search API module¶

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:

   • Acquia Search for Search API
   • 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 Save.

6. 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.

Unlike the Apache Solr Search module, the Search API module doesn’t 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.