In addition to Drupal nodes, Acquia Search results presented to your users can include files that contain matches to the search query. File formats that can be indexed include HTML, XML, Microsoft Office documents, OpenDocument, PDF, RTF, .zip, and other compression formats, text formats, audio formats, video formats, and more. For a complete list of supported document formats, see the Apache Tika documentation.
Search results for attached files display a direct link to the attached file and the node to which it is attached:
Searching file attachments requires the Apache Solr Attachments module. The Apache Solr Attachments module uses the Apache Tika Content Analysis Toolkit to detect and extract meta data and structured text content from a wide variety of file formats. After extraction, this information is indexed and available to your users with Acquia Search.
Note
Ensure that the most recent versions of your modules are in use. If you use older versions, you may experience problems with extracting attachments.
Installing the Apache Solr Attachments module
To index attachments:
Install and enable the Apache Solr Attachments 7.x-1.x-dev module on your website. You must use this version since this is currently compatible with the Acquia Search Platform and other versions are incompatible.
Go to the Apache Solr search > Configuration > Default Index page.
In the Configuration section, select the File checkbox as an entity to be indexed.
Click Save.
The Apache Solr Search configuration page now displays the Attachments tab. Use the settings on this tab to configure the file attachment indexing settings.
Note
The Apache Solr Attachments module is compatible only with Apache Solr Search. If you are using the Search API module, you can use the Search API attachments module instead. Configure it to work with Acquia Search. Be sure to use version 7.x-1.4 or later; earlier versions of the Search API attachments module are not compatible with Acquia Search.
Configuring file attachment index settings
The Attachments tab of the Apache Solr Search configuration page contains the following configuration options for indexing attachments in Apache Solr Search:
S. No.
Item
Description
1
Excluded file extensions
A space-separated list of file extensions that are excluded from indexing. Modify this list to suit the needs of your site. Extensions are internally mapped to a MIME type, so it is not necessary to include variations that map to the same type. For example, tif is sufficient to exclude both the tif and tiff file extensions.
2
Extract using
Acquia Search includes Apache Tika for indexing documents. For best performance, select Solr (remote server).
3
File Size Limit
If a file is larger than this limit, do not index it. Default is 41943040 bytes (40MB).
4
Tika directory
Leave this blank.
5
Tika jar file
Leave this set to the default value.
6
Tika extracting servlet path
update/extract
7
Tika extracting servlet parameters
extractOnly=true
Index and cache controls
File attachments get indexed at the same time as their parent entities. Under Actions, you can:
Action
Description
Clear the attachment text extraction cache
Clears all extracted data.
Delete the attachments from index
Deletes all the attached files on your site from the Acquia Search index. You need to do this if you change what types of files should be indexed, if your search index becomes corrupted, or if you install a new schema.xml.
Test your tika extraction
Tests if your Tika configuration settings work.
Indexing attachments with Apache Solr Search module
In addition to Drupal nodes, Acquia Search results presented to your users can include files that contain matches to the search query. File formats that can be indexed include HTML, XML, Microsoft Office documents, OpenDocument, PDF, RTF, .zip, and other compression formats, text formats, audio formats, video formats, and more. For a complete list of supported document formats, see the Apache Tika documentation.
Search results for attached files display a direct link to the attached file and the node to which it is attached:
Searching file attachments requires the Apache Solr Attachments module. The Apache Solr Attachments module uses the Apache Tika Content Analysis Toolkit to detect and extract meta data and structured text content from a wide variety of file formats. After extraction, this information is indexed and available to your users with Acquia Search.
Note
Ensure that the most recent versions of your modules are in use. If you use older versions, you may experience problems with extracting attachments.
Installing the Apache Solr Attachments module
To index attachments:
Install and enable the Apache Solr Attachments 7.x-1.x-dev module on your website. You must use this version since this is currently compatible with the Acquia Search Platform and other versions are incompatible.
Go to the Apache Solr search > Configuration > Default Index page.
In the Configuration section, select the File checkbox as an entity to be indexed.
Click Save.
The Apache Solr Search configuration page now displays the Attachments tab. Use the settings on this tab to configure the file attachment indexing settings.
Note
The Apache Solr Attachments module is compatible only with Apache Solr Search. If you are using the Search API module, you can use the Search API attachments module instead. Configure it to work with Acquia Search. Be sure to use version 7.x-1.4 or later; earlier versions of the Search API attachments module are not compatible with Acquia Search.
Configuring file attachment index settings
The Attachments tab of the Apache Solr Search configuration page contains the following configuration options for indexing attachments in Apache Solr Search:
S. No.
Item
Description
1
Excluded file extensions
A space-separated list of file extensions that are excluded from indexing. Modify this list to suit the needs of your site. Extensions are internally mapped to a MIME type, so it is not necessary to include variations that map to the same type. For example, tif is sufficient to exclude both the tif and tiff file extensions.
2
Extract using
Acquia Search includes Apache Tika for indexing documents. For best performance, select Solr (remote server).
3
File Size Limit
If a file is larger than this limit, do not index it. Default is 41943040 bytes (40MB).
4
Tika directory
Leave this blank.
5
Tika jar file
Leave this set to the default value.
6
Tika extracting servlet path
update/extract
7
Tika extracting servlet parameters
extractOnly=true
Index and cache controls
File attachments get indexed at the same time as their parent entities. Under Actions, you can:
Action
Description
Clear the attachment text extraction cache
Clears all extracted data.
Delete the attachments from index
Deletes all the attached files on your site from the Acquia Search index. You need to do this if you change what types of files should be indexed, if your search index becomes corrupted, or if you install a new schema.xml.
Test your tika extraction
Tests if your Tika configuration settings work.
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Cloud Platform