Legacy Product

Fusion 5.4

Install a Connector - Fusion 5.1

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

  1. List the connectors in Fusion’s repository:

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

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

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

  1. Download the connector zip file.

    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.