---
title: "Preparing for the migration to Acquia Search powered by SearchStax"
date: "2025-02-12T09:45:16+00:00"
summary: "Learn how to prepare for migrating to Acquia Search powered by SearchStax. Follow our step-by-step guide to set up your environment, create backups, and document your current search configuration for a smooth transition."
image:
type: "page"
url: "/acquia-cloud-platform/preparing-migration-acquia-search-powered-searchstax"
id: "a9722383-59d6-4153-ad0a-d491e0eb2422"
---

Requirements
------------

The following requirements must be met before you start the migration process:

*   The Search functionality on the application must be powered by Acquia Search or another Solr-based search.
*   One or more views must be built based on a Search API-powered search index.
*   One or more Search API search indexes must be hosted on one or more Search API search servers powered by Solr.
*   The application must run on a Drupal version later than Drupal 8.
    
    Warning
    
    If you use an older version of Drupal, such as Drupal 7, skip the migration module and connect to SearchStax directly by following the general setup guide outlined in the [Getting Started with Site Search](https://support.searchstax.com/hc/en-us/categories/11675838621325-Site-Search) page.
    

Prerequisites
-------------

The following steps must be completed before you start the migration process:

1.  Install the latest version of [Search API](https://www.drupal.org/project/search_api_solr).
2.  (Optional) Install the latest version of [Acquia Search](https://www.drupal.org/project/acquia_search).
3.  (Optional) Install the latest version of [Acquia Connector](https://www.drupal.org/project/acquia_connector).
4.  (Optional) Install the [Devel Module](https://www.drupal.org/project/devel) on your environment.
5.  (Optional) Review the [flood controls](https://docs.acquia.com/acquia-cloud-platform/configuring-flood-controls-acquia-search-powered-searchstax-drupal-module "https://docs.acquia.com/acquia-cloud-platform/configuring-flood-controls-acquia-search-powered-searchstax-drupal-module").
6.  (Optional) Install the [Key Module.](https://www.drupal.org/project/key)
    
    Note
    
    If you use the Search API attachments module, follow the instructions in [this document](https://support.searchstax.com/hc/en-us/articles/39885196332941-Extract-text-from-PDFs).
    
7.  Before you proceed, create an on-demand backup of your database. For more information, visit [On-demand database backups](/acquia-cloud-platform/docs/manage-apps/back#section-on-demand-database-backups).
8.  Document your current search setup.
    
    Review and maintain a record of the following:
    
    *   The names of your Apache Solr servers (labelled as 1 in the screenshot)
    *   The names of your indexes (labelled as 2 in the screenshot)
    *   The number of items that are currently indexed by your Search Solr server (labelled as 3 in the screenshot)
        
        ![srsx-server_&_index](https://acquia.widen.net/content/017244f6-43d1-4b1c-b605-5707dbbc0408/web/9758c_srsx-server_&_index.png?h=480&itok=KXfYQT-y)
        
    *   Drupal search results views (labelled as 4 in the screenshot)
        
        ![srsx-drupal_search_results_views](https://acquia.widen.net/content/0c15a1c7-4ca6-403c-ad90-1f6749e2dc91/web/aecac_srsx-drupal_search_results_views.png?w=480&itok=excPa7wc)
        
    *   Search behaviors including autocomplete settings (labelled as 5 in the screenshot)
        
        ![srsx-autocomplete_settings](https://acquia.widen.net/content/2773eeae-6aed-4adc-be0b-68343d27bd8c/web/006d8_srsx-autocomplete_settings.png?w=480&itok=zx8BkiEV)
        

Next step
---------

[Install the SearchStax module](/acquia-cloud-platform/installing-searchstax-module "Installing the SearchStax module")