Skip to content

Commit 3521d6f

Browse files
bsanchez-the-roachbsanchez-the-roach
committed
Migration docs restructure
1 parent 0a706c5 commit 3521d6f

26 files changed

+3242
-1018
lines changed

‎src/current/_includes/molt/molt-docker.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
MOLT Fetch, Verify, and Replicator are likely to run more slowly in a Docker container than on a local machine. To improve performance, increase the memory or compute resources, or both, on your Docker container.
44

5-
{% if page.name == "molt-fetch.md" %}
5+
{% if page.name == "molt-fetch.md" or page.name == "molt-fetch-install.md" %}
66
#### Authentication
77

88
When using MOLT Fetch with [cloud storage](#bucket-path), it is necessary to specify volumes and environment variables, as described in the following sections for [Google Cloud Storage](#google-cloud-storage) and [Amazon S3](#amazon-s3).

‎src/current/_includes/molt/molt-drop-constraints-indexes.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
To optimize data load performance, drop all non-`PRIMARY KEY` [constraints]({% link {{ site.current_cloud_version }}/alter-table.md %}#drop-constraint) and [indexes]({% link {{site.current_cloud_version}}/drop-index.md %}) on the target CockroachDB database before migrating:
2-
{% if page.name == "molt-fetch.md" %}
2+
{% if page.name == "molt-fetch.md" or page.name == "molt-fetch-best-practices.md" %}
33
- [`FOREIGN KEY`]({% link {{ site.current_cloud_version }}/foreign-key.md %})
44
- [`UNIQUE`]({% link {{ site.current_cloud_version }}/unique.md %})
55
- [Secondary indexes]({% link {{ site.current_cloud_version }}/schema-design-indexes.md %})

‎src/current/_includes/molt/molt-install.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ To display the current version of each binary, run `molt --version` and `replica
2222

2323
For previous binaries, refer to the [MOLT version manifest](https://molt.cockroachdb.com/molt/cli/versions.html). {% if page.name != "molt.md" %}For release details, refer to the [MOLT changelog]({% link releases/molt.md %}).{% endif %}
2424

25-
{% if page.name == "molt-fetch.md" or page.name == "molt.md" %}
25+
{% if page.name == "molt-fetch.md" or page.name == "molt.md" or page.name == "molt-fetch-install" %}
2626
{{site.data.alerts.callout_info}}
2727
MOLT Fetch is supported on Red Hat Enterprise Linux (RHEL) 9 and above.
2828
{{site.data.alerts.end}}
@@ -55,7 +55,7 @@ docker pull cockroachdb/molt:oracle-latest
5555
~~~
5656
{% endif %}
5757

58-
{% if page.name != "molt-fetch.md" %}
58+
{% if page.name != "molt-fetch.md" and page.name != "molt-fetch-install.md" %}
5959
#### MOLT Replicator
6060

6161
[Docker images for MOLT Replicator](https://hub.docker.com/r/cockroachdb/replicator/tags) are also available as a standalone binary:

‎src/current/_includes/sidebar-data-v25.4.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@
1111
{% include_cached v25.4/sidebar-data/feature-overview.json %},
1212
{% include_cached v25.4/sidebar-data/resilience.json %},
1313
{% include_cached v25.4/sidebar-data/connect-to-cockroachdb.json %},
14+
{% include_cached v25.4/sidebar-data/migrate-new.json %},
1415
{% include_cached v25.4/sidebar-data/migrate.json %},
1516
{% include_cached v25.4/sidebar-data/cloud-deployments.json %},
1617
{% include_cached v25.4/sidebar-data/self-hosted-deployments.json %},

‎src/current/_includes/v25.4/sidebar-data/migrate-new.json‎

Lines changed: 234 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,234 @@
1+
{
2+
"title": "Migrate NEW",
3+
"is_top_level": true,
4+
"items": [
5+
{
6+
"title": "Overview",
7+
"urls": [
8+
"/molt/migration-overview.html"
9+
]
10+
},
11+
{
12+
"title": "Migration Considerations",
13+
"items": [
14+
{
15+
"title": "Overview",
16+
"urls": [
17+
"/molt/migration-considerations.html"
18+
]
19+
},
20+
{
21+
"title": "Migration Granularity",
22+
"urls": [
23+
"/molt/migration-considerations-phases.html"
24+
]
25+
},
26+
{
27+
"title": "Continuous Replication",
28+
"urls": [
29+
"/molt/migration-considerations-replication.html"
30+
]
31+
},
32+
{
33+
"title": "Data Transformation Strategy",
34+
"urls": [
35+
"/molt/migration-considerations-transformation.html"
36+
]
37+
},
38+
{
39+
"title": "Validation Strategy",
40+
"urls": [
41+
"/molt/migration-considerations-validation.html"
42+
]
43+
},
44+
{
45+
"title": "Rollback Plan",
46+
"urls": [
47+
"/molt/migration-considerations-rollback.html"
48+
]
49+
},
50+
{
51+
"title": "Cutover Plan",
52+
"urls": [
53+
"/molt/migration-considerations-cutover.html"
54+
]
55+
}
56+
]
57+
},
58+
{
59+
"title": "MOLT Tools",
60+
"items": [
61+
{
62+
"title": "Schema Conversion Tool",
63+
"urls": [
64+
"/cockroachcloud/migrations-page.html"
65+
]
66+
},
67+
{
68+
"title": "Fetch",
69+
"items": [
70+
{
71+
"title": "Overview",
72+
"urls": [
73+
"/molt/molt-fetch-overview.html"
74+
]
75+
},
76+
{
77+
"title": "Install MOLT Fetch",
78+
"urls": [
79+
"/molt/molt-fetch-install.html"
80+
]
81+
},
82+
{
83+
"title": "Global Flags",
84+
"urls": [
85+
"/molt/molt-fetch-flags.html"
86+
]
87+
},
88+
{
89+
"title": "Use MOLT Fetch",
90+
"urls": [
91+
"/molt/molt-fetch-usage.html"
92+
]
93+
},
94+
{
95+
"title": "Monitoring",
96+
"urls": [
97+
"/molt/molt-fetch-monitoring.html"
98+
]
99+
},
100+
{
101+
"title": "Best Practices",
102+
"urls": [
103+
"/molt/molt-fetch-best-practices.html"
104+
]
105+
},
106+
{
107+
"title": "Troubleshooting",
108+
"urls": [
109+
"/molt/molt-fetch-troubleshooting.html"
110+
]
111+
}
112+
]
113+
},
114+
{
115+
"title": "Replicator",
116+
"urls": [
117+
"/molt/molt-replicator.html"
118+
]
119+
},
120+
{
121+
"title": "Verify",
122+
"urls": [
123+
"/molt/molt-verify.html"
124+
]
125+
}
126+
]
127+
},
128+
{
129+
"title": "Migration Walkthroughs",
130+
"items": [
131+
{
132+
"title": "Migration with Downtime",
133+
"urls": [
134+
"/molt/migrate-bulk-load.html"
135+
]
136+
},
137+
{
138+
"title": "Near-zero Downtime Migration",
139+
"urls": [
140+
"/molt/migrate-load-replicate.html"
141+
]
142+
},
143+
{
144+
"title": "Near-zero Downtime Migration with Failback",
145+
"urls": [
146+
"/molt/migrate-failback.html"
147+
]
148+
}
149+
]
150+
},
151+
{
152+
"title": "Third-Party Migration Tools",
153+
"items": [
154+
{
155+
"title": "AWS DMS",
156+
"urls": [
157+
"/${VERSION}/aws-dms.html"
158+
]
159+
},
160+
{
161+
"title": "Qlik Replicate",
162+
"urls": [
163+
"/${VERSION}/qlik.html"
164+
]
165+
},
166+
{
167+
"title": "Striim",
168+
"urls": [
169+
"/${VERSION}/striim.html"
170+
]
171+
},
172+
{
173+
"title": "Oracle GoldenGate",
174+
"urls": [
175+
"/${VERSION}/goldengate.html"
176+
]
177+
},
178+
{
179+
"title": "Debezium",
180+
"urls": [
181+
"/${VERSION}/debezium.html"
182+
]
183+
}
184+
]
185+
},
186+
{
187+
"title": "Migrate Data Types",
188+
"items": [
189+
{
190+
"title": "Migrate from CSV",
191+
"urls": [
192+
"/${VERSION}/migrate-from-csv.html"
193+
]
194+
},
195+
{
196+
"title": "Migrate from Avro",
197+
"urls": [
198+
"/${VERSION}/migrate-from-avro.html"
199+
]
200+
},
201+
{
202+
"title": "Migrate from Shapefiles",
203+
"urls": [
204+
"/${VERSION}/migrate-from-shapefiles.html"
205+
]
206+
},
207+
{
208+
"title": "Migrate from OpenStreetMap",
209+
"urls": [
210+
"/${VERSION}/migrate-from-openstreetmap.html"
211+
]
212+
},
213+
{
214+
"title": "Migrate from GeoJSON",
215+
"urls": [
216+
"/${VERSION}/migrate-from-geojson.html"
217+
]
218+
},
219+
{
220+
"title": "Migrate from GeoPackage",
221+
"urls": [
222+
"/${VERSION}/migrate-from-geopackage.html"
223+
]
224+
},
225+
{
226+
"title": "Import Performance Best Practices",
227+
"urls": [
228+
"/${VERSION}/import-performance-best-practices.html"
229+
]
230+
}
231+
]
232+
}
233+
]
234+
}

‎src/current/_includes/v25.4/sidebar-data/migrate.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"title": "Migrate",
2+
"title": "Migrate OLD",
33
"is_top_level": true,
44
"items": [
55
{

0 commit comments

Comments
 (0)