You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: modules/ROOT/pages/contributions.adoc
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,14 +12,14 @@ Code contributions for those additional components are not open for PRs at this
12
12
13
13
== {zdm-proxy} License
14
14
15
-
{zdm-proxy} is licensed under the open-source https://github.com/datastax/zdm-proxy/blob/main/LICENSE[**Apache-2.0 license agreement**, window="_blank"].
15
+
{zdm-proxy} is licensed under the open-source https://github.com/datastax/zdm-proxy/blob/main/LICENSE[**Apache-2.0 license agreement**].
16
16
17
17
== Contributor License Agreement
18
18
19
-
Acceptance of the {company} https://cla.datastax.com/[Contributor License Agreement, window="_blank"] (CLA) is required before we can consider accepting your {zdm-proxy} code contribution.
20
-
Refer to the https://cla.datastax.com/[CLA terms, window="_blank"] and, if you agree, indicate your acceptance on each Pull Request (PR) that you submit while using the https://github.com/datastax/zdm-proxy[{zdm-proxy} GitHub repository, window="_blank"].
19
+
Acceptance of the {company} https://cla.datastax.com/[Contributor License Agreement] (CLA) is required before we can consider accepting your {zdm-proxy} code contribution.
20
+
Refer to the https://cla.datastax.com/[CLA terms] and, if you agree, indicate your acceptance on each Pull Request (PR) that you submit while using the https://github.com/datastax/zdm-proxy[{zdm-proxy} GitHub repository].
21
21
22
-
// You will see the CLA listed on the standard pull request checklist (TBS)
22
+
// You will see the CLA listed on the standard pull request checklist (TBS)
23
23
// for the https://github.com/datastax/zdm-proxy[{zdm-proxy}] repository.
Copy file name to clipboardExpand all lines: modules/ROOT/pages/create-target.adoc
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,9 +33,9 @@ To use a generic Cassandra or DSE cluster, you will have to:
33
33
=== Create an {astra-db-serverless} cluster
34
34
35
35
Log into the Astra Portal and create a serverless Astra DB database.
36
-
You can start with a Free plan, but consider upgrading during your migration project to an Astra DB Pay As You Go (PAYG) or Enterprise plan, to take advantage of additional functionality -- such as Exporting Metrics to external third-party applications, Bring Your Own Keys, and other features.
36
+
You can start with a Free plan, but consider upgrading during your migration project to an Astra DB Pay As You Go or Enterprise plan, to take advantage of additional functionality -- such as Exporting Metrics to external third-party applications, Bring Your Own Keys, and other features.
37
37
38
-
The PAYG and Enterprise plans have many benefits over the Free plan, such as the ability to lift rate limiting, and avoiding hibernation timeouts.
38
+
The Pay As You Go and Enterprise plans have many benefits over the Free plan, such as the ability to lift rate limiting, and avoiding hibernation timeouts.
39
39
40
40
Assign your preferred values for the serverless database:
* Optionally install https://docs.datastax.com/en/dsbulk/docs/installing/install.html[DSBulk Loader, window="_blank"], if you elect to reference your own external installation of DSBulk, instead of the embedded DSBulk that's in {dsbulk-migrator}.
10
+
* Optionally install https://docs.datastax.com/en/dsbulk/docs/installing/install.html[DSBulk Loader], if you elect to reference your own external installation of DSBulk, instead of the embedded DSBulk that's in {dsbulk-migrator}.
11
11
* Install https://github.com/datastax/simulacron#prerequisites[Simulacron] 0.12.x and its prerequisites, for integration tests.
Copy file name to clipboardExpand all lines: modules/ROOT/pages/feasibility-checklists.adoc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -243,4 +243,4 @@ The default retry policy retries all requests in case of a connection error *reg
243
243
244
244
Prior to version 2.5.0, this driver did *NOT* retry any requests after they have been written to the socket, it was up to the client application to handle these and retry them if they are suitable for a retry.
245
245
246
-
With the release of 2.5.0, the driver retries requests that are set as `idempotent`. See this C++ 2.x https://docs.datastax.com/en/developer/cpp-driver/2.16/topics/configuration/#query-idempotence[query idempotence documentation section, window="_blank"].
246
+
With the release of 2.5.0, the driver retries requests that are set as `idempotent`. See this C++ 2.x https://docs.datastax.com/en/developer/cpp-driver/2.16/topics/configuration/#query-idempotence[query idempotence documentation section].
Copy file name to clipboardExpand all lines: modules/ROOT/pages/migrate-and-validate-data.adoc
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,9 +38,9 @@ A number of helpful assets are provided in each repo.
38
38
39
39
In particular, the CDM repo provides two configuration templates, with embedded comments and default values, which you can customize to match your data migration's requirements:
40
40
41
-
* https://github.com/datastax/cassandra-data-migrator/blob/main/src/resources/cdm.properties[cdm.properties, window="_blank"] provides a subset of configuration options with commonly required settings.
41
+
* https://github.com/datastax/cassandra-data-migrator/blob/main/src/resources/cdm.properties[cdm.properties] provides a subset of configuration options with commonly required settings.
42
42
43
-
* https://github.com/datastax/cassandra-data-migrator/blob/main/src/resources/cdm-detailed.properties[cdm-detailed.properties, window="_blank"] with all available options.
43
+
* https://github.com/datastax/cassandra-data-migrator/blob/main/src/resources/cdm-detailed.properties[cdm-detailed.properties] with all available options.
44
44
45
45
[[cstar-data-migrator-key-features]]
46
46
== {cstar-data-migrator} features
@@ -61,7 +61,7 @@ The CDM capabilities are extensive:
61
61
* Validate migration accuracy and performance using a smaller randomized data-set.
62
62
* Support for adding custom fixed writetime.
63
63
64
-
With new or enhanced capabilities in recent https://github.com/datastax/cassandra-data-migrator/packages/1832128[CDM v4.x releases, window="_blank"].
64
+
With new or enhanced capabilities in recent https://github.com/datastax/cassandra-data-migrator/packages/1832128[CDM v4.x releases].
65
65
66
66
* Column names can differ between Origin and Target.
67
67
* UDTs can be migrated from Origin to Target, even when the keyspace names differ.
Copy file name to clipboardExpand all lines: modules/ROOT/pages/release-notes.adoc
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -53,9 +53,9 @@ You can tune the heartbeat interval with the Ansible configuration variable `hea
53
53
54
54
DataStax strongly recommends that you use version 2.1.0 (or newer) to benefit from this improvement, especially if you have a read-only workload.
55
55
56
-
To verify which {zdm-proxy} version you're running, see this xref:troubleshooting-tips.adoc#_how_to_identify_the_zdm_proxy_version[topic, window="_blank"].
56
+
To verify which {zdm-proxy} version you're running, see this xref:troubleshooting-tips.adoc#_how_to_identify_the_zdm_proxy_version[topic].
57
57
58
-
To find out how to upgrade an existing {zdm-proxy} deployment, see xref:manage-proxy-instances.adoc#_upgrade_the_proxy_version[Upgrade the proxy version, window="_blank"].
58
+
To find out how to upgrade an existing {zdm-proxy} deployment, see xref:manage-proxy-instances.adoc#_upgrade_the_proxy_version[Upgrade the proxy version].
59
59
60
60
=== {zdm-proxy} 2.1.0 changes
61
61
@@ -69,16 +69,16 @@ For the latest information about {zdm-proxy} new features and other changes, ple
69
69
70
70
The following topics have been updated for the 2.1.0 release:
71
71
72
-
* xref:feasibility-checklists.adoc#_read_only_applications[Feasibility checks for read-only applications, window="_blank"].
72
+
* xref:feasibility-checklists.adoc#_read_only_applications[Feasibility checks for read-only applications].
73
73
See the notes indicating that this issue is solved by the {zdm-proxy} 2.1.0 release.
74
74
75
-
* xref:manage-proxy-instances.adoc#change-mutable-config-variable[Change a mutable configuration variable, window="_blank"].
75
+
* xref:manage-proxy-instances.adoc#change-mutable-config-variable[Change a mutable configuration variable].
76
76
See the `heartbeat_interval_ms` and `zdm-proxy_max_stream_ids` information.
Copy file name to clipboardExpand all lines: modules/ROOT/pages/troubleshooting-scenarios.adoc
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -61,8 +61,8 @@ If you are using spring boot and/or spring-data-cassandra then an upgrade of the
61
61
Alternatively, you can force the protocol version on the driver to the max supported version by both clusters.
62
62
V4 is a good recommendation that usually fits all but if the user is migrating from DSE to DSE then DSE_V1 should be used for DSE 5.x and DSE_V2 should be used for DSE 6.x.
63
63
64
-
To force the protocol version on the Java driver, check this section of the https://docs.datastax.com/en/developer/java-driver/3.11/manual/native_protocol/#controlling-the-protocol-version[driver manual, window="_blank"].
65
-
We don't believe this issue affects Java driver 3.x, but here are the https://docs.datastax.com/en/developer/java-driver/3.11/manual/native_protocol/#controlling-the-protocol-version[instructions, window="_blank"] on how to force the version on 3.x, if necessary.
64
+
To force the protocol version on the Java driver, check this section of the https://docs.datastax.com/en/developer/java-driver/3.11/manual/native_protocol/#controlling-the-protocol-version[driver manual].
65
+
We don't believe this issue affects Java driver 3.x, but here are the https://docs.datastax.com/en/developer/java-driver/3.11/manual/native_protocol/#controlling-the-protocol-version[instructions] on how to force the version on 3.x, if necessary.
66
66
67
67
== Protocol errors in the proxy logs but clients can connect successfully
68
68
@@ -238,7 +238,7 @@ The driver might also have it enabled for Astra DB depending on what server vers
238
238
=== Solution or Workaround
239
239
240
240
These log messages are harmless but if your need to get rid of them, you can disable the DSE Insights driver feature through the driver configuration.
241
-
Refer to https://github.com/datastax/java-driver/blob/65d2c19c401175dcc6c370560dd5f783d05b05b9/core/src/main/resources/reference.conf#L1328[this property, window="_blank"] for Java driver 4.x.
241
+
Refer to https://github.com/datastax/java-driver/blob/65d2c19c401175dcc6c370560dd5f783d05b05b9/core/src/main/resources/reference.conf#L1328[this property] for Java driver 4.x.
242
242
243
243
244
244
@@ -344,7 +344,7 @@ The Astra DevOps API is likely temporarily unavailable.
344
344
=== Solution or Workaround
345
345
346
346
Download the Astra DB Secure Connect Bundle (SCB) manually and provide its path to the {zdm-automation} as explained xref:deploy-proxy-monitoring.adoc#_core_configuration[here].
347
-
For information about the SCB, see https://docs.datastax.com/en/astra-serverless/docs/connect/secure-connect-bundle.html[working with Secure Connect Bundle, window="_blank"].
347
+
For information about the SCB, see https://docs.datastax.com/en/astra-serverless/docs/connect/secure-connect-bundle.html[working with Secure Connect Bundle].
348
348
349
349
== Metadata service (Astra) returned not successful status code 4xx or 5xx
350
350
@@ -372,7 +372,7 @@ If it is `Hibernated`, click the “Resume” button and wait for it to become `
372
372
If it is `Active` already, then it is likely an issue with permissions.
373
373
374
374
We recommend starting with a token that has the Database Administrator role in Astra DB to confirm that it is a permissions issue.
375
-
Refer to https://docs.datastax.com/en/astra/astra-db-vector/administration/manage-database-access.html[Manage user permissions, window="_blank"].
375
+
Refer to https://docs.datastax.com/en/astra/astra-db-vector/administration/manage-database-access.html[Manage user permissions].
376
376
377
377
[[_async_read_timeouts_stream_id_map_exhausted]]
378
378
== Async read timeouts / stream id map exhausted
@@ -407,7 +407,7 @@ Starting in version 2.1.0, you can now tune the maximum number of stream ids ava
407
407
You can increase it to match your driver configuration through the xref:manage-proxy-instances.adoc#zdm_proxy_max_stream_ids[zdm_proxy_max_stream_ids] property.
408
408
409
409
If these errors are being constantly written to the log files (for minutes or even hours) then it is likely that only an application OR {zdm-proxy} restart will fix it.
410
-
If you find an issue like this please submit an https://github.com/datastax/zdm-proxy/issues[Issue, window="_blank"] in our GitHub repo.
410
+
If you find an issue like this please submit an https://github.com/datastax/zdm-proxy/issues[Issue] in our GitHub repo.
411
411
412
412
== Client application closed connection errors every 10 minutes when migrating to Astra DB
Copy file name to clipboardExpand all lines: modules/ROOT/partials/interactive-lab.adoc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ We've built a complementary learning resource that is a companion to this compre
8
8
9
9
[NOTE]
10
10
====
11
-
To run the lab, all major browsers are supported, except Safari. For more, see the lab's https://www.datastax.com/dev/zdm[start page, window="_blank"].
11
+
To run the lab, all major browsers are supported, except Safari. For more, see the lab's https://www.datastax.com/dev/zdm[start page].
12
12
====
13
13
14
14
We encourage you to explore this free hands-on interactive lab from {company} Academy. It's an excellent, detailed view of the migration process. The lab describes and demonstrates all the steps and automation performed to prepare for, and complete, a migration from any Cassandra/DSE/{astra_db} database to another Cassandra/DSE/{astra_db} database across clusters.
0 commit comments