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 


Reply via email to