Connector Quick Start

Start Connector

Unpack the distribution and run the start script located in the installation bin directory.

LINUX

./connector

WINDOWS

./connector.bat

Login to Connector

Once the Connector has started, navigate to the Admin UI and login with the default username and password, admin/admin:

http://your-host:16450

Configure Connector

Follow the description and instruction in the Basic Configuration Menu to configure the mandatory settings.

Microsoft SharePoint Online Configuration

In order to traverse Microsoft SharePoint Online, the following properties need to be configured via the connector UI:

  • The application ID of the Azure app created via the Azure Portal

  • The tenant ID to which the application belongs

  • The certificate which was configured for the Azure application

  • The password of the certificate

Custom Security Manager Configuration

Configure URL of the CSM instance to connect to.
csm endpoint
Configuration options required for the connector to authenticate to the CSM.
csm credentials
Configuration namespace under which to ingest principals.
csm namespace

Amazon Kendra Configuration

Configure the ID and region of the index created at step Amazon Kendra Quick Start - Create Index. Specify the Role ARN assigned to the Index. All the parameters can be retrieved from the Index settings in AWS console.
Index Settings
Configure the ID of the data source created at step Amazon Kendra Quick Start - Create Data Source.
Data Source ID
Configure the Access Keys for the technical account which should write to the index. The specified account requires the Managed Policy AmazonKendraFullAccess
AWS Account Credentials

The Access Keys can be also configured via system properties. The keys can be identified from one of following locations:

  • Java System Properties aws.accessKeyId and aws.secretAccessKey

  • Environment Variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY

  • Web Identity Token credentials from System or Environment Variables

  • Credentials Profile File at location ~/.aws/credentials

  • Credentials delivered through the Amazon EC2 container

  • Instance profile credentials delivered through the Amazon EC2 metadata service

AWS Account System Credentials

Upload License

  • Contact Raytion and obtain a license for your connector

  • Login to the Admin UI

  • Select License in the menu:

uploadlicense 1

  • Upload the license file by browsing for the file or simply dragging a dropping the license onto the license page

  • The Status of the license will be displayed as valid, and the expiration and item quota will also be displayed:

uploadlicense 2

Synchronizing Data

Once the connector is configured and the license uploaded, you can start synchronizing data using the traversal feature in the dashboard.

dashboard start traversal without cp

There are 3 options for Synchronizing:

  • Force Refeed Toggles if previously discovered traversal items that haven’t changed should be fed to the search engine.

  • Process Deletes Toggles if deletions should be fed to the search engine.

  • Run Next The traversal will be prioritized over other traversals without this flag in the queue.

Content Traversal

  • Full

dashboard content traversal without partial

Principal Traversal

dashboard principal traversal

Schedule Traversal

Scheduled traversals can also be configured through the menu.

From this button a Schedule can be configured.
schedule button
Click on NEW SCHEDULED TRAVERSAL.
scheduling
Configure the Traversal that will be executed and click Save.
schedule configuration