Information for: DEVELOPERS   PARTNERS

Upgrading Drupal 8 to Acquia Search with Solr 7

Use the following requirements and instructions to upgrade from Acquia Search with Solr 3 or 4 to Acquia Search with Solr 7.

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.

Requirements

  • Prepare a local, virtual development environment for the project.
  • Install the following applications for use with your development environments:
  • Create an SSH key for your user, and provide access to that key to your Cloud Platform environment.
  • Create an index for your website

Upgrade process

The upgrade process includes the following sections:

Prepare your new Drupal project, environment, or code base

To prepare your Drupal project, environment, or codebase, use your preferred method (such as Acquia BLT) to copy a remote website configuration to your development environment.

Upgrade to the new Acquia Search Drupal modules

Use the following procedure to upgrade your existing modules to enable the use of Acquia Search with Solr 7:

Note

Acquia strongly recommends using the Acquia Connector module with Acquia Search. Use of Acquia Connector gives users access to Acquia Insight, uptime monitoring, and simplified, automatic configuration of Search. Also, Acquia Connector enables automatic connection of a customer’s site to Acquia Search. If you don’t require Acquia Insight or uptime monitoring, or want to manually configure Acquia Search, you can use the Acquia Search module without Acquia Connector.

  1. If you’re using the Acquia Connector module, run the following command to update the Acquia Connector module to the latest version:

    composer update drupal/acquia_connector --with-dependencies
    

    If Composer doesn’t update the module successfully, use the following command instead:

    composer require "drupal/acquia_connector:^3.0"
    
  2. Install the Acquia Search module.

    composer require "drupal/acquia_search:^3.0.0"
    

    Enable the Acquia Search module:

    drush en acquia_search
    

Reindex

Note

When upgrading from Acquia Search 2.0 to Acquia Search 3.0, reindexing is required, as the Solr indexes are independent and start out empty.

You’ve now completed the upgrade from Acquia Search with Solr 4 to Acquia Search with Solr 7.

Moving from Acquia Connector

Since the Acquia Search module has conflicting composer.json requirements with Acquia Connector module version 8.x-1.x, you can’t install both modules together.

Important

Subscribers using Acquia Search with Solr 3 or 4 must upgrade Acquia Connector 8.x-1.x to 8.x-3.x and install the Acquia Search 2.x module before upgrading to Solr 7.

Note

Subscribers using Acquia Search with Solr 7 who require Acquia Insight or uptime monitoring must also use Acquia Connector version 8.x-3.x or later. If you don’t require Acquia Insight or uptime monitoring, you can continue to use the Acquia Search module without Acquia Connector.

Troubleshooting Acquia Search Solr

Complete the following troubleshooting steps to help resolve issues with the Acquia Search module:

  • Use the Acquia Search module messages on a Search API server or on an index page to understand why the module is failing.
  • If the module is trying to connect to localhost or to the IP address 127.0.0.1, the Acquia Search module isn’t configured as expected or can’t detect the appropriate search core based on environment variables.
  • Ensure that the Drupal site can properly reach the Acquia Search API service, which provides the list of available Solr indexes for your Application to your Drupal site. To do this, go to the Search API Server you are trying to configure, and then click Edit. If properly connected, a list of available search cores will display in the SOLR CORE(S) CURRENTLY AVAILABLE FOR YOUR APPLICATION box.
  • If you are running the Acquia Search module on a non-Acquia environment, see the instructions on Overriding Solr core connection switching.

Drush commands

Acquia Search Solr includes several Drush commands to manage search from the command line.

Note

For more information about Drush, see the Introduction to Drush.

Command Description
acquia:search-solr:cores Lists all available search cores. Supports --format=value option. Valid options: json, var_dump or var_export, print_r. Defaults to print_r.
acquia:search-solr:cores:cache-reset Clears the Acquia Search core cache for the default Acquia subscription identifier provided by the module configuration or via --id=CORE-ID option.
acquia:search-solr:cores:possible Lists all possible Acquia Search cores. Supports --format=value option. Valid options: json, var_dump or var_export, print_r. Defaults to print_r.

For more details, see Drupal-acquia_search_solr-Commands-AcquiaSearchSolrCommands.