Installing the Data Server as a console application

Guides in this section are focused on using the Data Server as a console application. You can also install the Data Server as a Windows/Unix service or reference it as a DLL.

This walkthrough describes how to install Flexmonster Data Server.

Prerequisites

Flexmonster Data Server can be installed with Flexmonster CLI —  a command-line interface tool for Flexmonster. Install the CLI globally using npm:

npm install -g flexmonster-cli

Now a new flexmonster command is available in the console. Learn more about Flexmonster CLI and its commands in our documentation.

To start using the Data Server, follow these guides:

• Installing Flexmonster Data Server
• Connecting to the Data Server

Installing Flexmonster Data Server

For easy and smooth installation of Flexmonster Data Server, follow the steps below.

Step 1. Download

Flexmonster Data Server is available for the following operating systems:

• Windows (32-bit and 64-bit)
• Ubuntu/Linux (64-bit and ARM64)
• macOS (64-bit and ARM64)

Flexmonster CLI downloads the appropriate version of the Data Server depending on your operating system.

To start the installation, run the following CLI command:

flexmonster add fds executable

Step 2. See the download package structure

The flexmonster add fds executable command downloads the .zip archive with Flexmonster Data Server and automatically unpacks the files in the current folder.

As a result, the flexmonster-data-server/ folder will appear in your working directory. It has the following structure:

Step 3. Run the Data Server

To start using Flexmonster Data Server, just run the executable file from the console:

flexmonster-data-server.exe

./flexmonster-data-server

Now Flexmonster Data Server is up and running. To connect Flexmonster Pivot to the Data Server, follow the next guide.

Connecting to the Data Server

Step 1. Embed the component into your webpage

If Flexmonster is not yet embedded, set up an empty component in your webpage:

let pivot = new Flexmonster({
  container: "pivotContainer",
  componentFolder: "node_modules/flexmonster/",
  toolbar: true
});

<fm-pivot 
 [toolbar]="true">
</fm-pivot>

<FlexmonsterReact.Pivot
 toolbar={true}
/>

<Pivot
 ref="pivot"
 toolbar>
</Pivot>

Step 2. Configure the report

To connect to Flexmonster Data Server, configure the report as follows:

let pivot = new Flexmonster({
  container: "pivotContainer",
  componentFolder: "node_modules/flexmonster/",
  toolbar: true,
  report: {
    dataSource: {
      type: "api",
      url: "http://localhost:9500",
      index: "sample-index"
    }
  }
});

Note The "sample-index" is the index defined in flexmonster-config.json for the sample-data/data.csv file.

Open the webpage in the browser: the pivot table with the sample CSV data is shown.

What's next?

You may be interested in the following articles:

• Data sources guide
• Configurations reference
• Security and authorization guide