beta-program.txt

.. _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 
-----------

.. note:: 

   The {+c2c-beta-program-short+} binaries program is invite only
   at this time.

After receiving an invitation to the {+c2c-beta-program-short+} binaries,
read 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.

When you first run the {+c2c-beta-program-short+} binary, it will prompt you 
to accept the disclaimer.

.. 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+} 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

   * - Pre-6.0 Server Version Support 
     - In {+c2c-beta-program-short+}, you can perform migrations between 
       clusters running MongoDB server versions older than 6.0. To see 
       guidelines and restrictions for migrating between older server 
       versions, you must have access to the {+c2c-beta-program-short+} binary.

.. note:: 

   Mongosync :ref:`c2c-api-reverse` mode is not compatible with any beta 
   features except :ref:`c2c-beta-orr`.

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:

   A->B->C Migrations </reference/beta-program/abc-migration>
   Many-To-One Migrations </reference/beta-program/many-to-one>
   Document Filtering </reference/beta-program/document-filtering>
   Pre-Existing Data Handling </reference/beta-program/destinationDataHandling> 
   Namespace Remapping </reference/beta-program/namespace-remapping>
   Oplog Rollover Resilience </reference/beta-program/orr>