You are viewing a plain text version of this content. The canonical link for it is here.
Posted to oak-commits@jackrabbit.apache.org by ad...@apache.org on 2018/07/26 16:56:38 UTC
svn commit: r1836747 -
/jackrabbit/oak/trunk/oak-doc/src/site/markdown/nodestore/segment/overview.md
Author: adulceanu
Date: Thu Jul 26 16:56:38 2018
New Revision: 1836747
URL: http://svn.apache.org/viewvc?rev=1836747&view=rev
Log:
OAK-7459 - oak-run compact should support Azure Segment Store
Updated docs to include connection instructions for remote segment stores
Modified:
jackrabbit/oak/trunk/oak-doc/src/site/markdown/nodestore/segment/overview.md
Modified: jackrabbit/oak/trunk/oak-doc/src/site/markdown/nodestore/segment/overview.md
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-doc/src/site/markdown/nodestore/segment/overview.md?rev=1836747&r1=1836746&r2=1836747&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-doc/src/site/markdown/nodestore/segment/overview.md (original)
+++ jackrabbit/oak/trunk/oak-doc/src/site/markdown/nodestore/segment/overview.md Thu Jul 26 16:56:38 2018
@@ -664,6 +664,13 @@ Oak Segment Tar exposes a number of comm
The tools are exposed as sub-commands of [Oak Run](https://github.com/apache/jackrabbit-oak/tree/trunk/oak-run).
The following sections assume that you have built this module or that you have a compiled version of it.
+### <a name="remote-segment-stores"/> Remote Segment Stores
+Besides the local storage in TAR files (previously known as TarMK), support for remote Segment Store(s) was introduced in Apache Oak. For connecting to a remote Segment Store, a `cloud-prefix:URI` argument needs to be provided. This applies wherever a `PATH` to the Segment Store was needed.
+
+**Connection Instructions**:
+
+* **Microsoft Azure** The `cloud-prefix` for MS Azure is `az`, therefore a valid connection argument would be `az:https://myaccount.blob.core.windows.net/container/repository`, where the part after `:` is the Azure URL identifier for the _repository_ directory inside the specified _container_ of the _myaccount_ Azure storage account. The last missing piece is the secret key which will be supplied as an environment variable, i.e. `AZURE_SECRET_KEY`.
+
### <a name="backup"/> Backup
```
@@ -738,11 +745,12 @@ This option is optional and is disabled
### <a name="compact"/> Compact
```
-java -jar oak-run.jar compact [--force] [--mmap] PATH
+java -jar oak-run.jar compact [--force] [--mmap] PATH | cloud-prefix:URI
```
-The `compact` command performs offline compaction of the Segment Store at `PATH`.
-`PATH` must be a valid path to an existing Segment Store.
+The `compact` command performs offline compaction of the local/remote Segment Store at `PATH`/`URI`.
+`PATH`/`URI` must be a valid path/uri to an existing Segment Store. Currently, Azure Segment Store is the only supported remote Segment Store.
+Please refer to the [Remote Segment Stores](#remote-segment-stores) section for details on how to correctly specify connection URIs.
If the optional `--force [Boolean]` argument is set to `true` the tool ignores a non
matching Segment Store version. *CAUTION*: this will upgrade the Segment Store to the