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

Configure Connector

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

Happeo Configuration

Happeo API Key

Configure the API Key you created as part of step Happeo Guide Quick Start - Create System Account and API Key.

Google Cloud Search Configuration

Google Cloud Search Service Account

Configure the Customer ID and of your Google Workspace or Cloud Identity Domain. The Customer ID can be found at Admin Console under Account → Account Settings → Profile → Domain Settings → Customer ID.

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. You can omit the option Data Source Schema Object Type if there is no scheme associated with the Data Source. If you followed the step Google Cloud Search Quick Start - Create Data Source Schema, 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:

Synchronizing Data

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

Content Traversal

Ramp Up will process all items to Google Cloud Search.
Incremental will process only changed items since last traversal run.
Automated Change Processing can be enabled to automatically process certain live updates from Happeo to Google Cloud Search.

dashboard content with change processing

Schedule Traversal

Scheduled traversals can also be configured through the menu.

From this button a Schedule can be configured.

From upper right corner you can choose the traversal type and then click on NEW SCHEDULED TRAVERSAL.

Configure the frequency that the Traversal will be executed and click Save.