Skip to main content
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:
  • 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.

​
Find your connector

​
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.