C2C Beta Docs (#370) (#375)

ajhuh-mdb · jason-price-mongodb · jason-price-mongodb · web-flow · commit 0534b261575f · 2024-08-06T15:24:34.000-04:00
* C2C Beta Docs (#370) * DOCSP-29504-many-to-one-clusters (#161) * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters * DOCSP-29504-many-to-one-clusters --------- Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> * DOCSP-31603 Document Filtering (#319) * DOCSP-31603 Document Filtering * more copy edits * example + learn more links * edit start description * add version added tag to start api page * JM feedback * FG tech feedback * formatting adjustments * external feedback * build error * link beta page * repeat * nits for readability * syntax nit * learn more link * DOCSP-38285 Beta Program Landing Page (#314) * DOCSP-39095 adding atlas search indexes limitation (#312) * DOCSP-39095 adding atlas search indexes limitation * DOCSP-39095 tech edit * DOCSP-39095 tech edit * DOCSP-39095 tech edit * DOCSP 39098 Recommend limiting DDL operations during a sync (#311) * DOCSP-39098 Recommend limiting DDL operations during a sync * DOCSP-39098 ddl warning * DOCSP-39098 ddl warning * DOCSP-39098 ddl warning * DOCSP-39098 tech edit * DOCSP-39098 tech edit * DOCSP-38018 Add Note Mongosync Cannot Mid Upgrade (#307) * DOCSP-38018 Add Note Mongosync Cannot Mid Upgrade * DOCSP-38018 Add Upgrade Consideraton * XR * DOCSP-38696 Add faq regarding fatal errors (#305) * DOCSP-38696 add faq * DOCSP-38696 jason feedback * DOCSP-39594 View Clarification (#321) * DOCSP-39211 reverse update (#320) * DOCSP-39211 reverse update * Fixes per Ajay * DOCSP-38285 Beta Program Landing Page * move toc item * add 1.8 to toc * render * snooty * feature table * swap order * stage disclaimer * move disclaimer + add intro text * get started section * beta program landing edits * conflicts * add beta flag + documetn filtering content * build errors * * * * * adjust TOC * JD feedback * JD nit --------- Co-authored-by: ltran-mdb2 <143426234+ltran-mdb2@users.noreply.github.com> Co-authored-by: ianf-mongodb <85948430+ianf-mongodb@users.noreply.github.com> Co-authored-by: jocelyn-mendez1 <91144778+jocelyn-mendez1@users.noreply.github.com> Co-authored-by: Kenneth P. J. Dyer <93145796+kennethdyer@users.noreply.github.com> * DOCSP-40106 C2C Beta Disclaimer (#329) * DOCSP-40106 C2C Beta Disclaimer * * * formatting * formatting more * remove copyable code * * * * * * * nit * DOCSP-38289-dest-data-flag (#318) * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag * DOCSP-38289-dest-data-flag --------- Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> * DOCSP-38289-add-description-destination-handling (#333) Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> * DOCSP-40749-many-to-one-limitation (#334) * DOCSP-40749-many-to-one-limitation * DOCSP-40749-many-to-one-limitation * DOCSP-40749-many-to-one-limitation --------- Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> * DOCSP-40077 ABC Migrations + Migration Name Reference Page (#332) * DOCSP-40077 ABC Migrations * more edits + use cases * release notes * move content to own reference pages * build errors * nits * rename "many with one" to "many to one" * rebase * fix title names * build error * staging issue * SO feedback * data loss warning * typo * DOCSP-38286 Enable ORR (#335) * DOCSP-38286 Enable ORR * add to rn * add beta version * nit * * * final edits * SO feedback, monospace consistency * more edits * ED feedback * ED more feedback * DOCSP-39059 namespace remap (#359) * DOCSP-39059 Namespace Remap * Adds request/response example * Adds request/response example * Adds RN * Adds to/from to the start parameters * Adds to/from to the start parameters * Adds to/from to the start parameters * Adds namespace page todos * Adds syntax * Fixes typo * Procedure * Procedure * Request parameters * Request parameters * Links * Minor edit * Fixes per Jonathan Wilson * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * Fixes build issue * Fixes per Jessica * Fixes per Jessica * Fixes per Jessica * update beta-program branch (#366) * DOCSP-39095 adding atlas search indexes limitation (#312) * DOCSP-39095 adding atlas search indexes limitation * DOCSP-39095 tech edit * DOCSP-39095 tech edit * DOCSP-39095 tech edit * DOCSP 39098 Recommend limiting DDL operations during a sync (#311) * DOCSP-39098 Recommend limiting DDL operations during a sync * DOCSP-39098 ddl warning * DOCSP-39098 ddl warning * DOCSP-39098 ddl warning * DOCSP-39098 tech edit * DOCSP-39098 tech edit * DOCSP-38018 Add Note Mongosync Cannot Mid Upgrade (#307) * DOCSP-38018 Add Note Mongosync Cannot Mid Upgrade * DOCSP-38018 Add Upgrade Consideraton * XR * DOCSP-38696 Add faq regarding fatal errors (#305) * DOCSP-38696 add faq * DOCSP-38696 jason feedback * DOCSP-39594 View Clarification (#321) * DOCSP-39211 reverse update (#320) * DOCSP-39211 reverse update * Fixes per Ajay * (DOCSP-40128): v1.7.3 release updates (#326) * (DOCSP-40128): v1.7.3 release notes * more updates * fix * fix * address review comments * DOCSP-38358 populating empty pages (#324) * DOCSP-38358 populating empty pages * DOCSP-38358 fixing spacing * DOCSP-38358 populating empty pages * DOCSP-38358 populating empty pages * DOCSP-38358 populating empty pages * DOCSP-38358 populating empty pages * DOCSP-38358 copy edits * DOCSP-38358 copy edits * DOCSP-38358 tech edits * DOCSP-38358 tech edits * (DOCSP-40657): Clarify patch releases for version support (#330) * (DOCSP-40657): Clarify patch releases for version support * typo * DOCSP-39156 Critical Advisory (#336) * DOCSP-39156 Critical Advisory * Adds header-rows field * Adds header-rows field * Adjusts column widths * Adjusts column widths * Adjusts column widths * Adjusts column widths * Adjusts column widths * Adds RN entries * Reworks for includes * Reworks for includes * Reworks for includes * Reworks for includes * Fixes per Sarah * Fixes per Rachael * Fixes per Rachael * Fixes per Rachael * Fixes per Rohan * Fixes per Tim * DOCSP-40742-disaster-recovery-page-updates (#340) * DOCSP-40742-disaster-recovery-page-updates * JP nit * ED nit * DOCS-41102 added code snippets cutover page (#341) * DOCS-41102 * DOCSP-41102 added to quickstart * DOCSP-41102 * DOCSP-40138-Mongosync-Delay-After-Resume-Restart (#343) * DOCSP-40138-Mongosync-Delay-After-Resume-Restart * add 1.8 to toc * * * * * JA feedback * add retry bit * DOCSP-41355 live upgrade updates (#349) * DOCSP-41355 live upgrade updates * external review * DOCSP-40105-storageEngine-limitation (#348) * DOCSP-40286 update wording (#353) * added reversing descr (#355) * DOCSP-41105 "About mongosync" page (#347) * DOCSP-41105 second draft * DOCSP-41105-2 * DOCSP-41105-2 * DOCSP-41580 creates release notes for 1.8.0 (#352) * DOCSP-41580 creates release notes for 1.8.0 * Responds to draft comments * Updates embedded verifier text and adds versions bugs were introduced * Removes embedded verifier. See #339 for embedded verifier release notes * Remove embedded verifier title * Updates release notes from sme feedback * DOCSP-41853 Updates mongosync documentation to support 1.8 release (#362) * Updates documentation for 1.8 * Update source/reference/api/progress.txt Co-authored-by: Jessica <127883609+jtcovan@users.noreply.github.com> --------- Co-authored-by: Jessica <127883609+jtcovan@users.noreply.github.com> * DOCSP-41323 made behavior page (#356) * DOCSP-39095 adding atlas search indexes limitation (#312) * DOCSP-39095 adding atlas search indexes limitation * DOCSP-39095 tech edit * DOCSP-39095 tech edit * DOCSP-39095 tech edit * DOCSP 39098 Recommend limiting DDL operations during a sync (#311) * DOCSP-39098 Recommend limiting DDL operations during a sync * DOCSP-39098 ddl warning * DOCSP-39098 ddl warning * DOCSP-39098 ddl warning * DOCSP-39098 tech edit * DOCSP-39098 tech edit * DOCSP-38018 Add Note Mongosync Cannot Mid Upgrade (#307) * DOCSP-38018 Add Note Mongosync Cannot Mid Upgrade * DOCSP-38018 Add Upgrade Consideraton * XR * DOCSP-38696 Add faq regarding fatal errors (#305) * DOCSP-38696 add faq * DOCSP-38696 jason feedback * DOCSP-39594 View Clarification (#321) * DOCSP-39211 reverse update (#320) * DOCSP-39211 reverse update * Fixes per Ajay * (DOCSP-40128): v1.7.3 release updates (#326) * (DOCSP-40128): v1.7.3 release notes * more updates * fix * fix * address review comments * DOCSP-38358 populating empty pages (#324) * DOCSP-38358 populating empty pages * DOCSP-38358 fixing spacing * DOCSP-38358 populating empty pages * DOCSP-38358 populating empty pages * DOCSP-38358 populating empty pages * DOCSP-38358 populating empty pages * DOCSP-38358 copy edits * DOCSP-38358 copy edits * DOCSP-38358 tech edits * DOCSP-38358 tech edits * (DOCSP-40657): Clarify patch releases for version support (#330) * (DOCSP-40657): Clarify patch releases for version support * typo * DOCSP-39156 Critical Advisory (#336) * DOCSP-39156 Critical Advisory * Adds header-rows field * Adds header-rows field * Adjusts column widths * Adjusts column widths * Adjusts column widths * Adjusts column widths * Adjusts column widths * Adds RN entries * Reworks for includes * Reworks for includes * Reworks for includes * Reworks for includes * Fixes per Sarah * Fixes per Rachael * Fixes per Rachael * Fixes per Rachael * Fixes per Rohan * Fixes per Tim * DOCSP-40742-disaster-recovery-page-updates (#340) * DOCSP-40742-disaster-recovery-page-updates * JP nit * ED nit * DOCS-41102 added code snippets cutover page (#341) * DOCS-41102 * DOCSP-41102 added to quickstart * DOCSP-41102 * DOCSP-40138-Mongosync-Delay-After-Resume-Restart (#343) * DOCSP-40138-Mongosync-Delay-After-Resume-Restart * add 1.8 to toc * * * * * JA feedback * add retry bit * DOCSP-41355 live upgrade updates (#349) * DOCSP-41355 live upgrade updates * external review * DOCSP-40105-storageEngine-limitation (#348) * DOCSP-40286 update wording (#353) * added reversing descr (#355) * DOCSP-41105 "About mongosync" page (#347) * DOCSP-41105 second draft * DOCSP-41105-2 * DOCSP-41105-2 * DOCSP-41580 creates release notes for 1.8.0 (#352) * DOCSP-41580 creates release notes for 1.8.0 * Responds to draft comments * Updates embedded verifier text and adds versions bugs were introduced * Removes embedded verifier. See #339 for embedded verifier release notes * Remove embedded verifier title * Updates release notes from sme feedback * DOCSP-41853 Updates mongosync documentation to support 1.8 release (#362) * Updates documentation for 1.8 * Update source/reference/api/progress.txt Co-authored-by: Jessica <127883609+jtcovan@users.noreply.github.com> --------- Co-authored-by: Jessica <127883609+jtcovan@users.noreply.github.com> * DOCSP-41323 made behavior page (#356) --------- Co-authored-by: ltran-mdb2 <143426234+ltran-mdb2@users.noreply.github.com> Co-authored-by: ianf-mongodb <85948430+ianf-mongodb@users.noreply.github.com> Co-authored-by: jocelyn-mendez1 <91144778+jocelyn-mendez1@users.noreply.github.com> Co-authored-by: Kenneth P. J. Dyer <93145796+kennethdyer@users.noreply.github.com> Co-authored-by: Jeff Allen <jeffrey.allen@10gen.com> Co-authored-by: sonderdonk-mdb <sarah.onderdonk@mongodb.com> Co-authored-by: jmd-mongo <73852296+jmd-mongo@users.noreply.github.com> Co-authored-by: Jonathan Wilson <jonathan.wilson@mongodb.com> Co-authored-by: Jessica <127883609+jtcovan@users.noreply.github.com> * DOCSP-41581-beta-docs-cleanup (#364) * DOCSP-41581-beta-docs-cleanup * finalize release notes * update links + delete migrationName page * build errors * more build errors * review comments * external feedback * external feedback pt 2 * * * adjust table width, text, add namespace remapping, newline in rn * title spacing * * * table space * * * fix column * clarification sentence on 1.8 features + beta * wording --------- Co-authored-by: jason-price-mongodb <69260375+jason-price-mongodb@users.noreply.github.com> Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> Co-authored-by: ltran-mdb2 <143426234+ltran-mdb2@users.noreply.github.com> Co-authored-by: ianf-mongodb <85948430+ianf-mongodb@users.noreply.github.com> Co-authored-by: jocelyn-mendez1 <91144778+jocelyn-mendez1@users.noreply.github.com> Co-authored-by: Kenneth P. J. Dyer <93145796+kennethdyer@users.noreply.github.com> Co-authored-by: Jeff Allen <jeffrey.allen@10gen.com> Co-authored-by: sonderdonk-mdb <sarah.onderdonk@mongodb.com> Co-authored-by: jmd-mongo <73852296+jmd-mongo@users.noreply.github.com> Co-authored-by: Jonathan Wilson <jonathan.wilson@mongodb.com> Co-authored-by: Jessica <127883609+jtcovan@users.noreply.github.com> * fix release date --------- Co-authored-by: jason-price-mongodb <69260375+jason-price-mongodb@users.noreply.github.com> Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> Co-authored-by: ltran-mdb2 <143426234+ltran-mdb2@users.noreply.github.com> Co-authored-by: ianf-mongodb <85948430+ianf-mongodb@users.noreply.github.com> Co-authored-by: jocelyn-mendez1 <91144778+jocelyn-mendez1@users.noreply.github.com> Co-authored-by: Kenneth P. J. Dyer <93145796+kennethdyer@users.noreply.github.com> Co-authored-by: Jeff Allen <jeffrey.allen@10gen.com> Co-authored-by: sonderdonk-mdb <sarah.onderdonk@mongodb.com> Co-authored-by: jmd-mongo <73852296+jmd-mongo@users.noreply.github.com> Co-authored-by: Jonathan Wilson <jonathan.wilson@mongodb.com> Co-authored-by: Jessica <127883609+jtcovan@users.noreply.github.com>
diff --git a/snooty.toml b/snooty.toml
@@ -21,6 +21,7 @@ toc_landing_pages = ["/quickstart",
                      "/multiple-mongosyncs",
                      "/release-notes/release-notes",
                      "/faq",
+                     "/reference/beta-program",
                      "/reference/collection-level-filtering",
                      "/reference/verification",
                      "/reference/mongosync"
@@ -33,6 +34,8 @@ version-dev = "1.8"
 c2c-product-name = "Cluster-to-Cluster Sync"
 c2c-full-product-name = "MongoDB Cluster-to-Cluster Sync"
 mdb-download-center = "`MongoDB Download Center <https://www.mongodb.com/try/download/mongosync>`__"
+c2c-full-beta-program = "Cluster-to-Cluster Sync Beta Program"
+c2c-beta-program-short = "``mongosync`` beta"
 
 [substitutions]
 c2c-product-name = "Cluster-to-Cluster Sync"
diff --git a/source/includes/abc-migration-intro.rst b/source/includes/abc-migration-intro.rst
@@ -0,0 +1,4 @@
+Starting in {+c2c-beta-program-short+} 1.8, you can perform A->B->C migrations. 
+A->B->C migrations allow you to perform two consecutive migrations, where the 
+destination cluster of the first migration acts as the source cluster for the 
+second migration. 
diff --git a/source/includes/api/requests/start-namespace-remap.sh b/source/includes/api/requests/start-namespace-remap.sh
@@ -0,0 +1,15 @@
+curl -X POST "http://localhost:27182/api/v1/start" --data '
+   {
+      "source": "cluster0",
+      "destination": "cluster1",
+      "namespaceRemap": [
+        {
+           "from": {
+              "database": "accounts",
+           },
+           "to": {
+              "database": "sales",
+           }
+        }
+      ]
+   } '
diff --git a/source/includes/beta-feature.rst b/source/includes/beta-feature.rst
@@ -0,0 +1,4 @@
+.. important:: Cluster-to-Cluster Sync Beta Program
+
+   This feature is only available in {+c2c-beta-program-short+}. To learn more, 
+   see :ref:`c2c-beta-program`.
diff --git a/source/includes/beta-program-intro.rst b/source/includes/beta-program-intro.rst
@@ -0,0 +1,3 @@
+Starting in version 1.8.0, {+c2c-product-name+} introduces the 
+{+c2c-full-beta-program+}. With {+c2c-beta-program-short+}, you can use 
+experimental features with direct support and assistance from MongoDB.
diff --git a/source/includes/destinationDataHandling-introduction.rst b/source/includes/destinationDataHandling-introduction.rst
@@ -0,0 +1,4 @@
+Starting in {+c2c-beta-program-short+} 1.8, use the ``destinationDataHandling``
+option in the start request to define what happens if the destination
+cluster already has user data. Earlier ``mongosync`` versions return an
+error if the destination cluster has user data.
diff --git a/source/includes/document-filtering-intro.rst b/source/includes/document-filtering-intro.rst
@@ -0,0 +1,4 @@
+Starting in {+c2c-beta-program-short+} 1.8, you can selectively migrate 
+documents based on specific conditions. To further limit which documents migrate 
+to the destination cluster, you can combine document filtering and 
+:ref:`namespace filtering <c2c-filtered-sync>`.
diff --git a/source/includes/document-filtering-limitations.rst b/source/includes/document-filtering-limitations.rst
@@ -0,0 +1,25 @@
+- ``field`` names can't contain dots (``.``) or dollar signs (``$``).
+
+- ``matchValues`` array items can be the following BSON types: 
+
+  - All number types
+  - Binary
+  - Booleans
+  - Datetime
+  - ObjectID
+  - Strings 
+
+- Documents must not move in or out of the filter during migration.
+
+- If the document filter contains a string and at least one migrated collection 
+  with non-default collation, ``mongosync`` fails immediately.
+
+- If you call the :ref:`progress <c2c-api-progress>` API endpoint and use a 
+  :ref:`document filter <c2c-beta-document-filtering>`, the 
+  ``estimatedTotalBytes`` response field returns ``null``.
+
+- The destination cluster must not contain pre-existing data that matches the 
+  filter.
+
+- You can't specify a document filter and set the ``reversible`` flag to 
+  ``true``.
diff --git a/source/includes/fact-valid-namespace-remap.rst b/source/includes/fact-valid-namespace-remap.rst
@@ -0,0 +1,33 @@
+
+The following restrictions apply to namespace remapping:
+
+- Namespace remapping doesn't permit writing to the ``system``, ``config``, ``admin``,
+  or ``local`` databases, or writing to internal databases used by ``mongosync``.
+
+- The database name on the destination cluster must be valid under Windows
+  restrictions.
+
+  For more information, see :limit:`Restrictions on Database Names for Windows`.
+
+- Remapped database names on the destination cluster cannot differ only in case.
+
+- The remap cannot produce namespace conflicts on the destination cluster.
+
+  For example:
+
+  .. code-block:: javascript
+     :copyable: false
+
+     "namespaceRemap": [
+       {
+          "from": { "database": "us-west" },
+          "to": {"database": "us-accounts" }
+       },
+       {
+          "from": { "database": "us-south" },
+          "to": { "database": "us-accounts" }
+       }
+     ]
+
+  If each database on the source cluster contains a ``texas`` collection,
+  ``mongosync`` may fail, corrupt data, or exhibit unexpected behavior.
diff --git a/source/includes/many-to-one-cluster.rst b/source/includes/many-to-one-cluster.rst
@@ -0,0 +1,4 @@
+Starting in {+c2c-beta-program-short+} 1.8, you can perform Many-to-One 
+migrations. Many-to-One migrations allow you to sync multiple source 
+clusters simultaneously with a destination cluster. For example, you can
+consolidate data from many small clusters into a central cluster.
diff --git a/source/includes/migration-name-limitation.rst b/source/includes/migration-name-limitation.rst
@@ -0,0 +1,7 @@
+The ``migrationName`` string can contain up to 44 alphanumeric and underscore 
+characters. ``migrationName`` is appended to the string 
+``"mongosync_internal_"`` to set the migration metadata database name.
+
+For example, if you set ``migrationName`` to 
+``"cluster_27000_to_cluster_35000_sync"``, the resulting ``mongosync`` metadata 
+database name is ``"mongosync_internal_cluster_27000_to_cluster_35000_sync"``.
diff --git a/source/includes/namespace-remapping-intro.rst b/source/includes/namespace-remapping-intro.rst
@@ -0,0 +1,3 @@
+Starting in {+c2c-beta-program-short+} 1.8, you can remap database names during 
+sync. This allows you to take data in one database on the source cluster and 
+migrate it into a different database on the destination cluster.
diff --git a/source/includes/opts/migrationName.rst b/source/includes/opts/migrationName.rst
@@ -0,0 +1,13 @@
+.. reference/configuration.txt
+.. reference/mongosync.txt
+
+Starting in ``mongosync-beta`` 1.8, sets a migration name for a sync
+operation. For example, you can set a migration name to identify each
+sync operation from multiple source clusters into one destination
+cluster.
+
+.. include:: /includes/migration-name-limitation.rst
+
+For complete examples, see :ref:`Many-to-One Migrations 
+<c2c-beta-many-to-one-example>` or :ref:`A->B->C Migrations 
+<c2c-beta-abc-migration-example>`.
diff --git a/source/includes/orr-intro.rst b/source/includes/orr-intro.rst
@@ -0,0 +1,5 @@
+Starting in {+c2c-beta-program-short+} 1.8, you can enable Oplog Rollover 
+Resilience (ORR). With ORR,  ``mongosync`` applies changes made on the source 
+cluster to the destination cluster concurrently with initial sync. For source 
+clusters with a high write rate, ORR significantly lowers the risk of oplog 
+rollover during initial sync and reduces the need to restart the sync.
diff --git a/source/includes/table-beta-compatibility.rst b/source/includes/table-beta-compatibility.rst
@@ -0,0 +1,60 @@
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :class: compatibility
+
+   * - 
+     - Many-to-One
+     - A->B->C Migration
+     - Document Filtering
+     - Namespace Remapping 
+     - Oplog Rollover Resilience
+     - Destination Data Handling 
+
+   * - Many-to-One
+     -
+     - 
+     - 
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+
+   * - A->B->C Migration
+     - 
+     - 
+     - 
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+
+   * - Document Filtering 
+     - 
+     - 
+     - 
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+
+   * - Namespace Remapping 
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+     - 
+     - |checkmark|
+     - |checkmark|
+
+   * - Oplog Rollover Resilience
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+     - 
+     - |checkmark|
+
+   * - Destination Data Handling 
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+     - 
diff --git a/source/index.txt b/source/index.txt
@@ -9,7 +9,7 @@ Cluster-to-Cluster Sync
 .. default-domain:: mongodb
 
 {+c2c-product-name+} provides continuous data synchronization or a 
-one-time data migration between two MongoDB clusters. You can enable
+one-time data migration between MongoDB clusters. You can enable
 {+c2c-product-name+} with the :ref:`mongosync <c2c-mongosync>` utility.
 
 ``mongosync`` can continuously synchronize data between two clusters.
diff --git a/source/quickstart.txt b/source/quickstart.txt
@@ -206,6 +206,8 @@ Initialization Notes
   <c2c-api-start>` command. "cluster0" and "cluster1" are just labels,
   either cluster can be ``cluster0`` or ``cluster1``.
 
+.. _c2c-quickstart-synchronize:
+
 Synchronize Data Between Clusters
 ---------------------------------
 
diff --git a/source/reference.txt b/source/reference.txt
@@ -66,4 +66,4 @@ Reference
    /reference/verification
    /reference/versioning
    /reference/supported-server-version
-
+   /reference/beta-program
diff --git a/source/reference/api/start.txt b/source/reference/api/start.txt
@@ -112,6 +112,17 @@ Request Body Parameters
 
        .. versionadded:: 1.3.0
 
+   * - ``documentFilter``
+     - document
+     - Optional
+     - .. include:: /includes/beta-feature.rst
+
+       .. include:: /includes/document-filtering-intro.rst
+       
+       To learn more, see :ref:`c2c-beta-document-filtering`.
+
+       .. versionadded:: 1.8 Beta
+
    * - ``enableUserWriteBlocking``
      - boolean
      - Optional
@@ -150,6 +161,17 @@ Request Body Parameters
 
        .. versionadded:: 1.6
 
+   * - ``namespaceRemap``
+     - array
+     - Optional
+     - .. include:: /includes/beta-feature.rst
+
+       Array of documents that specify namespace changes to make during sync.
+
+       For more information, see :ref:`c2c-beta-namespace-remapping`.
+
+       .. versionadded:: 1.8 Beta
+
    * - ``reversible``
      - boolean
      - Optional
@@ -464,5 +486,3 @@ Endpoint Protection
 
 .. |endpoint| replace:: ``start``
 .. include:: /includes/fact-api-endpoint
-
-
diff --git a/source/reference/beta-program.txt b/source/reference/beta-program.txt
@@ -0,0 +1,112 @@
+.. _c2c-beta-program:
+
+====================================
+{+c2c-full-beta-program+}
+====================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+.. include:: /includes/beta-program-intro.rst
+
+Each ``mongosync`` release has a corresponding {+c2c-beta-program-short+} 
+build that includes its own set of experimental features.
+
+.. _c2c-beta-program-disclaimer:
+
+Get Started 
+-----------
+
+To request access to the {+c2c-beta-program-short+} binaries, please file a 
+`HELP ticket <https://jira.mongodb.org/browse/HELP>`_.
+
+When you first run the {+c2c-beta-program-short+} binary, you must accept the 
+following disclaimer:
+
+.. code-block:: shell
+   :copyable: false
+  
+   MongoDB restricts access to beta features via the beta build. Your use 
+   of the beta is governed by the language specified in the Cloud 
+   Subscription Agreement, Cloud Terms of Service, or other applicable 
+   agreement between you and MongoDB with respect to your use of 
+   mongosync.
+   
+   You understand that features are available through the beta build, and 
+   flags are not generally available. All use of beta builds is at your own 
+   risk. Beta builds provide no stability guarantees; API, UI, options, and 
+   behaviors may change or be removed any time. MongoDB will never issue a 
+   Critical Advisory or notify about defects in beta builds. 
+   
+   You should follow feature usage guidance provided by Field and R&D 
+   without deviation and should only use beta builds for one-time, human-
+   supervised migrations (e.g., not for continuous sync or automated 
+   migrations). Beta capabilities are not intended for use to migrate 
+   production workloads.
+
+   Do you want to continue? (y/n):
+
+.. seealso:: 
+
+   - `Cloud Subscription Agreement <https://www.mongodb.com/cloud-subscription-agreement/november-2023>`_
+   - `Cloud Terms of Service <https://www.mongodb.com/legal/terms-and-conditions/cloud>`_
+
+
+Beta Features
+-------------
+
+{+c2c-beta-program-short+} {+version-dev+} includes the following features:
+
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+
+   * - Feature
+     - Description
+
+   * - :ref:`c2c-beta-abc-migration`
+     - .. include:: /includes/abc-migration-intro.rst
+
+   * - :ref:`c2c-beta-document-filtering`
+     - .. include:: /includes/document-filtering-intro.rst
+
+   * - :ref:`c2c-beta-destination-data-handling`
+     - .. include:: /includes/destinationDataHandling-introduction.rst
+
+   * - :ref:`c2c-beta-namespace-remapping`
+     - .. include:: /includes/namespace-remapping-intro.rst
+
+   * - :ref:`c2c-beta-many-to-one`
+     - .. include:: /includes/many-to-one-cluster.rst
+
+   * - :ref:`c2c-beta-orr`
+     - .. include:: /includes/orr-intro.rst
+
+Feature Compatibility Matrix
+----------------------------
+
+.. |checkmark| unicode:: U+2713
+
+The following table shows supported combinations of beta features:
+
+.. warning:: 
+
+   Unsupported feature combinations do not have guardrails and can result in 
+   undefined behavior.  
+
+.. include:: /includes/table-beta-compatibility.rst
+
+.. toctree::
+   :titlesonly:
+
+   /reference/beta-program/abc-migration
+   /reference/beta-program/many-to-one
+   /reference/beta-program/document-filtering
+   /reference/beta-program/destinationDataHandling 
+   /reference/beta-program/namespace-remapping
+   /reference/beta-program/orr 
diff --git a/source/reference/beta-program/abc-migration.txt b/source/reference/beta-program/abc-migration.txt
diff --git a/source/reference/beta-program/destinationDataHandling.txt b/source/reference/beta-program/destinationDataHandling.txt
diff --git a/source/reference/beta-program/document-filtering.txt b/source/reference/beta-program/document-filtering.txt
diff --git a/source/reference/beta-program/many-to-one.txt b/source/reference/beta-program/many-to-one.txt
diff --git a/source/reference/beta-program/namespace-remapping.txt b/source/reference/beta-program/namespace-remapping.txt
diff --git a/source/reference/beta-program/orr.txt b/source/reference/beta-program/orr.txt
diff --git a/source/reference/configuration.txt b/source/reference/configuration.txt
diff --git a/source/reference/mongosync.txt b/source/reference/mongosync.txt
diff --git a/source/release-notes/1.8.txt b/source/release-notes/1.8.txt

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+Starting in version 1.8.0, {+c2c-product-name+} introduces the`
	`2`	`+{+c2c-full-beta-program+}. With {+c2c-beta-program-short+}, you can use`
	`3`	`+experimental features with direct support and assistance from MongoDB.`