[jira] [Created] (QPID-5493) qpidd persistence needs documentation

["Fraser Adams (JIRA)" <ji...@apache.org>]

Fraser Adams created QPID-5493:
----------------------------------

             Summary: qpidd persistence needs documentation
                 Key: QPID-5493
                 URL: https://issues.apache.org/jira/browse/QPID-5493
             Project: Qpid
          Issue Type: Improvement
          Components: C++ Broker
            Reporter: Fraser Adams


There has clearly been a lot of good work that has gone on lately to move qpidd away from a dependency on a 3rd party RedHat persistence module that wasn't Apache licenced to two new Apache licenced Qpid modules (legacystore and linear store).

The hard work that has been put into developing these would seem to be somewhat undermined by there being no (obvious) documentation for using/setting up/configuring etc. of these stores.

Given other Jira traffic clearly *someone* knows how to use these in quite some detail, but it's not clear that it's currently something that Qpid users would be able to quickly and easily make use of.

Couldn't see anything on persistence/durability in:
http://qpid.apache.org/releases/qpid-0.24/cpp-broker/book/index.html

"Pluggable Persistence" is mentioned in:
http://qpid.apache.org/components/cpp-broker/index.html
But there is no link to any documentation.

I couldn't see any documentation in "qpid/cpp" or "qpid/cpp/src" the closest that I came was noticing linearstoresetup.sh in "qpid/cpp/src/tests/linearstore", legacystore tests seem a lot more involved.

I also noticed when I looked through linearstoresetup.sh references to:
LINEARSTOREDIR=~/RedHat/linearstore
which seems an odd path
and
${LINEARSTOREDIR}/tools/src/py/linearstore/efptool.py $STORE_DIR/qls/ -a -p 1 -s 2048 -n 25

But when I looked in /tools/src/py (on 0.27) I could find directories
qpidstore and qls, but nolinearstore so it's hard to see how this script could run successfully. The directory qls looks like it stands for "qpid linear store" but in that directory there's an efp.py but no efptool.py

In short there's a lot of good work that's potentially being wasted by inconsistencies and lack of useable documentation, which seems a real shame.











--
This message was sent by Atlassian JIRA
(v6.1.5#6160)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org