Connectors are the conduit between Fusion and your external data sources. Connectors retrieve your data and import it into Fusion. To ensure compatibility between the connector and your Fusion version, please refer to the Fusion compatibility declaration located at the beginning of each connector configuration reference article. For example: Fusion Connector compatibility details
  • Latest version. This is the latest version of the connector. To check the connector version you’re using, navigate to System > Blobs, open the Connector Plugin directory, and select the connector. The version value is declared in the connectorVersion field.
  • Compatible with Fusion version. This provides the versions of Fusion that are compatible with the latest version of the connector.
Any additional information about compatibility is included in the body of the connector configuration reference article.

Installation instructions

Fusion includes all available connectors in Indexing > Datasources. Some connectors come pre-installed, but you must install others manually. See the following resources for your version of Fusion:
When you create a new datasource that requires an uninstalled connector, Fusion releases 5.2 and later automatically download and install the connector using the Datasources dropdown. You can also update the connector using the Blob Store UI or via the Connector API.

Install a connector using the Datasources dropdown

  1. In your Fusion app, navigate to Indexing > Datasources.
  2. Click Add.
  3. In the list of connectors, scroll down to the connectors marked Not Installed and select the one you want to install.
    Fusion automatically downloads it and moves it to the list of installed connectors.
After you install a connector, you can Configure a New Datasource.
You can view and download all current and previous V2 connector releases at Download Connectors.

Install or update a connector using the Blob Store UI

  1. Download the connector zip file from Download V2 connectors.
    Do not expand the archive; Fusion consumes it as-is.
  2. In your Fusion app, navigate to System > Blobs.
  3. Click Add.
  4. Select Connector Plugin. Add a connector The “New Connector Plugin Upload” panel appears.
  5. Click Choose File and select the downloaded zip file from your file system. Upload a connector
  6. Click Upload. The new connector’s blob manifest appears. Uploaded connector From this screen you can also delete or replace the connector.
Wait several minutes for the connector to finish uploading to the blob store before installing the connector using the Datasources dropdown.

Install or update a connector using the Connector API

  1. Download the connector zip file from Download V2 connectors.
    Do not expand the archive; Fusion consumes it as-is.
  2. 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
  3. 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 Fusion 4.x, connectors are installed by uploading them to the blob store. You can use any of these methods to install a connector:
  • By installing connectors as “bootstrap plugins”, that is, by putting them in the bootstrap-plugins directory during initial installation or an upgrade
  • By using the Blob Store UI after installation or an upgrade
  • By using the Blob Store API after installation or an upgrade.
During upgrades, the migrator handles some aspects of installing connectors. Depending on the target version and the presence or absence of an Internet connection, there might be manual steps. Installing connectors during upgrades is explained where needed in the upgrade procedures.
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.

Install a connector as a bootstrap plugin

Fusion can install connectors as “bootstrap plugins.” All this means is that you put the connector zip files in a specific directory named bootstrap-plugins, and Fusion installs the connectors the first time it starts during initial installation or an upgrade.
  1. Download the connector zip file from Fusion 4.x Connector Downloads.
    Do not expand the archive; Fusion consumes it as-is. Also, do not start Fusion until instructed to do so by the installation or upgrade instructions.
  2. Under the version-numbered Fusion directory, place the connector in the directory apps/connectors/bootstrap-plugins/ (on Unix) or \apps\connectors\bootstrap-plugins\ (on Windows).
  3. Start Fusion when instructed to do so in the installation or upgrade procedure.

Install or update a connector using the Blob Store UI

  1. Download the connector zip file from Fusion 4.x Connector Downloads.
    Do not expand the archive; Fusion consumes it as-is.
  2. In the Fusion workspace, navigate to System > Blobs.
  3. Click Add.
  4. Select Connector Plugin. Add a connector The “New Connector Plugin Upload” panel appears.
  5. Click Choose File and select the downloaded zip file from your file system. Upload a connector
  6. Click Upload.
    The new connector’s blob manifest appears.
    Uploaded connector From this screen you can also delete or replace the connector.

