MOLT Replicator draft docs (#20465)

* MOLT Replicator docs; Oct release notes 

---------

Co-authored-by: Noel Riopel <noel.riopel@cockroachlabs.com>
Co-authored-by: Florence Morris <58752716+florence-crl@users.noreply.github.com>

Author: 3 people

src/current/_data/redirects.yml

@@ -299,6 +299,12 @@
 - destination: molt/migrate-data-load-and-replication.md
   sources: [':version/migrate-from-postgres.md']
 
+- destination: molt/migrate-load-replicate.md
+  sources: ['molt/migrate-data-load-replicate-only.md']
+
+- destination: molt/migrate-resume-replication.md
+  sources: ['molt/migrate-replicate-only.md']
+
 - destination: molt/migration-overview.md
   sources: [':version/migration-overview.md']
 

src/current/_includes/molt/crdb-to-crdb-migration.md

@@ -0,0 +1,3 @@
+{{site.data.alerts.callout_info}}
+For CockroachDB-to-CockroachDB migrations, contact your account team for guidance.
+{{site.data.alerts.end}}

src/current/_includes/molt/fetch-data-load-output.md

@@ -1,5 +1,16 @@
 1. Check the output to observe `fetch` progress. 
 
+	{% if page.name == "migrate-load-replicate.md" %}
+	<section class="filter-content" markdown="1" data-scope="oracle">
+	The following message shows the appropriate values for the `--backfillFromSCN` and `--scn` replication flags to use when [starting Replicator](#start-replicator):
+
+	{% include_cached copy-clipboard.html %}
+	~~~ 
+	replication-only mode should include the following replicator flags: --backfillFromSCN 26685444 --scn 26685786
+	~~~
+	</section>
+	{% endif %}
+
 	A `starting fetch` message indicates that the task has started:
 
 	<section class="filter-content" markdown="1" data-scope="postgres">
@@ -16,7 +27,7 @@
 
 	<section class="filter-content" markdown="1" data-scope="oracle">
 	~~~ json
-	{"level":"info","type":"summary","num_tables":3,"cdc_cursor":"2358840","time":"2025-02-10T14:28:11-05:00","message":"starting fetch"}
+	{"level":"info","type":"summary","num_tables":3,"cdc_cursor":"26685786","time":"2025-02-10T14:28:11-05:00","message":"starting fetch"}
 	~~~
 	</section>
 
@@ -68,7 +79,7 @@
 	~~~
 
 	{% if page.name != "migrate-bulk-load.md" %}
-	This message includes a `cdc_cursor` value. You must set the `--defaultGTIDSet` replication flag to this value when starting [`replication-only` mode](#replicate-changes-to-cockroachdb):
+	This message includes a `cdc_cursor` value. You must set the `--defaultGTIDSet` replication flag to this value when [starting Replicator](#start-replicator):
 
 	{% include_cached copy-clipboard.html %}
 	~~~ 
@@ -81,15 +92,4 @@
 	~~~ json
 	{"level":"info","type":"summary","fetch_id":"f5cb422f-4bb4-4bbd-b2ae-08c4d00d1e7c","num_tables":3,"tables":["migration_schema.employees","migration_schema.payments","migration_schema.payments"],"cdc_cursor":"2358840","net_duration_ms":6752.847625,"net_duration":"000h 00m 06s","time":"2024-03-18T12:30:37-04:00","message":"fetch complete"}
 	~~~
-	</section>
-
-	{% if page.name == "migrate-data-load-replicate-only.md" %}
-	<section class="filter-content" markdown="1" data-scope="oracle">
-	The following message shows the appropriate values for the `--backfillFromSCN` and `--scn` replication flags to use when [starting`replication-only` mode](#replicate-changes-to-cockroachdb):
-
-	{% include_cached copy-clipboard.html %}
-	~~~ 
-	replication-only mode should include the following replicator flags: --backfillFromSCN 26685444 --scn 26685786
-	~~~
-	</section>
-	{% endif %}
+	</section>

src/current/_includes/molt/fetch-metrics.md

@@ -1,3 +1,5 @@
+### Fetch metrics
+
 By default, MOLT Fetch exports [Prometheus](https://prometheus.io/) metrics at `http://127.0.0.1:3030/metrics`. You can override the address with `--metrics-listen-addr '{host}:{port}'`, where the endpoint will be `http://{host}:{port}/metrics`.
 
 Cockroach Labs recommends monitoring the following metrics during data load:

src/current/_includes/molt/fetch-replication-output.md

@@ -19,8 +19,8 @@
 	DEBUG  [Jan 22 13:52:40] upserted rows                                 conflicts=0 duration=7.620208ms proposed=1 target="\"molt\".\"migration_schema\".\"employees\"" upserted=1
 	~~~
 
-	{% if page.name != "migrate-replicate-only.md" %}
+	{% if page.name != "migrate-resume-replication.md" %}
 	{{site.data.alerts.callout_success}}
-	If replication is interrupted, you can [resume replication]({% link molt/migrate-replicate-only.md %}).
+	If replication is interrupted, you can [resume replication]({% link molt/migrate-resume-replication.md %}).
 	{{site.data.alerts.end}}
 	{% endif %}

src/current/_includes/molt/fetch-replicator-flags.md

@@ -34,8 +34,8 @@ api.configureSource("defaultdb.migration_schema", {
 });
 ~~~
 
-Pass the userscript to MOLT Fetch with the `--userscript` [replication flag](#replication-flags):
+Pass the userscript to MOLT Replicator with the `--userscript` [flag](#replication-flags):
 
 ~~~
---replicator-flags "--userscript table_filter.ts"
+--userscript table_filter.ts
 ~~~