Author: amitj
Date: Fri Aug 10 08:03:06 2018
New Revision: 1837778
URL: http://svn.apache.org/viewvc?rev=1837778&view=rev
Log:
OAK-7705: Document the requirement to reset repository id for cloned systems
Documented
Modified:
jackrabbit/oak/trunk/oak-doc/src/site/markdown/plugins/blobstore.md
Modified: jackrabbit/oak/trunk/oak-doc/src/site/markdown/plugins/blobstore.md
URL:
http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-doc/src/site/markdown/plugins/blobstore.md?rev=1837778&r1=1837777&r2=1837778&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-doc/src/site/markdown/plugins/blobstore.md
(original)
+++ jackrabbit/oak/trunk/oak-doc/src/site/markdown/plugins/blobstore.md Fri Aug
10 08:03:06 2018
@@ -396,6 +396,18 @@ the steps:
* Remove other files corresponding to the particular repositoryId e.g.
`markedTimestamp-[repositoryId]` or
`references-[repositoryId]`.
+##### Reset Repository ID
+If any of the repositories sharing a DataStore is cloned then it would have
the same `repositoryId`
+registered in the datastore as the repository from which cloned and running a
shared DSGC would lead to data loss/missing blobs.
+So, care must be taken to reset the `repositoryId`.
+
+[oak-run](http://mvnrepository.com/artifact/org.apache.jackrabbit/oak-run/)
+cli utility has a `resetclusterid` command to reset the repository id.
+The command can be executed as below and more details can be found at the
[readme](https://github.com/apache/jackrabbit-oak/blob/trunk/oak-run/README.md)
+for oak-run:
+
+`java -jar oak-run.jar resetclusterid < repository path | Mongo URI >`
+
<a name="consistency-check"></a>
#### Consistency Check
The data store consistency check will report any data store binaries that are
missing but are still referenced. The
