Get Started with Fusion Server:
Run Fusion and Create an App
- 1. Verify system requirements
- 2. Install Fusion
- 3. Configure Fusion
- 4. Start Fusion
- 5. Open the Fusion UI
- 6. Create an app
- What’s next
- Additional reading
Download, install Fusion, and run Fusion, then create a Movie Search app.
1. Verify system requirements
2. Install Fusion
Download and install Fusion.
2.1. Unix installation
Fusion for Unix is distributed as a gzipped tar file.
(If you are the
rootuser) Switch to a different user to run Fusion. Don’t run Fusion as the
$ whoami root $ su - username
Download the Fusion archive file (
.tar.gz) for the latest version of Fusion and move it to where you would like it to reside in your filesystem (for example, in
Change your working directory to the directory in which you placed the
fusion-version.x.tar.gzfile, for example:
$ cd /opt/lucidworks
Unpack the archive with
tar -xvf), for example:
$ tar -xf fusion-version.x.tar.gz
The resulting directory is named
fusion/4.2.x. This directory is considered your Fusion home directory.
2.2. Windows installation
Fusion for Windows is distributed as a compressed zip file. To unpack the Fusion zip file on Windows, you can use a native compression utility or the freely available 7zip file archiver. Visit the 7zip download page for the latest version.
Download the Fusion zip file for the latest version of Fusion and move it to where you would like Fusion to reside in your filesystem (for example, to
C:\lucidworks). It will appear as a compressed folder.
Unpack the archive. In most cases, you only need to right-click and choose "Extract all". If you don’t see this option, check that you have permissions to extract folders on your system.
The resulting directory is named
fusion\4.2.x. This directory is considered your Fusion home directory.
3. Configure Fusion
For this tutorial, Fusion runs with its bundled Solr and ZooKeeper instances on a single node, so very little initial configuration is needed.
In the file
fusion/4.2.x/conf/fusion.properties (on Unix or macOS) or
fusion\4.2.x\conf\fusion.properties (on Windows), set
default.address to the IP address for
127.0.0.1). This avoids possible problems when roaming. Uncomment this line, and then save the file:
default.address = 127.0.0.1
4. Start Fusion
Open a terminal or Command Prompt window.
Change your working directory to
fusion/4.2.x/bin(on Unix or macOS) or
Start all required Fusion services:
On Unix or macOS:
Wait for Fusion services to start.
5. Open the Fusion UI
Open the Fusion UI. The first time you do this, you provide a password for the user
admin and are given the option to register. Subsequently, you’ll just log in.
Open the Fusion UI. In a browser window, open
localhostwith your server name or IP address if necessary).
Create a password for the user
admin, agree to the license terms, and then click Save and continue.
Fusion asks you to register. Provide the requested information and click Register, or click Skip to proceed without registering.
The Fusion launcher appears:
The first time you log in, Fusion automatically opens the Quickstart wizard.
If the Quickstart appears, click Exit the Quickstart.Tip
In the Fusion launcher, you can click the "New here? Get started…" link in the upper left corner to open the Quickstart.
In the procedures that follow, you’ll save your work as you go, so you can restart the tutorial from where you left off. However, the login to your Fusion account can time out (for example, if you take a break). If this happens, the Welcome screen appears the next time the Fusion UI tries to communicate with the Fusion API service. Log in again and pick up roughly where you left off (you’ll need to re-enter any information that wasn’t saved).
6. Create an app
Create a Movie Search app. An app is a set of Fusion objects that performs a specific searching task (such as searching for movies).
In the Fusion launcher, click Create new app.
In the App Name field, enter
In the App Description field, enter
App to search for movies.
Leave the Create a default collection and associated objects check box selected.
Leave the App tile color as the default color.
Click Create App.
The Movie Search app now appears in the Fusion launcher:
You now have Fusion installed, configured, and running. You also have the MovieLens dataset from which you will use a CSV file that contains data about movies. And you have a Fusion app that you will transform into a movie search app.
In Part 2, you’ll use Index Workbench to get the MovieLens dataset into Fusion.