-
Notifications
You must be signed in to change notification settings - Fork 42
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
NXDOC-2686: Document Amazon DocumentDB support
- Loading branch information
Showing
2 changed files
with
44 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
43 changes: 43 additions & 0 deletions
43
src/nxdoc/nuxeo-server/administration/database-configuration/documentdb.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,43 @@ | ||
--- | ||
title: Amazon DocumentDB | ||
labels: | ||
- database | ||
- documentdb | ||
tree_item_index: 700 | ||
|
||
--- | ||
The Nuxeo Platform supports Amazon DocumentDB | ||
|
||
## Configuration | ||
|
||
Since Nuxeo 2023.15, using the `mongodb` template, you can use `DocumentDB` as a `DBS` solution with some limitations: | ||
|
||
- fulltext is not supported as `DocumentDB` has various limitations in that aspect (english only, no term exclusion, semantics differences...) see [Differences With MongoDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/text-search.html#text-index-mongo-diff) for more details. | ||
You need to disable it like with the following nuxeo configuration: | ||
```properties | ||
nuxeo.vcs.fulltext.search.disabled=true | ||
``` | ||
- depending on your cluster size, you might encounter concurrent cursors limitations. It will result with a message similar to this: | ||
```console | ||
Cannot open a new cursor since too many cursors are already opened | ||
``` | ||
- hashed indexes are not supported. | ||
- retryable writes are not supported. See [Transactions' limitations](https://docs.aws.amazon.com/documentdb/latest/developerguide/functional-differences.html#functional-differences.retryable-writes). You need to disable this in your connection string with a query parameter like below: | ||
```properties | ||
nuxeo.mongodb.server=mongodb://user:password@myhost:27017/?retryWrites=false | ||
``` | ||
|
||
For all other configuration information, please refer to the [MongoDB configuration page]({{page page='mongodb'}}). | ||
|
||
* * * | ||
|
||
<div class="row" data-equalizer data-equalize-on="medium"><div class="column medium-6">{{#> panel heading='Related topics'}} | ||
|
||
- [Connecting Nuxeo to the Database]({{page page='connecting-nuxeo-to-the-database'}}) | ||
- [How to Estimate Volume Usage]({{page page='how-to-estimate-volume-usage'}}) | ||
|
||
{{/panel}}</div><div class="column medium-6"> | ||
|
||
| ||
|
||
</div></div> |