Step 1. Launch Aspire and Open the Content Source Management Page

Launch Aspire (if it's not already running). See:

• Launch Control

• Browse to: http://localhost:50505 and then open the Workflows Page. For details on using the Aspire UI please refer to this page Aspire UI.

Step 2. Add or select a Workflow

• Add a new workflow or open an existing workflow.
• For this step please refer to the Workflow Introduction.

Step 3. Add the Elasticsearch Publisher to the Workflow

• Select the event for which you want to add the Elasticsearch Publisher to, from the Event combo.
• To add a Elasticsearch Publisher drag the Elasticsearch Publisher from the Rules Section on the right side of the screen and drop it below the Workflow Event to the left side of the screen. This will automatically open the Elasticsearch Publisher window for the configuration of the publisher.

Step 3a. Specify a description for the Publisher

 In top section of the ElasticSearch Publisher configuration window, specify the description for the publisher.

Step 3b. Specify Server Configuration

 In the Server section of the ElasticSearch Publisher configuration, specify the information related to the server.

1. ElasticSearch URL: Select how you want to enter the ElasticSearch URL
   1. Host and port
      • ElasticSearch Host: Enter the ElasticSearch host.
      • ElasticSearch Port: Enter the ElasticSearch port (9200 by default)
   2. Complete Url
      • ElasticSearch URL: Enter the url for the ElasticSearch bulk index endpoint, it must have this format <protocol>://<host>:<port>/_bulk
2. ElasticSearch Index: Enter the index to which the jobs are going to be publish.

Step 3c. Specify Authentication Configuration

 In the Authentication section of the ElasticSearch Publisher configuration, specify the authentication information.

1. None: The server requires no authentication
2. Basic: provide credentials for basic authentication
   
   1. User: Provide the user for basic authentication.
   2. Password: Provide the password for basic authentication.
3. Amazon Web Service (AWS): provide the configuration to authenticate using AWS
   
   1. Region: Specify the AWS region to use.
      
   2. Use credentials provider chain: enable to specify a credentials provider chain
      1. Access key: provide the access key for authentication with AWS.
      2. Secret key: provide the secret key for authentication with AWS.

Step 3d. Specify Transform Documents

 In the Transform Documents section of the ElasticSearch Publisher configuration, specify the groovy transformation file path.

1. Groovy Transform: the default value is set to "${component.home}/config/groovy/transform.groovy" for the default JSON transformation file provided with Aspire. To use a custom file, follow the instructions in JSON Transformation.

Step 3e. Specify Pre/Post Processing Options

 In the Pre/Post Processing section of the ElasticSearch Publisher configuration, specify the Pre/Post Processing configuration options.

1. Clear index on full crawl:

2. Max Results per request: How many documents can be fetched by the search engine for the same query

3. Page size: How many documents to fetch per page
4. Id field: Field used to store the id in elasticsearch. Used to compare against the content source audit logs
5. Url field: Field used to store the url in elasticsearch
6. Timestamp field: the name of the timestamp field holding the index timestamp of every document
7. Authentication: Indicates the authentication credentials for the ElasticSearch url, if you are using protocol https, then you must provide authentication credentials
   
   1. None: use this setting if you do not need to provide credentials
   2. Basic: use this setting if your ElasticSearch url requires authorization credentials.
   • Username: enter the username required to access the ElasticSearch url.
   • Password: enter the password required to access the ElasticSearch url.
8. Debug: Check if you want to run the publisher in debug mode.
   Note: The Delete by Query feature does not work on Elasticsearch 5.x onward
9. Click on the Add button.