Skip to content

Commit

Permalink
Merge pull request #1701 from reebhub/RDoc-2502_shardingUpdates
Browse files Browse the repository at this point in the history
RDoc-2502_shardingUpdates
  • Loading branch information
ppekrol authored Sep 29, 2023
2 parents aabbdad + e65a3d9 commit 008f123
Show file tree
Hide file tree
Showing 6 changed files with 84 additions and 17 deletions.
Original file line number Diff line number Diff line change
@@ -1,24 +1,50 @@
# Migration: Migrating from RavenDB 4.x to 5.x
# Migration: Migrating from RavenDB 5.x to 6.x

* RavenDB `6.x` supports in-place migration of RavenDB `5.x` data.
* During the first startup after replacing the binaries with the new ones,
the data will migrate automatically.
* RavenDB `5.x` product licenses **do not apply** to RavenDB `6.0`.
To upgrade a valid `5.x` license to a RavenDB `6.x` license, please
use the [License upgrade tool](https://ravendb.net/l/8O2YU1).

{WARNING: }
Please note that once upgraded, RavenDB `6.x` cannot be downgraded
to version `5.x`, and the migrated data will no longer be accessible via RavenDB `5.x`.
**Please create a backup of your data before migrating.**
{WARNING/}

## Migration from RavenDB 4.x

* RavenDB `5.x` supports in-place migration of RavenDB `4.x` data.
{INFO: }

* It is **recommended** to upgrade RavenDB `4.x` to RavenDB `5.x` first,
and from `5.x` to version `6.x`.

* **Note** that RavenDB `4.x` product licenses **do not apply** to RavenDB `6.0`.
To upgrade a valid `4.x` license to a RavenDB `6.x` license, please use the
[License upgrade tool](https://ravendb.net/l/8O2YU1).

{INFO/}

* During the first startup after replacing the binaries with the
new ones, the data will migrate automatically.
* **Please note** that after migrating the data it will **no longer
be accessible** via RavenDB `4.x`.
{WARNING: }
Please create a backup of your data before migrating.
{WARNING/}

{NOTE:Migration from RavenDB 3.x}
The information above related only to data migration from RavenDB
`4.x` to `5.x`.
{WARNING: }
Please note that after migrating the data it will no longer be accessible via RavenDB `4.x`.
**Please create a backup of your data before migrating.**
{WARNING/}

* If you want to migrate your data from a RavenDB version earlier that `4.x`,

## Migration from RavenDB 3.x

The information above relates only to data migration from RavenDB `4.x` to `5.x`/`6.x`
and from `5.x` to `6.x`.

* If you want to migrate your data from a RavenDB version earlier than `4.x`,
please read the dedicated article
[here](https://ravendb.net/docs/article-page/4.2/csharp/migration/server/data-migration).

* If you want to migrate your data to a [sharded](../../sharding/overview)
database (supported by RavenDB `6.0` and above),
please read the related article [here](../../sharding/migration).
{NOTE/}

database (supported by RavenDB `6.0` and above), please read the related
article [here](../../sharding/migration).
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
},
{
"Path": "archival.markdown",
"Name": "Archival",
"Name": "Data Archival",
"DiscussionId": "b976732a-3da7-48e5-a454-4f34b8f716f9",
"Mappings": []
}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Document Archival
# Data Archival
---

{NOTE: }
Expand All @@ -21,6 +21,7 @@

* In this page:
* [Overview](../../server/extensions/archival#overview)
* [Licensing](../../server/extensions/archival#licensing)
* [Scheduling Document Archival](../../server/extensions/archival#scheduling-document-archival)
* [Archival and Other Features](../../server/extensions/archival#archival-and-other-features)
* [Archiving and Indexing](../../server/extensions/archival#archiving-and-indexing)
Expand Down Expand Up @@ -85,6 +86,16 @@
A user-defined ETL task, for example, can avoid this way from sending its target
archived documents.

---

### Licensing

{INFO: }
Archival is Available on an **Enterprise** license.
{INFO/}

Learn more about licensing [here](../../start/licensing/licensing-overview).

{PANEL/}

{PANEL: Scheduling Document Archival}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ ability to process this data, reveal and exploit its value.
* In this page:
* [Supported Message Brokers](../../../server/ongoing-tasks/queue-sink/overview#supported-message-brokers)
* [Task Statistics](../../../server/ongoing-tasks/queue-sink/overview#task-statistics)
* [Licensing](../../../server/ongoing-tasks/queue-sink/overview#licensing)

{NOTE/}

Expand Down Expand Up @@ -91,6 +92,16 @@ view to see transfer statistics.

{PANEL/}

{PANEL: Licensing}
{INFO: }
Queue Sink is Available on an **Enterprise** license.
{INFO/}

Learn more about licensing [here](../../../start/licensing/licensing-overview).

{PANEL/}


## Related Articles

### Server
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@

* In this page:
* [Sharding](../sharding/overview#sharding)
* [Licensing](../sharding/overview#licensing)
* [Client-Server Communication](../sharding/overview#client-server-communication)
* [When Should Sharding Be Used?](../sharding/overview#when-should-sharding-be-used)
* [Shards](../sharding/overview#shards)
Expand Down Expand Up @@ -66,6 +67,19 @@ of each shard in check and maintaining its high performance and throughput.

---

### Licensing

{INFO: }
Sharding is **Fully Available** on an **Enterprise** license.
{INFO/}

* On a **Developer** license, the replication factor is restricted to 1.
* On **Community** and **Professional** licenses, all shards need to be on the same node.

Learn more about licensing [here](../start/licensing/licensing-overview).

---

### Client-Server Communication

As a client connects a sharded database, it is appointed a RavenDB server
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,10 +44,14 @@
| [Load Document from another shard](../sharding/indexing#unsupported-indexing-features) | An index or a query can only load a document if it resides on the same shard. |
| [Load Document within a map-reduce projection](../sharding/querying#projection) | |
| **Stream Map-Reduce results** | [Streaming](../client-api/session/querying/how-to-stream-query-results#stream-an-index-query) map-reduce results is not supported in a Sharded Database. |
| **Stream Includes and Loads** | [Streaming](../client-api/session/querying/how-to-stream-query-results#stream-an-index-query) Includes and Loads is not supported in a Sharded Database. |
| Use `limit` with [PatchByQueryOperation](../client-api/operations/patching/set-based#patchbyqueryoperation) or [DeleteByQueryOperation](../client-api/operations/delete-by-query) | [Unsupported Querying Features](../sharding/querying#unsupported-querying-features) |
| [MoreLikeThis](../client-api/session/querying/how-to-use-morelikethis) | |
| [OrderByScore](../indexes/querying/sorting#ordering-by-score) | |
| [OrderByDistance](../client-api/session/querying/how-to-make-a-spatial-query#spatial-sorting) | Not supported in spatial map reduce indexes |
| [Highlighting](../indexes/querying/highlighting) | |
| [Intersection](../indexes/querying/intersection) | |


## Unsupported Document Extensions Features

Expand Down Expand Up @@ -94,7 +98,8 @@
| Unsupported Feature | Comment |
| ------------- | ------------- |
| [PostgreSQL](../integrations/postgresql-protocol/overview) | |
| [Queue ETL](../server/ongoing-tasks/etl/queue-etl/overview) | [Kafka](../server/ongoing-tasks/etl/queue-etl/kafka), [RabbitMQ](../server/ongoing-tasks/etl/queue-etl/rabbit-mq) |
| [Queue ETL](../server/ongoing-tasks/etl/queue-etl/overview) | [Kafka ETL](../server/ongoing-tasks/etl/queue-etl/kafka), [RabbitMQ ETL](../server/ongoing-tasks/etl/queue-etl/rabbit-mq) |
| [Queue Sink](../server/ongoing-tasks/queue-sink/overview) | [Kafka Queue Sink](../server/ongoing-tasks/queue-sink/kafka-queue-sink), [RabbitMQ Queue Sink](../server/ongoing-tasks/queue-sink/rabbit-mq-queue-sink) |

## Unsupported Patching Features

Expand Down

0 comments on commit 008f123

Please sign in to comment.