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

  • Solr Search is used to power 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

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

2

Installing the SearchStax moduleInstall the SearchStax module in your development environment using Composer and Drush commands.

3

Enabling the SearchStax modulesEnable the SearchStax module, and replace your old Acquia Search server setup with the new SearchStax apps configuration.

4

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

5

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

6

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

7

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

8

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

9

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

10

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

11

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

12

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

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