Occasionally, you must override the auto switching behavior in Acquia Search for specific reasons (which can include the following):
Important
Sharing a single Solr index across websites has risks. For more information, see Sharing Solr indexes in read/write mode.
To stop Acquia Search from enabling auto switching, use one of the following methods:
Acquia Search subscribers can choose to manually configure the connections in
the settings.php
file by overriding variables. For non-hosted subscribers,
setting these variables is the only available method to use multiple
Acquia Search Solr indexes.
Note for Site Factory subscribers
Site Factory subscribers must modify the following provided code examples to
use $GLOBALS['gardens_site_settings']['env']
instead of
$_ENV['AH_SITE_ENVIRONMENT']
, as the value of
$_ENV['AH_SITE_ENVIRONMENT']
changes during the code deployment
process.
Select the code override to use based on your installed Drupal version and the module in use, from the following tabs:
To override the connection:
settings.php
file after the Acquia include statement.// Override the ID of the Acquia Search Solr core to use.
// Replace ABCD-123456.env.mysite with the Solr core ID you wish to connect to
// For acquia_search-8.x-3.x
$settings['acquia_search']['override_search_core'] = 'ABCD-123456.env.mysite';
// connect to the ABCD-12345.dev.mysite Solr index
$conf['acquia_search']['SEARCH_SERVER_ID']['possible_cores'] = "ABCD-12345.dev.mysite";
Note
Acquia recommends prefixing the search ecosystem to your server id. For new installs, the default Search Server IDs are as follows:
Note for Site Factory subscribers
Site Factory subscribers must modify the following provided code examples to
use $GLOBALS['gardens_site_settings']['env']
instead of
$_ENV['AH_SITE_ENVIRONMENT']
, as the value of
$_ENV['AH_SITE_ENVIRONMENT']
changes during the code deployment
process.
Setting $settings['acquia_search']['read_only']
to FALSE
avoids auto
switching, causing the production Solr index to enforce read/write mode as
shown in the following code example:
$settings['acquia_search']['read_only'] = FALSE;