Fusion Connectors

Active Directory Connector for ACLs V2

Alfresco

AWS S3 V1

Azure

Box.com V1

Confluence

Couchbase V2

Dropbox

Drupal 7.x

Drupal 8/9

File Upload File Upload

FTP

GitHub

Google Drive V1

HDFS

Javascript

JDBC V1

JIRA

Jive

Local Filesystem (V2) Local Filesystem V2

Local Filesystem (V1) Local Filesystem V1

MongoDB

OneDrive Datasource

Salesforce

ServiceNow

SharePoint V1

SharePoint Online V1

SharePoint V2

Sitecore

Solr Push Endpoint

Solr

Subversion

Twitter Search

Twitter Stream

Web V1

Windows Share SMB 2/3 V1

Zendesk

You can view and download all current and previous V2 connector releases at Download Connectors.

In Fusion 5.1, connectors are installed using the Connector Plugins Repository API, which accesses Fusion’s built-in repository of plugins.

How to install a connector in Fusion 5.1

List the connectors in Fusion’s repository:

curl -u USERNAME:PASSWORD http://fusion-cluster:6764/connectors/repository

In the output, find the ID of the connector you want to install:

[ {
  "id" : "lucidworks.fs",
  "version" : "2.1.0",
  "sdkVersion" : "2.0.0",
  "location" : "com/lucidworks/connector/plugins/lucidworks.connector.fs/2.1.0/lucidworks.connector.fs-2.1.0.zip"
},
{
  "id" : "lucid.twitter-search",
  "version" : "5.2.0",
  "sdkVersion" : "5.2.0",
  "location" : "com/lucidworks/connector/plugins/lucid.twitter-search/5.2.0/lucid.twitter-search-5.2.0.zip"
},
{
  ...
} ]

In this example, we will install the Local Filesystem V2 Connector, whose ID is lucidworks.fs.

Send the connector ID to the API:

curl -u USERNAME:PASSWORD -X POST "http://fusion-cluster:6764/connectors/plugins?id=lucidworks.fs"
{
  "pluginId" : "lucidworks.fs",
  "status" : {
    "action" : "INSTALL",
    "status" : "SUCCESS",
    "message" : "Plugin lucidworks.fs was installed successfully."
  }
}

After you install a connector, you can Configure A New Datasource.

You can view and download all current and previous V2 connector releases at plugins.lucidworks.com.

Installing a connector using the Connector API

Download the connector zip file.

Do not expand the archive; Fusion consumes it as-is.

Upload the connector zip file to Fusion’s plugins. Specify a pluginId as in this example:

curl -H 'content-type:application/zip' -u USERNAME:PASSWORD -X PUT 'https://FUSION_HOST:FUSION_PORT/api/connectors/plugins?id=lucidworks.{pluginId}' --data-binary @{plugin_path}.zip

Fusion automatically publishes the event to the cluster, and the listeners perform the connector installation process on each node.

If the pluginId is identical to an existing one, the old connector will be uninstalled and the new connector will be installed in its place. To get the list of existing plugin IDs, run: curl -u USERNAME:PASSWORD https://FUSION_HOST:FUSION_PORT/api/connectors/plugins

Look in https://FUSION_HOST:FUSION_PORT/apps/connectors/plugins/ to verify the new connector is installed.

Reinstall a connector

To reinstall a connector for any reason, first delete the connector then use the preceding steps to install it again. This may take a few minutes to complete depending on how quickly the pods are deleted and recreated.

In your Fusion app, navigate to Indexing > Datasources.
Click Add.
Select your connector.

The connector configuration panel appears. The specific configuration options vary depending on the connector.

If you do not see your connector in the list, you may need to install it.

Configure your connector’s options:
1. Enter a useful name for your datasource in the Datasource ID field.
2. You can leave the Pipeline ID and Parser fields as-is to start with the defaults, or select different ones if you have them.
3. Configure the connector-specific options.
  
  Select your specific release and connector detail from the configuration reference topic.
Click Save.
Test your datasource configuration:
1. Navigate to the Index Workbench at Indexing > Index Workbench.
2. Click Load….
3. Select the datasource ID you specified when you created the datasource.
  
  Now you can see your datasource configuration and a simulation of the results you can expect when you run this datasource job to index your data.
4. Adjust the configurations of your datasource, parsers, and index pipeline until the simulated results are satisfactory.
5. Click Save.
Index your data:
1. In the Index Workbench, click Start Job.
2. When the job status is Finished, navigate to the Query Workbench at Querying > Query Workbench to view the indexed documents and configure your query pipeline.

See Connectors SDK for more information.