How to Configure Your Elasticsearch Target with User Authentication

• Compatibility with Elasticsearch

• Add the Target

  • Target Definition and Requirements

  • Add Your Elasticsearch Integration Target

  • How to Group All Non-refinable/Non-searchable Properties

• How to Run a Full Target Update Job

 

Compatibility with Elasticsearch

If using Elasticsearch v7.x and SmartHub, you must use SmartHub v5.5 or later.

Add the Target

Target Definition and Requirements

Before you can add your Target, you must install BA Insight Connectivity Hub.

• A Target is a set of configuration options used by your Content Source (that identify which search engine content is written to).
  • Multiple Content Sources can point to the same Target
• Add at least 1 Target per search engine
  • If you use the same crawl options across Content Sources, you use 1 Target per search engine
  • If you use various crawl options across Content Sources, you must use multiple Targets per search engine
• If you use Elasticsearch, your Target points to the entire elastic cluster
• 1 Content Source = 1 index in your search engine (Elastic, MS Search, etc.)
  • You can not map 2 Content Sources to the same index
• Connectivity Hub automatically names the indices based on the Content Source names

Add Your Elasticsearch Integration Target

To add the Elasticsearch Integration target, follow these steps:

1. Go to the Connectivity Hub Target page.
   
2. Select New > Target.
   
3. The Load Target page appears.
   
4. Select the generic Elastic Target.
   
   
   
5. Select the Target Info tab.
   Enter the following information:
   1. Title
      1. Required
      2. Specify a name.
   2. Target Information
      1. Required
      2. Auto-populates
      3. Enter BAInsight.ElasticSearch.ConnectorsExtension.ElasticTarget.
         

         
         

6. Select the Custom Settings tab.
   
   

1. Elastic index URL (required): Enter your URL in the format:
    http(s)://[server_name]:[port_number]
   

   1. Connectivity Hub attempts to connect to the index in this address [index_name].

      1. If the index does not exist, Connectivity Hub creates it.

   2. The Elastic schema is created automatically.
   3. To define the fields you want to see in your index use the Metadata page and set the Active, Refinable, Searchable, and Exact match settings for your metadata.

   4. The fields are automatically created in your index, based on these settings.

      1. If you need to query against the specific property, mark it as Active and Searchable
      2. If you need to use the property as a refiner mark it as Active and Refinable
      3. If you only care about the value of the property and only need to query against the content of the property, then mark Active and Full text index
         
         
         

   5. Click Save.

   6. Click Connect.

How to Group All Non-refinable/Non-searchable Properties

You can group all non-refinable/non-searchable properties from Connectivity Hub in a bulk property in Elastic by setting the Active and Full text index property on your metadata:

After indexing, all values are found under the ElasticBulkValues property.

How to Run a Full Target Update Job

After you add a target, you must run a Full Target Update job.

To update the target after you have run a Full Target Update job, run a Incremental Target Update job.

To run a Full Target Update job, follow these steps:

1. Go to the Connectivity Hub Tasks page.
   
   
   
2. Click New and the Edit Job page appears.
   
   
   
3. In the Scope drop-down field, select the Content Source for which to run the full target update.
   
   
   
4. Select Target Full Update from the Job drop-down list.
   
   
   

5. Click Create.
   

6. Logs - See these logs after you run a job such as:

   1. Full

   2. Incremental

   3. Target Update