Install or update a connector using the Blob Store API

  1. Download the connector zip file from Fusion 4.x Connector Downloads.
    Do not expand the archive; Fusion consumes it as-is.
  2. Upload the connector zip file to Fusion’s blob store.
    Specify an arbitrary blob ID, and a resourceType value of plugin:connector, as in this example:
    curl -H 'content-type:application/zip' -X PUT 'localhost:8764/api/blobs/myplugin?resourceType=plugin:connector' --data-binary @myplugin.zip
    
    Fusion automatically publishes the event to the cluster, and the listeners perform the connector installation process on each node.
    If the blob ID is identical to an existing one, the old connector will be uninstalled and the new connector will installed in its place. To get the list of existing blob IDs, run: curl -u USERNAME:PASSWORD localhost:8764/api/blobs
  3. 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.
ImportantCheck the connector reference page linked in the table for Fusion compatibility information.
Database connectors
NameDescriptionSource CompatibilityPlatform VersionSecurity Trimming
Couchbase V2The Couchbase V2 connector uses the Couchbase Java client to retrieve data stored in Couchbase.Couchbase Server 6.0.3 Enterprise Edition (V2)V2No
Couchbase V1The Couchbase V1 connector uses the Cross-Datacenter Replication (XDCR) feature of Couchbase to retrieve data stored in Couchbase continuously in real-time.Couchbase Server 2.5.1 Enterprise Edition (V1) - Due to a dependency issue, the Couchbase V1 connector does not work as expected in Fusion 4.2.x.V1No
JDBC V1The JDBC connector fetches documents from a relational database via SQL queries. Under the hood, this connector implements the Solr DataImportHandler (DIH) plugin.Any JDBC compliant DatabaseV1No
JDBC V2 connectorThe JDBC connector fetches documents from a relational database via SQL queries. Under the hood, this connector implements the Solr DataImportHandler (DIH) plugin.Any JDBC V2 compliant DatabaseV2No
MongoDBRetrieve data from a MongoDB instance.MongoDB 2.6, 3.0, 3.2, 3.4, 3.6, 4.0V1No
Filesystem connectors
NameDescriptionSource CompatibilityPlatform VersionSecurity Trimming
Box.com V1The Box connector retrieves data from a Box.com cloud-based data repository. To fetch content from multiple Box users, you must configure a Box.com datasource. For limited testing using a single user account, you can configure Box.com tokens.N/AV1Yes
Box.com V2The Box connector retrieves data from a Box.com cloud-based data repository. To fetch content from multiple Box users, you must configure a Box.com datasource. For limited testing using a single user account, you can configure Box.com tokens.N/AV2Yes
File UploadThe File Upload connector provides a convenient way to quickly ingest data from your local filesystem.N/AV1No
File Upload V2The File Upload V2 connector provides a convenient way to quickly ingest data from your local filesystem.N/AV2No
FTPRetrieve documents using the File Transfer Protocol (FTP).N/AV1No
Google CloudThe Fusion Google Cloud Storage (GCS) V2 connector enables indexing datasets from GCS buckets into Fusion 5. The connector leverages the Google Cloud API for authentication and fetching content and metadata.AllV2Yes
Google Drive V1The Google Drive connector is used to index the documents in a Google Drive account.Google V3 APIV1Yes
HDFSHadoop Distributed File System (HDFS). It traverses the Hadoop file system as it would a regular Unix filesystem.2.7.1V1No
Local Filesystem V2This connector traverses a network file system (NFS), where a shared drive is mounted to the same location on all hosts in the cluster that are running this connector.AllV2No
Local Filesystem V1This connector traverses a network file system (NFS), where a shared drive is mounted to the same location on all hosts in the cluster that are running this connector.AllV1No
OneDriveOneDrive is a file hosting service that is part of the Microsoft Office Online services. The Fusion OneDrive connector crawls a OneDrive for Business instance and retrieves data from it for indexing within Fusion.AllV2Yes
AWS S3 V1The AWS S3 V1 Connector can access AWS S3 buckets in native format.AllV1No
AWS S3 V2The AWS S3 V2 connector crawls items in a single bucket. You must specify the bucket name and AWS region in which that bucket is located. You may crawl specific items in a bucket. If no items are specified, the entire bucket will be crawled.AllV2No
SolrXMLThe SolrXML connector indexes XML files formatted according to Solr’s XML structure. It is not a generic XML file crawler; it can only index SolrXML-formatted documents.AllV1No
Windows Share (deprecated)The Windows Share connector can access content in a Windows Share or Server Message Block (SMB)/Common Internet File System (CIFS) filesystem.SMB 1 protocolV1Yes
Windows Share SMB2/3 V1 (classic)The Windows Share connector can access content in a Windows Share or Server Message Block (SMB 2 and 3 protocols)/Common Internet File System (CIFS) filesystem. Available in Fusion 5.x.x releases.SMB 2, 3 protocolsV1Yes
Windows Share SMB2/3 V2The Windows Share connector can access content in a Windows Share or Server Message Block (SMB 2 and 3 protocols)/Common Internet File System (CIFS) filesystem.SMB 2, 3 protocolsV2Yes
Hadoop cluster connectors
NameDescriptionSource CompatibilityPlatform VersionSecurity Trimming
Apache Hadoop 2The Apache Hadoop 2 Connector is a MapReduce-enabled crawler that is compatible with Apache Hadoop v2.x.2.xV1No
HortonworksThe Hortonworks Connector is a MapReduce-enabled crawler that is compatible with Hortonworks Data Platform v2.x.2.xV1No
MapRThe MapR Connector is a MapReduce-enabled crawler that is compatible with MapR 4.x and 5.x.4.x, 5.xV1No
ClouderaThe Cloudera Connector is a MapReduce-enabled crawler that is compatible with Cloudera CDH v4.x and v5.x.4.x, 5.xV1No
Push content connectors
NameDescriptionSource CompatibilityPlatform VersionSecurity Trimming
Solr Push EndpointThe Solr Push Endpoint accepts documents and pushes them to Solr using the Fusion index pipelines. You might use this, for example, if you are indexing Solr XML documents from a content management system that natively integrates with Solr, for example using SolrJ.AllV1No
Repository connectors
NameDescriptionSource CompatibilityPlatform VersionSecurity Trimming
Active Directory Connector for ACLs V2The Active Directory Connector for ACLs V2 plugin:
● Is a special connector that supports other data sources with collecting Access Control List (ACL) data
● Indexes ACL information into a configured “sidecar” Solr collection, for use by other connectors
● Connects to LDAP, AD, and Azure AD instances to add objects directly to a special collection for use in security trimming queries
● Extends the Azure AD model from V1 to return a delta link at the end of a crawl, allowing incremental delta searches for groups and users
N/AV2Yes
Active Directory Connector for ACLs V1The Active Directory Connector for ACLs indexes Access Control List (ACL) information into a configured “sidecar” Solr collection, so that it can be used by other connectors.N/AV1Yes
AEM V2This connector retrieves data from an Adobe Experience Manager (AEM) repository. The AEM V2 connector is compatible with AEM version 6.5.AEM 6.5V2Yes
AlfrescoThe Alfresco Connector is a crawler for the Alfresco server, which adheres to the Content Management Interoperability Services (CMIS) standard.CMIS 1.1 compliant versionsV1Yes
AzureThe Azure connector is used to crawl an Azure instance. Its connector type is “lucid.azure” and its plugin type is “azure”.Blob and Table storageV1No
ConfluenceRetrieve data from the Atlassian Confluence Wiki CMS. You can configure this datasource to crawl pages, spaces, blog posts, comments, and attachments.Confluence Server 5.5 and later; Confluence CloudV1Yes
DrupalThe Drupal connector requires Drupal’s Services 7.x3.11 Module REST API. Refer to this page to install the necessary packages: www.drupal.org/node/783236Drupal 7.xV1No
GitHubThe GitHub connector retrieves data from GitHub repositories using the GitHub REST API.N/AV1No
JIRAThe JIRA connector retrieves data from an instance of Atlassian’s JIRA issue tracking system.6.x, 7.xV1Yes
LDAP ACLs V2The Active Directory Connector for ACLs indexes Access Control List (ACL) information so that it can be used by other connectors.N/AV2Yes (with SharePoint Optimized V2)
SalesforceUse the Salesforce REST API to extract data from a Salesforce repository via a Salesforce Connected App.N/AV1Yes
ServiceNowThe ServiceNow Datasource retrieves data from the ServiceNow repository.N/AV1Yes
SharePoint Optimized V2The SharePoint Optimized V2 connector indexes content and metadata from SharePoint Online and on-premises environments, making it searchable in Fusion. It supports fine-grained scoping and filtering, so teams can include only the content that matters. Security trimming ensures that users see only content they are authorized to access, which protects sensitive data and enforces compliance. This enables a secure, unified search experience across SharePoint and other enterprise systems.2013, 2016, 2019, OnlineV2Yes
SharePoint V2The SharePoint connector retrieves content and metadata from an on-premises SharePoint repository.2013, 2016, 2019, OnlineV2Yes
SharePoint V1 OptimizedThe SharePoint connector retrieves content and metadata from an on-premises SharePoint repository.2010, 2013, 2016, OnlineV1 OptimizedYes
SharePoint Online V1 OptimizedThe SharePoint Online V1 Optimized connector retrieves data from cloud-based SharePoint repositories. Authentication requires a SharePoint user who has permissions to access SharePoint via the SOAP API. This user must be registered with the SharePoint Online authentication server; it is not necessarily the same as the user in Active Directory or LDAP.N/AV1 OptimizedYes
SharePoint V1 (deprecated as of 5.2)The SharePoint connector retrieves content and metadata from an on-premises SharePoint repository.2010, 2013, 2016, OnlineV1Yes
SharePoint Online V1 (deprecated as of 5.2)The SharePoint Online V1 connector retrieves data from cloud-based SharePoint repositories. Authentication requires a SharePoint user who has permissions to access SharePoint via the SOAP API. This user must be registered with the SharePoint Online authentication server; it is not necessarily the same as the user in Active Directory or LDAP.N/AV1Yes
SitecoreThis connector provides full crawl and incremental crawl support for Sitecore versions 8.x and 9.x. It indexes document content and all metadata.8.x, 9.xV2No
Slack V2The Slack V2 connector allows you to index Slack channels and messages.N/AV2Yes
Solr IndexA Solr connector pulls documents from an external standalone Solr instance or SolrCloud cluster using Solr’s javabin response type and streaming response parser.AllV1No
Subversion (deprecated)This connector requires a Subversion client that is compatible with JavaHL.1.8 and belowV1No
ZendeskThe Zendesk connector uses the Zendesk REST API to retrieve tickets and their associated comments and attachments from a Zendesk repository.N/AV1Yes
Script connectors
NameDescriptionSource CompatibilityPlatform VersionSecurity Trimming
JavascriptThe Javascript connector allows users to write ad-hoc document retrieval routines to fetch content from filesystems and websites.AllV1No
Social media connectors
NameDescriptionSource CompatibilityPlatform VersionSecurity Trimming
JiveRetrieve content from a Jive instance.REST API +V3.12V1Yes
KalturaThe Kaltura V2 connector uses the Kaltura Java API client to retrieve data stored in Kaltura.AllV2Yes
Twitter SearchThe Twitter Search connector uses Twitter’s search API to query Twitter for tweets that match specific parameters. It allows querying for any keyword, location or other query terms.AllV1No
Twitter StreamThe Twitter Stream connector uses Twitter’s streaming API to continually index Twitter. The datasource can be configured to limit tweets or it can be run indefinitely, until Twitter cuts off your access or you stop the datasource. This connector only retrieves tweets created after the datasource has been started.AllV1No
Web connectors
NameDescriptionSource CompatibilityPlatform VersionSecurity Trimming
Web V1The Web V1 connector retrieves data from a Web site using HTTP and starting from a specified URL.All Fusion 4.x and 5.x releasesV1No
Web V2The Web V2 connector retrieves data from a Web site using HTTP and starting from a specified URL.Fusion release 5.6.1 and laterV2No