Skip to content

Commit e4b19ec

Browse files
authored
remove 2i steps (#197)
1 parent f9e5705 commit e4b19ec

File tree

3 files changed

+4
-32
lines changed

3 files changed

+4
-32
lines changed

modules/sideloader/pages/migrate-sideloader.adoc

Lines changed: 1 addition & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -179,35 +179,7 @@ nodetool listsnapshots
179179
+
180180
Snapshots have a specific directory structure, such as `*KEYSPACE_NAME*/*TABLE_NAME*/snapshots/*SNAPSHOT_NAME*/...`.
181181
{sstable-sideloader} relies on this fixed structure to properly interpret the SSTable components.
182-
**With the exception of secondary index directories (as explained in the following step), don't modify the snapshot's directory structure.**
183-
184-
. If your origin cluster has xref:dse-5.1@cql:develop:indexing/2i/2i-concepts.adoc[secondary indexes (2i)], remove all directories related to those indexes from all snapshots before you xref:sideloader:migrate-sideloader.adoc#upload-snapshots-to-migration-directory[upload the snapshots].
185-
+
186-
[WARNING]
187-
====
188-
Secondary indexes defined in the origin cluster are ignored by {astra-db}, but they will cause the migration to fail.
189-
To avoid errors, you must remove all secondary index directories from your snapshots before you upload them.
190-
====
191-
+
192-
You can find secondary index directories in the table's snapshot directory:
193-
+
194-
[source,plaintext,subs="+quotes"]
195-
----
196-
**NODE_UUID**/**KEYSPACE_NAME**/**TABLE_NAME**-**TABLE_UUID**/snapshots/**SNAPSHOT_NAME**/.**INDEX_NAME**
197-
----
198-
+
199-
For example, given the following table schema, the index directory is found at `*NODE_UUID*/smart_home/sensor_readings-*TABLE_UUID*/snapshots/*SNAPSHOT_NAME*/.roomidx`:
200-
+
201-
[source,cql]
202-
----
203-
CREATE TABLE IF NOT EXISTS smart_home.sensor_readings (
204-
device_id UUID,
205-
room_id UUID,
206-
reading_type TEXT,
207-
PRIMARY KEY ((device_id))
208-
);
209-
CREATE INDEX IF NOT EXISTS roomidx ON smart_home.sensor_readings(room_id);
210-
----
182+
**Don't modify the snapshot's directory structure; this can cause your migration to fail.**
211183

212184
[#record-schema]
213185
== Configure the target database

modules/sideloader/pages/prepare-sideloader.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ If you choose the alternative option, you must modify the commands accordingly f
169169
If you have a mix of encrypted and unencrypted data, you can use {sstable-sideloader} to migrate the unencrypted data.
170170
After the initial migration, you can use another strategy to move the encrypted data, such as https://github.com/datastax/cassandra-data-migrator[{cass-short} Data Migrator (CDM)] or a manual export and reupload.
171171

172-
* *{sstable-sideloader} doesn't support secondary indexes*: If you don't remove or replace these in your origin cluster, then you must manually remove these directories from your snapshots, as explained in xref:sideloader:migrate-sideloader.adoc#create-snapshots[Create snapshots].
172+
* *{sstable-sideloader} doesn't support secondary indexes*: If you don't remove or replace these in your origin cluster, {sstable-sideloader} ignores these directories when importing the data to your {astra-db} database.
173173

174174
== Administration server requirements
175175

modules/sideloader/pages/troubleshoot-sideloader.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ The two most common errors are as follows:
3838
To resolve this error, you can <<relaunch,align the schemas and relaunch the migration>>.
3939

4040
* *Invalid data in migration directory*: The data uploaded to the migration directory is invalid or improperly formatted.
41-
Common causes include data corruption, incomplete upload due to a timeout, malformed file paths, and the presence of invalid data such as secondary index directories.
41+
Common causes include data corruption, incomplete upload due to a timeout, malformed file paths, and the presence of invalid data.
4242
+
4343
When this type of failure occurs, you must abandon the failed migration and restart the entire migration process.
4444
For more information, see <<restart>>.
@@ -79,7 +79,7 @@ When a migration fails due to a problem with the data uploaded to the migration
7979
This is because you can't change the data in the migration directory after you upload it.
8080
For example, if your snapshots contain corrupt data, you have to restart the migration with new snapshots and a new migration directory.
8181

82-
. Review the xref:sideloader:prepare-sideloader.adoc#origin-cluster-requirements[origin cluster requirements] to ensure that your snapshot doesn't contain invalid data, including materialized views, encrypted data, and secondary indexes.
82+
. Review the xref:sideloader:prepare-sideloader.adoc#origin-cluster-requirements[origin cluster requirements] to ensure that your snapshot doesn't contain invalid data, including materialized views and encrypted data.
8383

8484
. If necessary, xref:sideloader:migrate-sideloader.adoc#create-snapshots[create new snapshots] of any invalid snapshots.
8585
+

0 commit comments

Comments
 (0)