Menu
Download Free Trial
  1. API reference
  2. Welcome
    1. Getting started
    2. Quickstart
    3. System requirements
    4. Typical errors
    5. Installation troubleshooting
  3. Connecting to Data Source
    1. JSON
      1. JSON data source
      2. Data types in JSON
    2. CSV
      1. CSV data source
      2. Data types in CSV
    3. SQL database
      1. Connecting to SQL database
      2. Connecting to database with .NET
      3. Connecting to database with .NET Core
      4. Connecting to database with Java
      5. Connecting to database with PHP
    4. Microsoft Analysis Services
      1. Connecting to Microsoft Analysis Services
      2. Getting started with Accelerator
      3. Installing Accelerator as a Windows Service
      4. Configuring username/password protection
      5. Configuring secure HTTPS connection
      6. Troubleshooting
    5. Pentaho Mondrian
      1. Connecting to Pentaho Mondrian
      2. Getting started with Accelerator
      3. Configuring Mondrian roles
      4. Сonfiguring username/password protection
      5. Сonfiguring secure HTTPS connection
      6. Troubleshooting
    6. icCube
  4. Configuring report
    1. Configuring report
    2. Data source
    3. Slice
    4. Options
    5. Number formatting
    6. Conditional formatting
    7. Set report to the component
    8. Get report from the component
    9. Calculated values
    10. Custom sorting
    11. Date and time formatting
    12. Configuring global options
  5. Integration with frameworks
    1. Integration with frameworks
    2. Integration with AngularJS
    3. Integration with Angular 2
    4. Integration with Angular 4
    5. Integration with React
    6. Integration with RequireJS
    7. Integration with TypeScript
    8. Integration with ASP.NET
    9. Integration with JSP
    10. Integration with PhoneGap
  6. Integration with charts
    1. Integration with charts
    2. Integration with Highcharts
    3. Integration with FusionCharts
    4. Integration with Google Charts
    5. Integration with any charting library
  7. Customizing
    1. Customizing toolbar
    2. Customizing appearance
    3. Localizing component
  8. Export and print
  9. Updating to the latest version
    1. Updating to the latest version
    2. Release notes
    3. Migration guide from 2.3 to 2.4
    4. Migration guide from 2.2 to 2.3
  10. Managing license keys
  11. Older Versions
    1. Documentation 2.3
    2. Documentation 2.2
    3. API reference - Flex
Table of contents

Mondrian / Getting started with Accelerator

Everyone who has ever worked with multidimensional databases analysis has most probably faced the problem of finding a suitable component that not only performs all required functions but also executes them fast. Flexmonster solved this problem and created Flexmonster Accelerator for Pentaho Mondrian cubes – a special server-side proxy that helps you to increase data loading speed from server to customer’s browser.

Working with OLAP cubes, a browser component is communicating with the server via XMLA protocol. It’s no secret that the XMLA protocol is heavy and exchanges a lot of excessive information. Thus, it takes too much time and memory to load and process the data.

We replaced XMLA protocol and use direct requests from the Component to a server.

In this way, we have come up with solutions to two major problems that many of those who work with big data had faced to a different extent:

  • We made big data transfer from server to browser enormously fast. Our tool allows you to transfer large multidimensional data in super easy and fast way. Reporting becomes more enjoyable and prompt for your end users.
  • We greatly reduced the load on a browser memory.

Open Live Demo

Requirements

  • Flexmonster Pivot Component version 2.2 or higher
  • Relational database and Mondrian schema for it
  • Java JRE 1.7+

Step 1: Embed the component into your web page

You already have in your HTML page an empty component. If Flexmonster Component is not embedded – return to Quickstart. Your code should look like the following example:

<div id="pivotContainer">The component will appear here</div>
<script src="flexmonster/flexmonster.js"></script>
<script>
	var pivot = new Flexmonster({
		container: "pivotContainer",
		toolbar: true,
		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
	});
</script>

Step 2: Configure Data Speed Accelerator on the server

The package contains following files (server/ folder):

  • flexmonster-proxy-mondrian.jar – server-side utility that handles connectivity between Pentaho Mondrian and Flexmonster Pivot Component
  • flexmonster-proxy-mondrian-4.jar – same as flexmonster-proxy-mondrian.jar, but for newer version of Pentaho Mondrian 4.4
  • flexmonster.config – file that contains configuration parameters for the utility (connection string, port, etc.)

Also, there are additional sample files:

  • FoodMart.xml – sample Mondrian schema for FoodMart database
  • FoodMart-4.xml – same as FoodMart.xml, but for newer version of Pentaho Mondrian 4.4
  • mysql-connector-java-*.jar – Java connector for MySQL database

First of all, let’s review flexmonster.config file. It contains following parameters:

  • CONNECTION_STRING – connection string for Pentaho Mondrian. Required.
    Example: Jdbc=jdbc:mysql://localhost:3306/foodmart?user=root&password=password;JdbcDrivers=com.mysql.jdbc.Driver;
  • JDBC_DRIVER_JAR – path to the Java connector (.jar file) for database. Required.
    Example: ./mysql-connector-java-5.1.37.jar
  • JDBC_DRIVER_CLASS – class name of the Java connector. Required.
    Example: com.mysql.jdbc.Driver
  • CATALOGS_PATH – a path to the folder that contains Mondrian schemas. Optional. The default is ./
  • PORT – port number for the proxy service endpoint. Optional. The default is 50006
  • CACHE_MEMORY_LIMIT – size of maximum RAM memory available for cache (in MB). Optional. The default is 0 (unlimited).
  • CACHE_ENABLED – indicates whether the cache is enabled. Optional. The default is true. Available since version 2.211.

After configuring all the necessary options, Data Speed Accelerator is ready to be launched. Just execute the following commands in terminal:

# navigate to folder that contains Accelerator
cd {path_to_package}/server
# start Accelerator
java -jar flexmonster-proxy-mondrian.jar

If your schema is built for Mondrian 4, just use flexmonster-proxy-mondrian-4.jar instead.

Step 3: Open a port for Data Speed Accelerator in the firewall

If it’s planned to allow connection to Data Speed Accelerator from outside of the server, you should open an appropriate port in the firewall. Default port number is 50006, but it may vary depending on PORT parameter in flexmonster.config file.

Step 4: Configure Flexmonster Pivot Component

Now it’s time to configure the client – Flexmonster Pivot Component. Let’s create a minimal configuration using JavaScript API (replace proxyUrl, catalog and cube parameters with your specific values):

var pivot = new Flexmonster({
	container: "pivotContainer",
	toolbar: true, 
	report: {
		dataSource: {
			dataSourceType: "mondrian",

			/* URL to the Data Speed Accelerator */
			proxyUrl: "http://localhost:50006",
					
			/* Data Source Info */
			dataSourceInfo: "MondrianFoodMart",

			/* Catalog name / Mondrian schema */
			catalog: "FoodMart",

			/* Cube name */
			cube: "Sales",

			// Flag to use Data Speed Accelerator instead of XMLA protocol
			binary: true
		}
	},
	licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
});

Launch the web page from browser — here you go! A pivot table is embedded into your project.

Cache control

Accelerator for Mondrian has two levels of cache:

  • Mondrian cache
  • Accelerator cache (controlled by CACHE_ENABLED parameter)

Usually, the cache is a great help, but the cache becomes out of date if the underlying database is changing. Mondrian cannot deduce when the database is being modified, so we introduce a method to force clearing the Mondrian cache.

It works by triggering the “ClearCache” as follows:

http://localhost:50006/FlexmonsterProxy/ClearCache

Accelerator cache can be disabled by the following parameter in flexmonster.config (available since version 2.211):

CACHE_ENABLED=false

Mondrian configuration

Mondrian has a properties file to allow you to configure how it executes. It is possible to use any of these properties with Accelerator.

You just need to create mondrian.properties file in the same location as flexmonster-proxy-mondrian.jar.

For example:

mondrian­.­rolap­.­aggregates­.­ChooseByVolume = false
mondrian­.­rolap­.­aggregates­.­generateSql = false

Please refer to the full list of Mondrian properties to find out more.