Information for: DEVELOPERS   PARTNERS

Installing Acquia Search with Solr 3 or 4 for Drupal 7

Important

EOL notice! Acquia Search with Solr 3/4 will reach end-of-life on Tuesday, March 1, 2022. For more information, see Frequently Asked Questions (FAQ) regarding End of Support for Acquia Search with SOLR 3/4.

Note

These instructions are for installing Acquia Search for Drupal sites running on the Acquia Platform only.

Use the following requirements and instructions to install the Acquia Search product with Solr 3 and 4 for Drupal 7.

Requirements

  • Prepare a local development environment for the project.
  • Contact Acquia Support to create a Solr 3 or 4 index.

Pick the right Drupal Search module ecosystem for you

For Drupal 7, you must pick one of the two module ecosystems that can use Solr:

  • Option A (recommended): Use the Search API module ecosystem

    Required modules:

    • acquia_connector.module
    • search_api.module
    • search_api_solr.module
    • search_api_acquia.module
  • Option B: Use the Apache Solr Search Integration module ecosystem

    Required modules:

    • acquia_connector.module
    • acquia_search.module
    • apachesolr.module

This decision should be based on your own research and testing. We recommend researching the search-related features you want to implement on your website and compare them to what these module ecosystems use.

Note

A single site should use only one of the preceding options. Enabling modules from both options can cause problems.

Installation process

Step 1: Prepare your new Drupal project, environment, or code base

To prepare your Drupal project, environment, or codebase, use your preferred method to copy a remote website configuration to your development environment.

Step 2: Install the Acquia Search Drupal modules

Option A) Installing the Search API Solr module ecosystem

Use the following procedure to install the Acquia Search for Search API module to enable the use of Acquia Search with Solr 3 or 4:

  1. Add the following entry to the Drupal settings.php file: $conf['acquia_search_disable_version_select'] = FALSE;

  2. Download and install the Acquia Search module, and any other required modules on your website.

  3. Connect to your Acquia subscription with your Cloud Platform credentials.

  4. On the Modules admin page, enable the Acquia Search for Search API module. Be sure to approve any additional required Acquia Search-related modules.

  5. Navigate to the Search API module configuration page at Configurations > Search API.

  6. Create a new Server at Configuration with the following settings:

    • Service class as Acquia Search
    • Acquia Search Solr version as Solr 6 and below
  7. Create a new index and select the new server you just created.

    Note

    If you see the message “To protect your data, the Search API Acquia module is enforcing read-only mode on the Search API indexes, because it could not figure out what Acquia-hosted Solr index to connect to”, make sure that a Solr index has been created or an index override has been specified.

    Important

    Acquia recommends using the Solr Devel module to debug Solr indexing and queries. For the troubleshooting guide, see Using Solr Devel module to debug Solr indexing and queries.

  8. Your Solr index of website content is built and maintained by periodic cron jobs. Depending on the amount of content on your website, the initial indexing process will take some time to complete.

Option B) Installing the Apache Solr Search Integration module ecosystem

Use the following procedure to install the Apache Solr Search module to enable the use of Acquia Search with Solr 3 or 4:

  1. Download and install the Acquia Search module, and any other required modules on your website.

  2. Connect to your Acquia subscription with your Cloud Platform credentials.

  3. Navigate to the Apache Solr Search module configuration page at Configurations > Apache Solr search > Settings.

  4. Create a new environment by clicking Add search environment and select Solr 6 and below from the Acquia Search Solr Core list. Upon selection, the rest of the fields will automatically fill in.

    Select the Make this Solr search environment the default option and click Save.

    Note

    If you see the message “Could not find a Solr index corresponding to your website and environment”, make sure that a Solr index has been created or an index override has been specified.

  5. Your Solr index of website content is built and maintained by periodic cron jobs. Depending on the amount of content on your website, the initial indexing process will take some time to complete. You can set the indexing rate for your website content during each cron run on the Apache Solr search > Default Index tab, under Actions.

    To determine the condition of the index, go to the Apache Solr Search > Default Index tab, in the Search Index Content section.