BigObject uses docker as the primary delivery method. Docker allows BigOjbect applications to be shipped and updated in a standardized environment independent of the user's platform.

To download and install Docker, please visit https://docs.docker.com/install/.

Once docker is installed, the user can use following steps to setup BigObject:

Step 1: Pull BigObject demo version image for Docker.

docker pull bigobject/bigobject:demo

Step 2: Create and start a Docker container (with demo version or actual user data situation)

To run with demo version / pre-built-in data:

docker run -t -d --name bigobject -p 9090:9090 -p 9091:9091 -p 3306:3306   bigobject/bigobject:demo

Actual run with user's own data by mounting user data directory:

docker run -t -d --name bigobject -p 9090:9090 -p 9091:9091 -p 3306:3306 -v user_data_directory:/srv/bo/ds  bigobject/bigobject

Actual run with user's own data by mounting user data directory and input data directory:

docker run -t -d --name bigobject -p 9090:9090 -p 9091:9091 -p 3306:3306 -v user_data_directory:/srv/bo/ds  -v user_csv_directory:/srv/bo/file  bigobject/bigobject

For more on user data and input data directory, please refer to Mount User Directory section.

Note
For the first time user, it is recommended to run the demo version first in order to gain better understanding from this tutorial.
Note
Users who want to use MySQL protocol can use tools such as MySQL client or workbench to connect to BigObject via 3306 port.
Note
Port 9091 is used for efficiently streaming data into BigObject. Currently, csv and avro data format are supported.