CubesViewer - Quickstart
CubesViewer is a client-side HTML5 application. You can test it by simply downloading the package and opening the HTML file in your browser.
Download the latest cubesviewer:
git clone https://github.com/jjmontesl/cubesviewer.git
(You can also download a zipped package).
html/views.htmlin your browser. When prompted, accept the default server URL (
Done! You are running your own copy of CubesViewer connecting to data from CubesViewer public demo server.
- Cubes is the OLAP Cubes Server by DataBrewery.
- CubesViewer is the client-side HTML5 viewer library for Cubes.
- CubesViewer Studio is the client-side HTML5 exploring solution for Cubes.
- CubesViewer Server is the server-side backend for CubesViewer Studio (optional).
Setting up Cubes and CubesViewer example data
The example above uses data from CubesViewer public demo server. But in order to serve your own data, you need to run your own Cubes installation.
We'll download the example data and install it locally along with Cubes. This example needs Python, PIP and virtualenv installed:
Clone the CubesViewer cubes-examples repository which contains this example:
git clone https://github.com/jjmontesl/cubes-examples
Enter the directory. Create a virtual environment and activate it (this is optional, but helps keeping your Python installation clean):
cd cubes-examples virtualenv env . env/bin/activate
Install Cubes package via PIP:
pip install -r requirements.txt
This will install dependencies: Cubes, Flask and SQLAlchemy.
Enter the "webshop" dir and run Cubes OLAP server (the tool is called
cd webshop slicer serve slicer.ini
This will use the
model.jsonconfig files to initialize Cubes server. The database is a SQLite database included in the same directory.
http://localhost:5000and check the server response. Cubes should reply with a short web page describing its configuration.
Refer to Cubes site for download and installation instructions.
Put it all together
Make sure your Cubes slicer service is running (from the section above).
Use your browser to load
When prompted, accept the default Cubes location:
Done! You are now using your copy of CubesViewer to access your local Cubes server.
CubesViewer Studio and Server
If you wish to install the full CubesViewer Studio Server environment, which allows several users to save / share views, check the Installing CubesViewer Server section.
You can also embed the CubesViewer views you design into other web applications. Check Integrating CubesViewer views in other web applications for further information.