FAQHow does the configuration differ from synchronous Tika parsing?
- In Fusion 5.9.10 and earlier, asynchronous parsing does not use a Fusion parser stage. Instead, the configuration is made in the datasource and index pipeline.
- In Fusion 5.9.11 and later, asynchronous parsing uses the Apache Tika Container parser stage in addition to configuration in the datasource and index pipeline. The parser ID set in the connector datasource configuration is used, allowing you to use any parser stage configuration except deprecated Tika stages.
- Cron expression: The cron expression that controls when the task is be executed.
- Number of datasources: The number of datasources to select per task.
- Number of documents: The number of documents to select per datasource per task.
- Task execution timeout: The maximum amount of time that a task is allowed to run before it is terminated.
Important
- In Fusion 5.9.10 and earlier, your parser configuration is ignored when using asynchronous parsing.
The asynchronous parsing service performs Tika parsing using Apache Tika Server. Other parsers, such as HTML and JSON, are not supported by the asynchronous parsing service.
Although your datasource is linked to a parser configuration, this link is ignored when asynchronous parsing is used. - In Fusion 5.9.11 and later, your parser configuration is used when using asynchronous parsing.
Asynchronous parsing service performs Tika parsing using Apache Tika Container. Other parsers, such as HTML and JSON, are now supported by the asynchronous parsing service.
Your datasource is linked to a parser configuration. This link is used when asynchronous parsing is used.
Requirements
Asynchronous parsing works for V2 connectors only, which use the Java SDK framework. It is enabled in the datasource configuration by toggling the Advanced view and turning on the Async Parsing option. Learn more about V1 and V2 connectors. Additionally, the index pipeline must include a Solr Partial Update Indexer stage. This stage replaces the Solr indexer stage, which should be removed or turned off. This is required because the connector plugin and the asynchronous parsing services generate one document each, one from the fetching process and another from the parsing process, respectively. Both documents need to be merged into a single document. The Solr Partial Update Indexer merges both documents, while the Solr indexer stage overrides documents. For more information on asynchronous parsing setup, see Use Tika Asynchronous Parsing.Use Tika Asynchronous Parsing
Use Tika Asynchronous Parsing
This document describes how to set up your application to use Tika asynchronous parsing.Unlike synchronous Tika parsing, which uses a parser stage, asynchronous Tika parsing is configured in the datasource and index pipeline. For more information, see Asynchronous Tika Parsing.
Field names change with asynchronous Tika parsing.In contrast to synchronous parsing, asynchronous Tika parsing prepends
parser_ to fields added to a document. System fields, which start with \_lw_, are not prepended with parser_. If you are migrating to asynchronous Tika parsing, and your search application configuration relies on specific field names, update your search application to use the new fields.Configure the connectors datasource
- Navigate to your datasource.
- Enable the Advanced view.
-
Enable the Async Parsing option.
Fusion 5.9.11 and later uses your parser configuration when using asynchronous parsing.The asynchronous parsing service performs Tika parsing using Apache Tika Server. In Fusion 5.8 through 5.9.10, other parsers, such as HTML and JSON, are not supported by the asynchronous parsing service. By enabling asynchronous parsing, the parser configuration linked to your datasource is ignored. In Fusion 5.9.11 and later, other parsers, such as HTML and JSON, are supported by the asynchronous parsing service. By enabling asynchronous parsing, the parser configuration linked to your datasource is used. - Save the datasource configuration.
Configure the parser stage
You must do this step in Fusion 5.9.11 and later.
- Navigate to Parsers.
- Select the parser, or create a new parser.
- From the Add a parser stage menu, select Apache Tika Container Parser.
- (Optional) Enter a label for this stage. This label changes the names from Apache Tika Container Parser to the value you enter in this field.
- If the Apache Tika Container Parser stage is not already the first stage, drag and drop the stage to the top of the stage list so it is the first stage that runs.
Configure the index pipeline
- Go to the Index Pipeline screen.
- Add the Solr Partial Update Indexer stage.
-
Turn off the Reject Update if Solr Document is not Present option and turn on the Process All Pipeline Doc Fields option:
-
Include an extra update field in the stage configuration using any update type and field name. In this example, an incremental field
docs_counter_iwith an increment value of1is added:
-
Enable the Allow reserved fields option:
- Click Save.
-
Turn off or remove the Solr Indexer stage, and move the Solr Partial Update Indexer stage to be the last stage in the pipeline.
Additional resources
LucidAcademyLucidworks offers free training to help you get started.The Course for Asynchronous Parsing Service focuses on how to use asynchronous parsing to index your data more efficiently:
