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: [email protected]
For additional commands, e-mail: [email protected]
