{fusion_path}/data/nlp
directory, or files that you have created on your own.
You can also work with blobs in the Fusion UI using the blob manager.
When you upload a blob without specifying an app, the blob is stored in the system_blobs
collection and you can access it via the Use the Object Explorer.
Use the Object Explorer
Use the Object Explorer
LucidAcademyLucidworks offers free training to help you get started.The Course for The Object Explorer focuses on how to view and manage objects such as collections, datasources, index and query pipelines, index and query profiles, and parsers within apps and share them to other applications:Visit the LucidAcademy to see the full training catalog.
Get started
How to open Object ExplorerOn a PC, press Ctrl+K. On a Mac, press Command ⌘+K. Alternatively, click System > Object Explorer.Object Explorer opens and displays either a list of all objects in the current app, or the list of objects that match your most recent search in Object Explorer, whether during this Fusion session or a previous session.Search and browse
- Specify the context To restrict the scope of searching and browsing, click In Current App, In Any App, or In No Apps.
- Browse all objects in the context – Specify the context. Object Explorer displays a list of all objects. If you do not see a list of objects, press Enter in the Filter box.
- Search for objects – Specify the context. Type any part of an object’s name or type (the gray, uppercase text below the name, for example,
PARSER
) in the Filter box. You can entergroup
to search for groups. Enter the search term in any case. Object Explorer displays a list of matching objects. - Display related objects (with a mouse) – With a list of objects present, click an object to select it. Object Explorer centers the object and displays all related objects.
- Display related objects (with Tab keys) – With a list of objects present, tab from object to object. With an object highlighted, press Enter to select it. Object Explorer centers the object and displays all related objects.
- Move backward and forward through a history of results – You can move backward and forward through a history of results, that is, the objects you have browsed to, searched for, and clicked on. To the right of the Filter box, click the arrow keys.
- Determine which apps an object is in – Click In any App. You will see dots on the objects that represent the apps that the objects are in. To view a list of the apps for an object, hover over the object, and then click the App
icon.
Manage objects
- Edit an object’s name – For some objects, for example, Group objects, clicking
lets you edit the object’s name.
- Manage an object – For most objects that display the
icon when you hover over the object, 
- System groups (
) - Groups created by Fusion to group objects such as signals and items that are shared among apps. You cannot modify the membership of a system group.
- Recommendations groups (
) - Groups related to recommendations. These are a subtype of system groups. You cannot modify the membership of a recommendations group.
- User-defined groups (
) - Groups you create and manage yourself. You can put whatever objects you like in them.
- Fusion-created groups that are not system groups (
) - These look and behave like user-defined groups, but you do not create them. Fusion does. You can put objects in them.
- View existing groups – A group is a means of tagging objects with a shared, arbitrary identifier.
-
Create a user-defined group – Hover over an object that you want to add to the group you are creating, and that displays the Add To Group
icon when you hover. Click Add To Group
. Enter the name of a new group. A group name can only contain the characters
A-Z
,a-z
,0-9
,-
(hyphen), and_
(underscore). -
Add an object to a group – Hover over an object that displays the Add To Group
icon when you hover. Click Add To Group
. Choose an existing group, or enter the name of a new group. You cannot add objects to the group
_shared
. Its members are calculated for you. -
Remove an object from a group – Select the group from which you want to remove an object. Object Explorer centers the group. Hover over the object you want to remove, and then click Remove From Group
.
-
Delete a user-defined group – When you remove the last object from a user-defined group, the group remains. To delete it, hover over the group, and then click
.
Share objects among apps
Sharing objects among apps lets you configure something once and use it multiple times where needed. When you share an object, the object and any objects that the objects depends on are shared.Fusion makes intelligent choices regarding what is shared among apps. Exercise caution when adding and removing objects from apps.
- Add an object to an app – While in the Fusion workspace for the app to which you want to add an object, open Object Explorer and click In Any App. Search for or browse to the object you want to add. Hover over the object, click the App
icon, and then click Add to this app.
- Add an object to an app directly – In cases when an object is linked to an app, but is not linked directly to the app (it is linked via some dependency), you can add the object to an app directly.
While in the Fusion workspace for the app to which you want to add an object directly, open Object Explorer and click In Any App. Search for or browse to the object you want to add. Hover over the object, click the App
icon, and then click Add to this app directly.
- Remove an object from an app – While in the Fusion workspace for the app from which you want to remove an object, open Object Explorer and click In Any App. Search for or browse to the object you want to remove. Hover over the object, click the App
icon, and then click Remove.
Close Object Explorer
On a PC or Mac, press Esc or click Close
Previously, you could use the Blob Store API to install connectors. Instead, use the Install or update a connector - 5.2 and later.
Install or update a connector - 5.2 and later
Install or update a connector - 5.2 and later
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
- In your Fusion app, navigate to Indexing > Datasources.
- Click Add.
- 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.
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
- Download the connector zip file from Download V2 connectors.
Do not expand the archive; Fusion consumes it as-is.
- In your Fusion app, navigate to System > Blobs.
- Click Add.
- Select Connector Plugin.
The “New Connector Plugin Upload” panel appears. - Click Choose File and select the downloaded zip file from your file system.
- Click Upload.
The new connector’s blob manifest appears.
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
-
Download the connector zip file from Download V2 connectors.
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:Fusion automatically publishes the event to the cluster, and the listeners perform the connector installation process on each node.If thepluginId
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.Blob Types
AresourceType
query parameter can be used to specify the blob type. For example, specify file
when uploading a text or CSV file, like this:
resourceType
is below:
Type | Description |
---|---|
banana | A Banana dashboard |
catalog | An analytics catalog |
driver:jdbc | A Upload a JDBC Driver to Fusion Server |
file:js-index | A JavaScript file for use with a Managed Javascript index stage |
file:js-query | A JavaScript file for use with a Managed Javascript query stage |
file | Any uploaded file, such as from the Quickstart or the Index Workbench |
unspecified | A blob of unknown type If no resourceType is specified on upload, “other” is assigned by default. |
plugin:index-stage | An index stage plugin |
plugin:query-stage | A query stage plugin |
Upload a JDBC Driver to Fusion
Upload a JDBC Driver to Fusion
The JDBC V2 connector is supported, and fetches documents from a relational database via SQL queries. Under the hood, this connector implements the Solr DataImportHandler (DIH) plugin.Fusion stores JDBC drivers in the blob store. You can upload a driver using the Fusion UI or the Blob Store API.
How to upload a JDBC driver using the Fusion UI
- In the Fusion UI, navigate to System > Blobs.
- Click Add.
-
Select JDBC Driver.
The “New ‘JDBC Driver’ Upload” panel appears.
-
Click Choose File and select the .jar file from your file system.
-
Click Upload.
The new driver’s blob manifest appears.
How to install a JDBC driver using the API
-
Upload the JAR file to Fusion’s blob store using the
/blobs/{id}
endpoint. Specify an arbitrary blob ID, and aresourceType
value ofplugin:connector
, as in this example:Success response:Fusion automatically publishes the event to the cluster, and the listeners perform the driver installation process on each node.If the blob ID is identical to an existing one, the old driver will be uninstalled and the new driver will installed in its place. To get the list of existing blob IDs, run:curl -u USERNAME:PASSWORD https://FUSION_HOST:FUSION_PORT/api/blobs
-
To verify the uploaded driver, run:
Where the
BLOB_ID
is the name specified during upload, such as “mydriver” above. A success response looks like this:
Quickstart
Quickstart
The Quickstart is a wizard that lets you explore some of Fusion’s core capabilities:
- Creating or selecting an app
- Selecting a collection (where data is stored)
- Indexing data
- Searching
LucidAcademyLucidworks offers free training to help you get started.The Course for Using The Quickstart Wizard focuses on using the wizard to practice using the key functions of Fusion:Visit the LucidAcademy to see the full training catalog.
Step through the Quickstart wizard
If it is not already open, open the Quickstart wizard. In the Fusion launcher, click New here? Get started….
-
Click Continue.
On the Select an App screen, you can select or create an app for your quickstart data.
If you click Create new app, Fusion prompts you to enter an app name (and optionally a description), then click Create App to return to the Quickstart. Your new app is selected by default. -
After selecting an app, click Continue.
On the Select a Collection screen, you can select or create a collection for your quickstart data. A collection with the same name as your app is created automatically:
-
Click Continue.
On the Index Data screen, you can either select one of the built-in sample datasets or click Use my data to upload your own:
-
Click Continue.
On the Query Data screen, you can see all search results and enter your own search queries to test the indexed dataset. You can also select the display fields or view the parsed documents:
-
Click Continue.
From here, you can do the following:- Open the Index Workbench to change the index pipeline.
- Fusion 4.x Index Workbench
- Fusion 5.x Index Workbench
- Open the Query Workbench to change the query pipeline.
- Fusion 4.x Query Workbench
- Fusion 5.x Query Workbench The workbenches are essentials tools in the Fusion workflow.
-
Open App Studio to create a user interface for searching this collection.
App Studio is only available in Fusion 4.1 and 4.2.
Examples
Upload a JavaScript file to the blob store: REQUESTIn this example, we have changed the name of the blob during upload by giving it a different ID. The file is named ‘en-sent.bin’ but we have defined the ID of this to ‘sentenceModel.bin’. When we use this blob in an index pipeline, we would refer to it by the ID we have given it.