Loading...

Migrating to Acquia Search powered by SearchStax

Use Acquia Search powered by SearchStax to provide quick and relevant search results.

This page contains the steps to get started with Acquia Search powered by SearchStax using your existing Drupal search configurations and index data.

Prerequisites

  • Acquia Search or another Solr-based search powers the search functionality on your application.
  • One or more views are built based on a Search API-powered search index.
  • One or more Search API search indexes are hosted on one or more Search API search servers powered by Solr.
  • The application runs on the current Drupal version later than Drupal 8.
  • The Configuration Manager module is installed on your environment.
  • The Devel Module is installed on your environment. This is optional.
  • The latest version of Acquia Search. This is optional.
  • The latest version of Acquia Connector. This is optional.

The following steps require changes to your Drupal configuration and the modules installed on your Drupal applications. Therefore you must deploy to all environments, including production, to complete the migration from Acquia Search to Acquia Search powered by SearchStax.

Use the following checklist to migrate to Acquia Search powered by SearchStax:

S.No.

Task

Description

1

Prepare for the migration to Acquia Search powered by SearchStaxComplete the steps to prepare for the migration to Acquia Search powered by SearchStax.

2

Install the SearchStax module
  • Install the SearchStax module in your development environment using Composer and Drush commands.
  • Enable the SearchStax module, and replace your old Acquia Search server setup with the new SearchStax apps configuration.

3

Migrate the server from Drupal to Acquia Search powered by SearchStaxTransfer the relevant configuration and data to migrate the server.

4

Migrate the index from Drupal to Acquia Search powered by SearchStaxCreate a copy of the index to migrate it.

5

Migrate the views from Drupal to Acquia Search powered by SearchStaxSwitch views to the migrated index.

6

Enable the SearchStax module and route searches through itConfigure the SearchStax Studio module to redirect searches on your Drupal application to Site Search.

7

Validate the search pageTest the functionality and verify that your search page uses the Site Search app.

8

Execute rollback if requiredTo perform a rollback, if required, import the backup configuration.

9

Commit and deploy the changesCommit the updates, perform testing with CI/CD workflows, and deploy the changes to production.

10

Uninstall the migration moduleMigrate your existing Drupal index to SearchStax and then uninstall the migration module.

11

Remove the legacy Search module and configurationUninstall the Search module, remove configurations, and commit and deploy changes.

Manual migration

Migrate existing Drupal indexes and views to Acquia Search powered by SearchStax manually. For more information, visit Moving Drupal Indexes and Views to Site Search Manually.

Acquia recommends that you use the manual migration guide only in the following scenarios:

  • Drupal views implementation includes complex configurations.
  • Site uses a complex language setup with custom language fields.
  • Modules link directly to the index, such as a custom facets module.
  • Site is small enough to reindex in minutes and requires a straightforward migration path.
  • Issues are encountered with the migration module approach.

Did not find what you were looking for?

If this content did not answer your questions, try searching or contacting our support team for further assistance.

Back to Section navigation