]> git.apps.os.sepia.ceph.com Git - ceph-ci.git/commitdiff
rgw/dbstore: Update README
authorSoumya Koduri <skoduri@redhat.com>
Wed, 15 Sep 2021 19:29:35 +0000 (00:59 +0530)
committerSoumya Koduri <skoduri@redhat.com>
Mon, 20 Sep 2021 16:48:31 +0000 (22:18 +0530)
Signed-off-by: Soumya Koduri <skoduri@redhat.com>
src/rgw/store/dbstore/README.md

index 15e214d036596fb495cc48fcd51d72e980e015b5..3e7016cab9368ffda321aaf848941013da6cbf3f 100644 (file)
@@ -1,33 +1,43 @@
-# dbstore
-DBStore for Rados Gateway (RGW)
+# DBStore
+Standalone Rados Gateway (RGW) on DBStore (Experimental)
+
+
+## CMake Option
+Add below cmake option (enabled by default)
+
+    -DWITH_RADOSGW_DBSTORE=ON 
 
-## Pre-install
-fmt(-devel) and gtest(-devel) packages need to be installed
 
 ## Build
-Add below options to cmake - 
--DWITH_RADOSGW_DBSTORE=ON -DWITH_RADOSGW_LUA_PACKAGES=OFF
 
-cd build
+    cd build
+    ninja [vstart]
+
+
+## Running Test cluster
+Edit ceph.conf to add below option
+
+    [client]
+        rgw backend store = dbstore
+
+Restart vstart cluster or just RGW server
+
+    [..] RGW=1 ../src/vstart.sh -d
 
-ninja src/rgw/store/dbstore/install
+The above configuration brings up RGW server on dbstore and creates testid user to be used for s3 operations.
 
-## Gtests
-To execute Gtest cases, from build directory
+By default, dbstore creates .db file named 'default_ns.db' where in the data is stored.
 
-./bin/dbstore-tests
-(default logfile: rgw_dbstore_tests.log, loglevel: 20)
 
-## Execute Sample test file
+## DBStore Unit Tests
+To execute DBStore unit test cases (using Gtest framework), from build directory
 
-./bin/dbstore-bin
-(default logfile: rgw_dbstore_bin.log, loglevel: 20)
+    ninja src/rgw/store/dbstore/install
+    ./bin/dbstore-tests [logfile] [loglevel]
+    (default logfile: rgw_dbstore_tests.log, loglevel: 20)
 
-## Logging
-[To provide custom log file and change log level]
+To execute Sample test file
 
-./dbstore-tests log_file log_level
-./dbstore-bin log_file log_level
+    ./bin/dbstore-bin [logfile] [loglevel]
+    (default logfile: rgw_dbstore_bin.log, loglevel: 20)
 
-When run as RADOSGW process, logfile and loglevel are set to the
-ones provided to the radosgw cmd args.