summaryrefslogtreecommitdiffstats
path: root/src/ceph/doc/dev/corpus.rst
diff options
context:
space:
mode:
authorQiaowei Ren <qiaowei.ren@intel.com>2018-03-01 14:38:11 +0800
committerQiaowei Ren <qiaowei.ren@intel.com>2018-03-01 14:38:11 +0800
commit7da45d65be36d36b880cc55c5036e96c24b53f00 (patch)
treed4f944eb4f8f8de50a9a7584ffa408dc3a3185b2 /src/ceph/doc/dev/corpus.rst
parent691462d09d0987b47e112d6ee8740375df3c51b2 (diff)
remove ceph code
This patch removes initial ceph code, due to license issue. Change-Id: I092d44f601cdf34aed92300fe13214925563081c Signed-off-by: Qiaowei Ren <qiaowei.ren@intel.com>
Diffstat (limited to 'src/ceph/doc/dev/corpus.rst')
-rw-r--r--src/ceph/doc/dev/corpus.rst95
1 files changed, 0 insertions, 95 deletions
diff --git a/src/ceph/doc/dev/corpus.rst b/src/ceph/doc/dev/corpus.rst
deleted file mode 100644
index 76fa43d..0000000
--- a/src/ceph/doc/dev/corpus.rst
+++ /dev/null
@@ -1,95 +0,0 @@
-
-Corpus structure
-================
-
-ceph.git/ceph-object-corpus is a submodule.::
-
- bin/ # misc scripts
- archive/$version/objects/$type/$hash # a sample of encoded objects from a specific version
-
-You can also mark known or deliberate incompatibilities between versions with::
-
- archive/$version/forward_incompat/$type
-
-The presence of a file indicates that new versions of code cannot
-decode old objects across that $version (this is normally the case).
-
-
-How to generate an object corpus
---------------------------------
-
-We can generate an object corpus for a particular version of ceph like so.
-
-#. Checkout a clean repo (best not to do this where you normally work)::
-
- git clone ceph.git
- cd ceph
- git submodule update --init --recursive
-
-#. Build with flag to dump objects to /tmp/foo::
-
- rm -rf /tmp/foo ; mkdir /tmp/foo
- ./do_autogen.sh -e /tmp/foo
- make
-
-#. Start via vstart::
-
- cd src
- MON=3 OSD=3 MDS=3 RGW=1 ./vstart.sh -n -x
-
-#. Use as much functionality of the cluster as you can, to exercise as many object encoder methods as possible::
-
- ./rados -p rbd bench 10 write -b 123
- ./ceph osd out 0
- ./init-ceph stop osd.1
- for f in ../qa/workunits/cls/*.sh ; do PATH=".:$PATH" $f ; done
- ../qa/workunits/rados/test.sh
- ./ceph_test_librbd
- ./ceph_test_libcephfs
- ./init-ceph restart mds.a
-
-Do some more stuff with rgw if you know how.
-
-#. Stop::
-
- ./stop.sh
-
-#. Import the corpus (this will take a few minutes)::
-
- test/encoding/import.sh /tmp/foo `./ceph-dencoder version` ../ceph-object-corpus/archive
- test/encoding/import-generated.sh ../ceph-object-corpus/archive
-
-#. Prune it! There will be a bazillion copies of various objects, and we only want a representative sample.::
-
- pushd ../ceph-object-corpus
- bin/prune-archive.sh
- popd
-
-#. Verify the tests pass::
-
- make check-local
-
-#. Commit it to the corpus repo and push::
-
- pushd ../ceph-object-corpus
- git checkout -b wip-new
- git add archive/`../src/ceph-dencoder version`
- git commit -m `../src/ceph-dencoder version`
- git remote add cc ceph.com:/git/ceph-object-corpus.git
- git push cc wip-new
- popd
-
-#. Go test it out::
-
- cd my/regular/tree
- cd ceph-object-corpus
- git fetch origin
- git checkout wip-new
- cd ../src
- make check-local
-
-#. If everything looks good, update the submodule master branch, and commit the submodule in ceph.git.
-
-
-
-