Cloud Platform
FAQs and troubleshooting
To resolve issues with the Acquia Search module:
localhost or to the IP address 127.0.0.1, the Acquia Search module is not configured as expected or cannot detect the appropriate search index based on environment variables.Check 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 check the site connection with the Acquia Search API Service, complete the following steps:
If properly connected, the system displays a list of available search indexes in the SOLR INDEXES CURRENTLY AVAILABLE FOR YOUR APPLICATION box.
$settings['acquia_search']['override_search_core'] to point the module to a search index. For more information, see README.txt.Acquia recommends using the Solr Devel module to debug Solr indexing and queries. For troubleshooting, see Using Solr Devel module to debug Solr indexing and queries.
When you configure Acquia Search, you decide what entity types get included in the search index and are available to return to users as search results. Examples include nodes like articles, pages, and blocks, taxonomy terms, users, and files. You can include file attachments, if you install and configure the Drupal 7 Apache Solr Search Attachments module.
Yes, Acquia Search uses the Apache Lucene Query Parser Syntax.
Yes, you may use \* (several characters) and ? (single character) wildcards. Searches may not begin with wildcards or other logical operators.
Yes. This feature requires installing and configuring the Apache Solr Search Attachments module. For setup and configuration information, see Indexing attachments with Apache Solr Search module.
Yes. This feature requires installing and configuring the Apache Solr Multisite Search module.
No, Acquia Search does not support near-realtime search. The required configuration would jeopardize the Search-as-a-service platform and cause issues with performance and stability. Also, Acquia does not allow the modification of the solrconfig.xml file to increase the frequency of auto commits.
Acquia Search can index websites in most languages, but Acquia Search passes content through a language-specific stemmer during indexing, depending on the search schema you have configured for your website. Acquia Search offers search schemas for Dutch, French, German, Spanish, and English. You can search other languages, but the search may produce less relevant search results because partial words, plurals and other variations may not be indexed as expected. For more information, see Selecting a language.
If your website is in a language other than Dutch, English, French, German, or Spanish, create a Support ticket to see whether a search schema specific to that language is available for you.
You can select standard configurations on the Search page of the Acquia user interface. If you are an Enterprise customer who needs a custom configuration (typically a schema.xml or synonyms.txt file), you can upload your own custom configuration directly in the Cloud Platform user interface. For more information, see Custom Solr configuration. If you need help developing a custom configuration, contact Acquia sales to discuss your needs and implementation possibilities through Acquia’s professional services division.
Yes, you can use the Search API module with Acquia Search. This is an alternative to using the Apache Solr Search module. Acquia Search for the current Drupal version requires the use of Search API, and won’t use the ApacheSolr module.
Don’t use both the Search API module and the Apache Solr Search module in the same environment.
For more information, read Using the Search API.
Acquia Search does not support using Nutch to index external data. For data security, the Acquia Search architecture requires authentication, which Nutch does not natively support.
Acquia recommends exporting your non-Drupal content into a Drupal website using contributed modules such as Feeds or Migrate to transform your data into Drupal entities, which Acquia Search may then index.
Acquia counts select (searching) and update (indexing) requests reaching the Acquia Search back end.
Yes, Drupal modules can index more than one item at a time in a single Solr update request.
Yes, both custom and provided Solr 7 configsets are compatible with Solr 8.
| Error message | Description | Resolution |
|---|---|---|
The uploaded file is not a valid ZIP archive. | The uploaded file is not zip archived. | Upload a zip file with a .zip extension. |
File in the archive starts with "Byte Order Mark". | The file in the archive starts with a Byte Order Mark (BOM) character. This character is added by Microsoft OS. | Remove the Byte Order Mark (BOM) character from the start of the file. |
File in the archive refers to an unavailable file. | A file is not present in the archive. | Insert the missing file into the archive. |
File has invalid line endings, Use Unix style. | The file contains lines with a line ending other than UNIX. Acquia Search supports UNIX style. |
Acquia Search may experience downtime when servers are rebooted for security reasons.
Use the following steps when you troubleshoot issues with Acquia Search with the Apache Solr Search module:
/admin/settings/apachesolr/query-fields to ensure no major fields are configured to Omit. Also, scroll to the bottom of /admin/settings/apachesolr/content-bias and check which content types are excluded from indexing.Find the last node indexed by completing the following steps:
Run the following command:
drush -vd search-indexAt some point, you’ll start seeing notices about what node IDs failed to index. Run the following command and note the limit:
drush vget apachesolr_cron_limitDivide the number returned by the previous command by 2, and then use the resulting number with the following command:
drush vset apachesolr_cron_limit [value]For example, if you have 100 results, run the following command:
drush vset apachesolr_cron_limit 501 as the returned number.When you reach 1, you will know which node is causing problems.
Another technique to find the last indexed node is to use the following command:
drush vget apachesolr_index_lastUse the following command for Drupal 7:
drush php-eval 'module_load_include("inc", "apachesolr", "apachesolr.index"); $rows = apachesolr_index_get_entities_to_index(apachesolr_default_environment(), "node", 1); foreach ($rows as $row) { print_r($row); }'In the current Drupal version, views exposed filters, such as search results and blocks with facets, must not have caching enabled alongside AJAX, as the views AJAX request does not pass along the ?f[0]= parameters used by exposed filters or facets to filter results as expected. The open issue on Drupal.org, AJAX facet block seems to lose views context, will be updated as the community identifies fixes and workarounds.
| Use the UNIX line ending. This uses only “n” at the end of a line. |
Found files with invalid content or format. | The archive contains files with invalid format or content. | Confirm that the files follow the custom configset file requirements before archiving. |
Required file 'solrconfig.xml' is not found in the root of the archive. | The solrconfig.xml file is not found at the top-level directory. | The solrconfig.xml file must be present at the top of the archive directory. |
Unwanted files found. Please remove or rearrange. | Unnecessary files are present in the archive. | Remove the unused or unwanted files from the archive. |
Any error having prefix "Solr Error:". | This error message is generated at the Solr level after the basic validation is completed. | Test the configset on a local environment before uploading it to production. |
Configset file you are trying to upload, already exists. | The configset is the same as an existing configset for your application. The new configset does not introduce any changes. | Use the existing configset with your desired settings or modify the configset and upload the updated file. |
File is too large. Maximum size allowed is 1MB. | File size is more than 1 MB. | Upload a file under 1 MB. |
Unknown Error | There is an unknown issue uploading the configset. | Create a Support ticket. |
The reported node is probably where the indexing problem resides.
If this content did not answer your questions, try searching or contacting our support team for further assistance.
| Use the UNIX line ending. This uses only “n” at the end of a line. |
Found files with invalid content or format. | The archive contains files with invalid format or content. | Confirm that the files follow the custom configset file requirements before archiving. |
Required file 'solrconfig.xml' is not found in the root of the archive. | The solrconfig.xml file is not found at the top-level directory. | The solrconfig.xml file must be present at the top of the archive directory. |
Unwanted files found. Please remove or rearrange. | Unnecessary files are present in the archive. | Remove the unused or unwanted files from the archive. |
Any error having prefix "Solr Error:". | This error message is generated at the Solr level after the basic validation is completed. | Test the configset on a local environment before uploading it to production. |
Configset file you are trying to upload, already exists. | The configset is the same as an existing configset for your application. The new configset does not introduce any changes. | Use the existing configset with your desired settings or modify the configset and upload the updated file. |
File is too large. Maximum size allowed is 1MB. | File size is more than 1 MB. | Upload a file under 1 MB. |
Unknown Error | There is an unknown issue uploading the configset. | Create a Support ticket. |
The reported node is probably where the indexing problem resides.
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Cloud Platform