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.
- Rhel7
- Rhel8
- Rhel9
- Ubuntu20.04
- Ubuntu22.04
- Ubuntu24.04
cd ${HOME}
mkdir eloqdoc-rockscloud && tar -zxf eloqdoc-0.2.6-rhel7-amd64.tar.gz -C eloqdoc-rockscloud
cd ${HOME}
mkdir eloqdoc-rockscloud && tar -zxf eloqdoc-0.2.6-rhel8-amd64.tar.gz -C eloqdoc-rockscloud
cd ${HOME}
mkdir eloqdoc-rockscloud && tar -zxf eloqdoc-0.2.6-rhel9-amd64.tar.gz -C eloqdoc-rockscloud
cd ${HOME}
mkdir eloqdoc-rockscloud && tar -zxf eloqdoc-0.2.6-ubuntu20-amd64.tar.gz -C eloqdoc-rockscloud
cd ${HOME}
mkdir eloqdoc-rockscloud && tar -zxf eloqdoc-0.2.6-ubuntu22-amd64.tar.gz -C eloqdoc-rockscloud
cd ${HOME}
mkdir eloqdoc-rockscloud && tar -zxf eloqdoc-0.2.6-ubuntu24-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.pathto/home/eloq/eloqdoc-rockscloud/logs/mongod.log. - Set
storage.dbPathto/home/eloq/eloqdoc-rockscloud/db. etc/mongod.confhas 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 }