Setup Prerequisites

Overall Components

In order to build and run all parts of the data visualisation application, you will need to have all these components installed on your system.

  • CentOS 7 Linux Operating System
  • GridDB Database: Download the latest GridDB installation for your system here.
  • GridDB C Client: Install the client and configure the client here.
  • GridDB Python Client: Install the Python client here.
  • Python Bokeh Data Visualisation Library: This library can be installed as a pip from the command line.

Setting Up GridDB

Once you have successfully downloaded GridDB onto your system you can follow these instructions to install it. You may also want to configure GridDB and run your first node cluster from this link.

Setting Up the C Client

You can obtain the GridDB C client from the official Github page. Before following all the instructions specified in the README.md, ensure these packages are installed on your system.

$ sudo yum install libtool 
$ sudo yum groupinstall ‘Development Tools’
$ sudo yum makecache fast

Setting Up the Python Client

One important thing to note is that to successfully install and configure the Python client for GridDB you must also have the C client installed and configured. This is because certain variables such as the LD_LIBRARY_PATH variable must point to certain directories made in the C client. Also note that Python client comes in a bundle with the Ruby client, so have Ruby installed on your system even if you may never use the Ruby client. You will also need a Python development library to make the project as well as other packages needed by both the Data Generating client.

$ sudo yum install python-devel 
$ sudo yum install ruby-devel
$ sudo yum install epel-release
$ sudo yum install gsl-devel

You can obtain the Python client from the GridDB's Github repository.

One important thing to note is that the default version listed in the Python client's Makefile is Python 2.6. If you have a different Python version, you must edit the Makefile to match that version. This can be done by editing the INCLUDES_PYTHON line in the file.

$ vi Makefile

Change the line from
INCLUDES_PYTHON = $(INCLUDES) -I/usr/include/python2.6
into
INCLUDES_PYTHON = $(INCLUDES) -I/usr/include/$PYTHON_VERSION

Setting Up Bokeh

Bokeh is an interactive data visualisation library for Python. It can provide construction of elegant and precise graphics for web browser presentation. More information can be found at their official site. It can be installed easily as a pip package. You can install Bokeh and its development tools as a pip package. Packages of these type can be installed with the python -m pip install command. If you can do not have pip on your system, you can install it with these commands:

$ sudo yum install python-pip
$ sudo yum install python-wheel

Once you have pip installed, you can install Bokeh and Pandas libraries needed to run the Data Visualisation component

$ python -m pip install bokeh
$ python -m pip install pandas

Source Code

You can download the application and its source code for the data generating client and data visualisation component from the link below:

Download: datavisualisation_application.tar.gz