Information for: DEVELOPERS   PARTNERS

Upgrading Drupal 7 to Acquia Search with Solr 7

Note

These instructions are for upgrading Acquia Search for Drupal sites running on the Acquia Platform only.

Drupal 7 developers can use the Apache Solr Search or Acquia Search for Search API modules to connect to Acquia Search. Choose the upgrade approach based on the module you use to connect to Solr 3 or Solr 4.

Important

After upgrading to Acquia Search with Solr 7, you cannot revert to an earlier version of Acquia Search unless you perform a full code and database restore, and manually import the configuration of required elements.

Acquia Search for Search API

Note

Currently, Solr version selection through the Drupal admin UI is disabled by default so following these instructions requires you to add the following to settings.php:

$conf['acquia_search_disable_version_select'] = FALSE;

You can follow one of the following two options:

Change existing server to use Solr 7

This approach requires only a simple configuration change, but Search will not be available to site visitors while content is indexed in the new server or indexes.

  1. Create a new Acquia Search Solr 7 index for the desired database in your Acquia Cloud environment.

  2. Upgrade to the latest stable release of Acquia Connector 7.x-3.x.

  3. Upgrade to the latest stable release of Acquia Search for Search API 7.x-1.x.

  4. Navigate to Configuration > Search and metadata > Search API.

  5. Edit your existing server and set Acquia Search Solr version as Solr 7 and above.

    Note

    If you see the message “Could not find a Solr index corresponding to your website and environment”, make sure that a Solr index has been created or an index override has been specified. If you see the message “You are using an incompatible schema.xml configuration file, follow the instructions in the handbook for setting up Solr”, and check that the Solr 7 configset for the Solr index is specified.

  6. Re-index data in all indexes using this server.

Create a new Solr 7 server

This approach keeps Search available to site visitors while content is indexed in the new server or indexes. However, it requires you to re-configure all of your indexing options from scratch for the new index. You need to modify your site settings (such as Views or Search Pages) to point to the new index.

  1. Create a new Acquia Search Solr 7 index for the desired database in your Acquia Cloud environment.

  2. Upgrade to the latest stable release of Acquia Connector 7.x-3.x.

  3. Upgrade to the latest stable release of Acquia Search for Search API 7.x-1.x.

  4. Create a new server at Configuration > Search and metadata > Search API > Add server with the following settings:

    • Service class as Acquia Search
    • Acquia Search Solr version as Solr 7 and above
    • Make sure that this server is disabled, you can enable it once the data is indexed.
  5. Create a new index at Configuration > Search and metadata > Search API > Add index. Select the new server you just created.

    Note

    If you see the message “Could not find a Solr index corresponding to your website and environment”, make sure that a Solr index has been created or an index override has been specified. If you see the message “You are using an incompatible schema.xml configuration file, follow the instructions in the handbook for setting up Solr”, and check that the Solr 7 configset for the Solr index is specified.

  6. Re-index data in the new index.

  7. Modify your site settings (such as Views or Search Pages) to point to the new index.

Troubleshooting

Acquia recommends using the Solr Devel module to debug Solr indexing and queries. For the troubleshooting guide, see Using Solr Devel module to debug Solr indexing and queries.