Install and run BangDB server
You may get the BangDB using of one of these four ways:
- Pick and take the tar file from the download page
- Clone the BangDB public Github repo
- Simply use wget.
- Or, use the Docker Image
Option A, B & C
Eventually all these three options gives you a tar file and we can install using it.
Following are the names of the binary, you may directly download using wget
The downloaded tar file will be like this (for Ubuntu 18 bangdb_2.0_ubuntu18.tar.gz)
Untar this file
tar -xzvf bangdb_2.0_ubuntu18.tar.gz
You will find README here, which has the steps to install and run the BangDB server, must follow the steps provided in the README.
Run the install.sh file (May run for few min and finally everything should be set up)
Run the server There are two ways to run the server, using the server binary directly OR using the helper script
Let's use helper script
This will run the server in background You may check the status of BangDB server using
Status 'bangdb-server-2.0' : Running
And you may stop the server by
You can also directly run bangdb-server using the binary, it will allow you to provide command line argument as well. This allows user to have more control on how server may run by using command line arguments.
However, all of these arguments could be configured by editing the bangdb.config file and use above mentioned helper script. Hence if you use script then these should be set in bangdb.config. See bangdb.config for more details.
It is super important to learn this if you wish to have more control on how server is run To run the server using this option, you need to go to bin folder and run the server that's it.
use -help command line arg to see all the options
There are few parameters that should be set and please see bangdb config page to learn more.
This is default mode of running the server and kindly see bangdb config page to learn various configurations and also running servers with added features. Next you should run cli and the test benchmark and check all is fine. Use the cli
To see the tables
To see BangDB servertype
To see BangDB help
To see help for BangDB Stream
BangDB cli is quite comprehensive and supports all activities that we can perform on BangDB, from DDL to DML to some admin tasks. See the bangdb cli page for lot more details.
Run test benchmark and test. Run bench to see all is good and also typical throughput for the server. Please note this gives bare minimum throughput data as single client runs, to check actual IOPS, pls see benchmark Make sure server is running or
Run the server
Go to bench folder, let's go to cpp folder for now
Build the test
This will build a bench file, now run the bench
It will run simple put, get and scan and it's throughput Now run the java test, from main folder
To do proper benchmark, we need to set up the config properly and also use a server which has minimum of 8GB RAM and 4 Cores. YCSB benchmark can also be set up and run. This would allow user to compare the number vis-a-vis other dbs.
You may use bangdb clients to write powerful application to enable some of the use cases. BangDB clients allows you to write highly efficient, high performance and scalable apps due to its own messaging framework, servers architecture and ability to handle high volume with speed at ease from tens of thousands of connections.