[jira] [Updated] (OAK-6403) Document AzureBlob datastore

["Raul Hudea (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/OAK-6403?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Raul Hudea updated OAK-6403:
----------------------------
         Priority: Minor  (was: Major)
    Fix Version/s:     (was: 1.6.3)
      Description: 
Document particular settings for the AzureDataStore like accessKey, secretKey

The [config page|http://jackrabbit.apache.org/oak/docs/osgi_config.html#config-blobstore] only mentions the generic maxCachedBinarySize and cacheSizeInMB.


  was:
The S3 datastore is currently hardly documented.

The [generic blobstore documentation|http://jackrabbit.apache.org/oak/docs/plugins/blobstore.html] is very much focused about the internal class structures, but quite confusing for someone who wants to configure a specific datastore such as file and s3 (the only ones right now). S3 settings are not documented at all, the [config page|http://jackrabbit.apache.org/oak/docs/osgi_config.html#config-blobstore] only mentions the generic maxCachedBinarySize and cacheSizeInMB.

The best bet is the [Adobe AEM product documentation|https://docs.adobe.com/docs/en/aem/6-2/deploy/platform/data-store-config.html], but that is for an older version and a few things changed since then.

Specific items below. Some have been confusing people using oak-blob-cloud 1.5.15:
- "secret" property unclear (new)
- secretKey & accessKey can be omitted to leverage IAM roles (new)
- drop of proactiveCaching property (new)
- aws bucket/region/etc. settings
- config options (timeout, retries, threads)
- understanding caching behavior and performance optimization
- shared vs. non-shared options
- migrating from a previous version, how to update the config
- requirements on the AWS (account) side


> Document AzureBlob datastore
> ----------------------------
>
>                 Key: OAK-6403
>                 URL: https://issues.apache.org/jira/browse/OAK-6403
>             Project: Jackrabbit Oak
>          Issue Type: Documentation
>          Components: blob
>            Reporter: Raul Hudea
>            Assignee: Amit Jain
>            Priority: Minor
>
> Document particular settings for the AzureDataStore like accessKey, secretKey
> The [config page|http://jackrabbit.apache.org/oak/docs/osgi_config.html#config-blobstore] only mentions the generic maxCachedBinarySize and cacheSizeInMB.



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)