Configure the Acquia Cloud Connector

Updated

Acquia Cloud, including Acquia Site Factory, uses the SearchStax Drupal connector. Follow this guide to configure the connector for your Acquia-hosted Drupal site and send content to a SearchStax Site Search App.

Prerequisites

  • Administrator access to your Acquia-hosted Drupal site and permission to install or configure modules.
  • A SearchStax Site Search App with an Update endpoint and Read & write token.
  • A plan for the content, fields, languages, and environments that should be indexed.

1. Install and Enable Required Modules

  1. Install the Drupal Search API, Search API Solr, and SearchStax modules.
  2. Enable the modules in Extend.

Composer is recommended for installation. Use your standard process for enabling modules in your environment.

2. Create the Search API Server

  1. Go to Configuration > Search and metadata > Search API.
  2. Select Add server, enter a name, and set Backend to Solr.
  3. Set Solr connector to SearchStax Cloud with Token Auth.
  4. Enter your app's Update endpoint and Read & write token from Site Search > App Settings > All APIs > Search & Indexing, then select Save.

If you connect multiple Acquia environments, use a separate SearchStax App for each environment so indexing tasks do not replace data in a shared App.

3. Create the Index and Choose Fields

  1. From Search API, select Add index, choose Content as the data source, select the SearchStax server, and select Save and add fields.
  2. Select the fields you want to index, such as rendered_item, langcode, status, uid, content, body, title, and published date.
  3. Mark searchable fields as fulltext, enable HTML filter in Processors, and save.
  4. Open the index and select Index now, or wait for the scheduled indexing run.

4. Configure SearchStax Settings

  1. Go to Administration > Configuration > Search and metadata > SearchStax settings.
  2. Configure optional Analytics credentials and choose whether Drupal searches should use Site Search configurations.
  3. Select Save configuration.

5. Map Drupal Fields to Site Search

In Site Search, go to Basic configurations > Results fields and map the Drupal fields used for titles, descriptions, URLs, dates, and other result data.

6. Verify the Connection

  1. Confirm that the index reports a successful connection and indexing run.
  2. Open Search Preview and test representative titles, fields, and URLs.

For advanced Drupal settings, tracking, Acquia Search migration guidance, troubleshooting, and the complete configuration procedure, see Configure the Drupal Connector.

Articles in this section