Skip to main content

Install from Binary - Object Storage

Download and unzip EloqDoc tarball

EloqDoc is compatible with RHEl 7, 8 and 9, Ubuntu 20.04, 22.04 and 24.04. Download the proper tarball for your operating system from here. For Storage Type, select RocksCloud.

After successfully downloading the proper binary, untar it in a directory.

cd ${HOME}
mkdir eloqdoc-rockscloud && tar -zxf eloqdoc-0.2.6-ubuntu22-amd64.tar.gz -C eloqdoc-rockscloud

Start a S3 emulator, takes minio as an exmaple.

cd $HOME
mkdir minio-service && cd minio-service
wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio
./minio server ./data

By default, minio listens on http://127.0.0.1:9000, whose default credentials is minioadmin:minioadmin,.

Prepare EloqDoc for Object Storage config file

After uncompress the package, you should see three directories: bin, lib, and etc. bin contains all executable files, lib contains all dependencies, and etc contains an example configuration file mongod.conf. Switch to eloqdoc-rockscloud to verify that.

cd $HOME/eloqdoc-rockscloud && ls

Create a data directory and a log directory. Simply place them under $HOME/eloqdoc-rockscloud.

mkdir db logs

Modify etc/mongod.conf. Assume your $HOME is /home/eloq, then

  • Set systemLog.path to /home/eloq/eloqdoc-rockscloud/logs/mongod.log.
  • Set storage.dbPath to /home/eloq/eloqdoc-rockscloud/db.
  • etc/mongod.conf has configured minio as its cloud storage, and needs no modification.

Start EloqDoc server

The EloqDoc mongod executable binary is installed in the $HOME/eloqdoc-rockscloud/bin directory. Start the server on the local machine using the commands below.

cd ${HOME}/eloqdoc-rockscloud
./bin/mongod --config ./etc/mongod.conf

Connect to EloqDoc server

EloqDoc is compatible with the MongoDB protocol. Open another terminal and run mongo client.

./bin/mongo --eval "db.t1.save({k: 1}); db.t1.find();"

It should output

MongoDB shell version v4.0.3
connecting to: mongodb://127.0.0.1:27017
Implicit session: session { "id" : UUID("288393c1-aff6-4a84-ad46-dee6691b361d") }
MongoDB server version: 4.0.3
{ "_id" : ObjectId("68493ec41cc981ea926ec094"), "k" : 1 }