Installing Acquia Search¶

Requirements¶

To use Acquia Search with Solr 7 on your website, you must meet the following requirements:

• Use only the specified module versions for Drupal 8 websites. Other module combinations haven’t been tested, and won’t work as intended.
• Make sure you have Composer to manage the autoloader, and other files.

Acquia Search Solr installation¶

To install Acquia Search Solr, complete the following steps:

1. Using Composer, run the following command ensuring you replace [version] with the most recent version of the module:

   composer require 'drupal/acquia_search_solr:[version]'
   

2. Enable Acquia Search Solr and all dependencies.

Acquia Search Solr configuration¶

You can configure the Acquia Search Solr module by completing the following steps:

1. Sign in to your Drupal website as an administrative user.

2. In the admin menu, click Configuration.

3. In the Search and metadata section, click Acquia Search Solr settings.

4. Retrieve your product keys from the Product Keys section of the Acquia Cloud user interface to connect your website to Acquia Search. See Managing your product keys for more information.

   

5. On the Acquia Search Solr settings page, be sure to add values to the following fields:

   • Acquia Subscription Identifier
   • Acquia Connector key
   • Acquia Search API > Acquia Search API hostname: Keep the default value specified by the module.
   • Acquia Application UUID

6. After you enter values for the previous fields, Acquia Search will display a list of available Search cores for your application.

   

Now, you can click the Search API configuration link to check the Search API server and index status.

Moving from Acquia Connector¶

Since the Acquia Search Solr module has conflicting composer.json requirements with Acquia Connector module version 8.x-1.x, you can’t install both modules together.

Troubleshooting Acquia Search Solr¶

Complete the following troubleshooting steps to help resolve issues with the Acquia Search Solr module:

• Use the Acquia Search Solr module messages on a Search API server or on an index page to understand why the module is failing.
• If the module is trying to connect to localhost or to the IP 127.0.0.1, the Acquia Search Solr module isn’t configured as expected or can’t detect the appropriate search core based on environment variables.
• On your website from the admin menu, go to Configuration > Search > Acquia Search Solr to start debugging. In case of a successful connection to the Search API module, a list of available search cores will display.
• If you are running the Acquia Search Solr module on a non-Acquia environment, you must use acquia_search_solr.settings.override_search_core to point the module to a search core. See the module’s README.txt for details.
• The Acquia Search Solr module has some hidden settings. See the README.txt for more details.

Drush commands¶

Acquia Search Solr includes several Drush commands to manage search from the command line.

For more details, see Drupal-acquia_search_solr-Commands-AcquiaSearchSolrCommands.