summaryrefslogtreecommitdiffstats
path: root/src/rgw/driver/posix/README.md
blob: 73971edc86fe13e61f61e781842d4b03febb5743 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# POSIX Driver
Standalone Rados Gateway (RGW) on a local POSIX filesystem (Experimental)


## CMake Option
Add below cmake option (enabled by default)

    -DWITH_RADOSGW_POSIX=ON 


## Build

    cd build
    ninja [vstart]


## Running Test cluster
Currently, POSIXDriver depends on DBStore for user storage.  This will change, eventually, but for now, it's run as a filter on top of DBStore.  Not that only users are stored in DBStore, the rest is in the POSIX filesystem.
Edit ceph.conf to add below option

    [client]
        rgw backend store = dbstore
        rgw config store = dbstore
        rgw filter = posix

To start the `vstart` cluster, run the following cmd:

    MON=0 OSD=0 MDS=0 MGR=0 RGW=1 ../src/vstart.sh -n -d --rgw_store posix

The above vstart command brings up RGW server on POSIXDriver. It creates default zonegroup, zone and few default users (e.g., testid) to be used for s3 operations.

`radosgw-admin` command can be used to create and remove other users, zonegroups and zones.

By default, the directory exported, *'rgw_posix_driver'*, is created in the `dev` subdirectory.   This can be changed with the `rgw_posix_base_path` option.

The POSIXDriver keeps a LMDB based cache of directories, so that it can provide ordered listings.  This directory lives in `rgw_posix_database_root`, which by default is created in the `dev` subdirectory