Get Started with Fusion Server:
Run Fusion and Create an App

Download, install Fusion, and run Fusion, then create a Movie Search app.

1. Verify system requirements

For the purposes of this tutorial, verify that your operating system and and Java development kit version are supported.

2. Install Fusion

Download and install Fusion.

2.1. Unix installation

Fusion for Unix is distributed as a gzipped tar file.

To install Fusion on Linux or a Mac
  1. (If you are the root user) Switch to a different user to run Fusion. Don’t run Fusion as the root user.

    $ whoami
    root
    $ su - username
  2. 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 /opt).

  3. Change your working directory to the directory in which you placed the fusion-version.x.tar.gz file, for example:

    $ cd /opt/lucidworks
  4. Unpack the archive with tar -xf (or tar -xvf), for example:

    $ tar -xf fusion-version.x.tar.gz

    The resulting directory is named fusion/4.1.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.

To install Fusion on Windows
  1. 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.

  2. 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.1.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.1.x/conf/fusion.properties (on Unix or macOS) or fusion\4.1.x\conf\fusion.properties (on Windows), set default.address to the IP address for localhost (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

  1. Open a terminal or Command Prompt window.

  2. Change your working directory to fusion/4.1.x/bin (on Unix or macOS) or fusion\4.1.x\bin (on Windows).

  3. Start all required Fusion services:

    On Unix or macOS:

    ./fusion start

    On Windows:

    fusion.cmd start
  4. 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.

  1. Open the Fusion UI. In a browser window, open http://localhost:8764 (replace localhost with your server name or IP address if necessary).

  2. Create a password for the user admin, agree to the license terms, and then click Save and continue.

    Set admin password

  3. Fusion asks you to register. Provide the requested information and click Register, or click Skip to proceed without registering.

  4. The Fusion launcher appears:

    Launcher appears

  5. The first time you log in, Fusion automatically opens the Quickstart wizard.

    Quickstart appears

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

  1. In the Fusion launcher, click Create new app.

  2. In the App Name field, enter Movie Search.

  3. In the App Description field, enter App to search for movies.

  4. Leave the Create a default collection and associated objects check box selected.

  5. Leave the App tile color as the default color.

  6. Click Create App.

    Create new app

    The Movie Search app now appears in the Fusion launcher:

    Movie Search app in launcher

What’s next

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.

Additional reading