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:16160

Configure Connector

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

ServiceNow Configuration

In order to get up and running with the ServiceNow integration, you will need to configure the following*:

A ServiceNow instance
A ServiceNow user account
Tables with records to crawl

More options and details to each of these steps can be found in the User Guide/Configuration/Connector section of the documentation.

ServiceNow Instance

In order to connect to your ServiceNow instance, you need to specify its URL by setting the raytion.connector.agent.servicenow.restapi.serviceUrl property.

ServiceNow Quickstart Instance Configuration

ServiceNow User Account

To authenticate with your ServiceNow instance, you need to specify a user account by setting the raytion.connector.agent.servicenow.restapi.username and raytion.connector.agent.servicenow.restapi.password properties.

ServiceNow Quickstart User Configuration

Tables with Records to Crawl

In order to crawl records from your ServiceNow instance, you can either explicitly specify the tables to crawl or use the sys_db_object table to look up all tables matching configurable filters.

ServiceNow Quickstart Table Configuration With Lookup Enabled

ServiceNow Quickstart Table Configuration With Lookup Disabled

To include or exclude specific records, additional metadata filters are also available.

ServiceNow Quickstart Record Metadata Filters Configuration

Google Cloud Search Configuration

Google Cloud Search Service Account

Configure the mail address of a technical user to check the existence of principals before feeding them. This is not the mail address from the service account described in the following.

Configure your Service Account which is used by the connector for authenticating and authorizing the requests send to Google Cloud Search API. A new service account can be created as part of step Google Cloud Search Quick Start - Create Service Account. The connector requires the created service account JSON file, which can be uploaded directly in the Admin UI of the connector.

Google Cloud Search Identity Source

Configure the ID of the identity source created as part of step Google Cloud Search Quick Start - Create Identity Source.

Google Cloud Search Data Source

Configure the ID of the datasource created as part of step Google Cloud Search Quick Start - Create Data Source.

If you followed the step Google Cloud Search Quick Start - Create Data Source Schema, this is the default value assigned as object type to a document to specify the object type from a schema. It is applied when no meta date objectType is present at a document. The value has to be set to the object name of the schema set for your Data Source. The value can be retrieved from schema.objectDefinitions.name inside your schema Json file or payload.*

Upload License

Contact Raytion and obtain a license for your connector
Login to the Admin UI
Select License in the menu:

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: