yugabyte · premkumr · Sep 6, 2024 · Sep 6, 2024 · Sep 6, 2024 · Sep 6, 2024
diff --git a/.../preview/deploy/multi-dc/async-replication/async-transactional-setup-dblevel.md b/.../preview/deploy/multi-dc/async-replication/async-transactional-setup-dblevel.md
@@ -88,7 +88,7 @@ To set up unidirectional transactional replication, do the following:
     Checkpointing of yugabyte completed. Bootstrap is not required for setting up xCluster replication
     ```
 
-1. If needed, perform a full copy of the database on the Primary to the Standby using distributed backup and restore. See [Distributed snapshots for YSQL](../../../manage/backup-restore/snapshot-ysql/). Otherwise, create the necessary schema objects (tables and indexes) on the Standby.
+1. If needed, perform a full copy of the database on the Primary to the Standby using distributed backup and restore. See [Distributed snapshots for YSQL](../../../../manage/backup-restore/snapshot-ysql/). Otherwise, create the necessary schema objects (tables and indexes) on the Standby.
 
 1. Set up the xCluster replication group.
 
@@ -117,7 +117,7 @@ list_xcluster_outbound_replication_groups [namespace_id]
 You should see output similar to the following:
 
 ```output
-1 Outbound Replication Groups found: 
+1 Outbound Replication Groups found:
 [repl_group1]
 ```
 
@@ -132,7 +132,7 @@ list_universe_replications [namespace_id]
 You should see output similar to the following:
 
 ```output
-1 Universe Replication Groups found: 
+1 Universe Replication Groups found:
 [repl_group1]
 ```
 

diff --git a/docs/content/preview/reference/configuration/yb-master.md b/docs/content/preview/reference/configuration/yb-master.md
@@ -983,6 +983,16 @@ expensive when the number of yb-tservers, or the number of databases goes up.
 
 ## Advanced flags
 
+##### --allowed_preview_flags_csv
+
+This is a comma-separated values (CSV) formatted catalogue of [preview feature](/preview/releases/versioning/#tech-preview-tp) flag names. Preview flags represent experimental or in-development features that are not yet fully supported. Flags that are tagged as "preview" cannot be modified or configured unless they are included in this list.
+
+By adding a flag to this list, you explicitly acknowledge and accept any potential risks or instability that may arise from modifying these preview features. This process serves as a safeguard, ensuring that you are fully aware of the experimental nature of the flags you are working with.
+
+{{<warning>}}
+Inclusion in this list doesn't automatically change any settings. It only grants permission for the flag to be modified. You'll still need to configure the flag separately after adding it to this list.
+{{</warning>}}
+
 ##### --ysql_index_backfill_rpc_timeout_ms
 
 Deadline (in milliseconds) for each internal YB-Master to YB-TServer RPC for backfilling a chunk of the index.

diff --git a/docs/content/preview/releases/versioning.md b/docs/content/preview/releases/versioning.md
@@ -98,6 +98,10 @@ TP features aren't supported by Customer Support and may change at any time duri
 
 If you are interested in a TP feature, contact {{% support-general %}}.
 
+{{<tip title="Enabling preview features">}}
+Configuration of preview feature-specific flags is restricted to those listed in the [allowed_preview_flags_csv](../../reference/configuration/yb-master/#allowed-preview-flags-csv) flag. This measure acts as a safeguard, ensuring users are aware they are modifying settings for preview features.
+{{</tip>}}
+
 Participating customers agree to provide feedback to the Product Team. However, the timeline for addressing specific areas of feedback (including bugs) is at the discretion of Yugabyte.
 
 Documentation (if provided) for TP features is marked as such.

diff --git a/docs/content/preview/yugabyte-platform/alerts-monitoring/universe-logging.md b/docs/content/preview/yugabyte-platform/alerts-monitoring/universe-logging.md
@@ -25,7 +25,7 @@ The Audit log export feature is {{<badge/ea>}}. To enable the feature in Yugabyt
 
 To export logs, you need to first create an export configuration. A configuration defines the sign in credentials and settings for the tool that you want to export your logs to. Refer to [Manage export configurations](../anywhere-export-configuration).
 
-If you want to set pgaudit.log_level to a [severity level](https://www.postgresql.org/docs/11/runtime-config-logging.html#RUNTIME-CONFIG-SEVERITY-LEVELS) greater than WARNING (that is, DEBUG1-5, INFO, NOTICE), you must set the YB-TServer [ysql_log_min_messages](../../reference/configuration/yb-tserver/#--ysql-log-min-messages) flag accordingly.
+If you want to set pgaudit.log_level to a [severity level](https://www.postgresql.org/docs/11/runtime-config-logging.html#RUNTIME-CONFIG-SEVERITY-LEVELS) greater than WARNING (that is, DEBUG1-5, INFO, NOTICE), you must set the YB-TServer [ysql_log_min_messages](../../../reference/configuration/yb-tserver/#ysql-log-min-messages) flag accordingly.
 
 ## Limitations
 

diff --git a/docs/content/preview/yugabyte-voyager/migrate/assess-migration.md b/docs/content/preview/yugabyte-voyager/migrate/assess-migration.md
@@ -137,7 +137,7 @@ For the most accurate migration assessment, the source database must be actively
 
 ## Assess a fleet of databases (Oracle only)
 
-Use the Bulk Assessment command ([assess-migration-bulk](../reference/assess-migration/#assess-migration-bulk)) to assess multiple schemas across one or more database instances simultaneously. It offers:
+Use the Bulk Assessment command ([assess-migration-bulk](../../reference/assess-migration/#assess-migration-bulk)) to assess multiple schemas across one or more database instances simultaneously. It offers:
 
 - Multi-Schema Assessment: Assess multiple schemas in different database instances with a single command, simplifying migration planning.
 - Centralized Reporting: All assessment reports are generated and stored in one organized directory, making

diff --git a/...t/stable/deploy/multi-dc/async-replication/async-transactional-setup-dblevel.md b/...t/stable/deploy/multi-dc/async-replication/async-transactional-setup-dblevel.md
@@ -88,7 +88,7 @@ To set up unidirectional transactional replication, do the following:
     Checkpointing of yugabyte completed. Bootstrap is not required for setting up xCluster replication
     ```
 
-1. If needed, perform a full copy of the database on the Primary to the Standby using distributed backup and restore. See [Distributed snapshots for YSQL](../../../manage/backup-restore/snapshot-ysql/). Otherwise, create the necessary schema objects (tables and indexes) on the Standby.
+1. If needed, perform a full copy of the database on the Primary to the Standby using distributed backup and restore. See [Distributed snapshots for YSQL](../../../../manage/backup-restore/snapshot-ysql/). Otherwise, create the necessary schema objects (tables and indexes) on the Standby.
 
 1. Set up the xCluster replication group.
 
@@ -117,7 +117,7 @@ list_xcluster_outbound_replication_groups [namespace_id]
 You should see output similar to the following:
 
 ```output
-1 Outbound Replication Groups found: 
+1 Outbound Replication Groups found:
 [repl_group1]
 ```
 
@@ -132,7 +132,7 @@ list_universe_replications [namespace_id]
 You should see output similar to the following:
 
 ```output
-1 Universe Replication Groups found: 
+1 Universe Replication Groups found:
 [repl_group1]
 ```
 

diff --git a/docs/content/stable/reference/configuration/yb-master.md b/docs/content/stable/reference/configuration/yb-master.md
@@ -983,6 +983,16 @@ expensive when the number of yb-tservers, or the number of databases goes up.
 
 ## Advanced flags
 
+##### --allowed_preview_flags_csv
+
+This is a comma-separated values (CSV) formatted catalogue of [preview feature](/preview/releases/versioning/#tech-preview-tp) flag names. Preview flags represent experimental or in-development features that are not yet fully supported. Flags that are tagged as "preview" cannot be modified or configured unless they are included in this list.
+
+By adding a flag to this list, you explicitly acknowledge and accept any potential risks or instability that may arise from modifying these preview features. This process serves as a safeguard, ensuring that you are fully aware of the experimental nature of the flags you are working with.
+
+{{<warning>}}
+Inclusion in this list doesn't automatically change any settings. It only grants permission for the flag to be modified. You'll still need to configure the flag separately after adding it to this list.
+{{</warning>}}
+
 ##### --ysql_index_backfill_rpc_timeout_ms
 
 Deadline (in milliseconds) for each internal YB-Master to YB-TServer RPC for backfilling a chunk of the index.

diff --git a/docs/content/stable/yugabyte-platform/alerts-monitoring/universe-logging.md b/docs/content/stable/yugabyte-platform/alerts-monitoring/universe-logging.md
@@ -25,7 +25,7 @@ The Audit log export feature is {{<badge/ea>}}. To enable the feature in Yugabyt
 
 To export logs, you need to first create an export configuration. A configuration defines the sign in credentials and settings for the tool that you want to export your logs to. Refer to [Manage export configurations](../anywhere-export-configuration).
 
-If you want to set pgaudit.log_level to a [severity level](https://www.postgresql.org/docs/11/runtime-config-logging.html#RUNTIME-CONFIG-SEVERITY-LEVELS) greater than WARNING (that is, DEBUG1-5, INFO, NOTICE), you must set the YB-TServer [ysql_log_min_messages](../../reference/configuration/yb-tserver/#--ysql-log-min-messages) flag accordingly.
+If you want to set pgaudit.log_level to a [severity level](https://www.postgresql.org/docs/11/runtime-config-logging.html#RUNTIME-CONFIG-SEVERITY-LEVELS) greater than WARNING (that is, DEBUG1-5, INFO, NOTICE), you must set the YB-TServer [ysql_log_min_messages](../../../reference/configuration/yb-tserver/#--ysql-log-min-messages) flag accordingly.
 
 ## Limitations