diff --git a/modules/sideloader/pages/migrate-sideloader.adoc b/modules/sideloader/pages/migrate-sideloader.adoc index 8a402900..4deec95b 100644 --- a/modules/sideloader/pages/migrate-sideloader.adoc +++ b/modules/sideloader/pages/migrate-sideloader.adoc @@ -672,7 +672,8 @@ Microsoft Azure:: For example, `/var/lib/cassandra/data/`. * *`SNAPSHOT_NAME`*: The name of the xref:sideloader:migrate-sideloader.adoc#create-snapshots[snapshot backup] that you created with `nodetool snapshot`. * *`MIGRATION_DIR`*: The entire `uploadBucketDir` value that was generated when you xref:sideloader:migrate-sideloader.adoc#initialize-migration[initialized the migration], including the trailing slash. -* *`NODE_NAME`*: The host name of the current node you are uploading the snapshot from. +* *`NODE_NAME`*: The host name of the node that your snapshots are from. +It is important to use the specific node name to ensure that each node has a unique directory in the migration bucket. + [source,bash,subs="+quotes"] @@ -720,20 +721,20 @@ After uploading snapshots, you must xref:sideloader:migrate-sideloader.adoc#impo === Idle migration directories are evicted -As an added security measure, migrations that remain continuously idle for one week are subject to xref:sideloader:cleanup-sideloader.adoc[automatic cleanup], which deletes all associated snapshots, revokes any unexpired upload credentials, and then closes the migration. - -{company} recommends that you xref:sideloader:cleanup-sideloader.adoc#reschedule-a-cleanup[manually reschedule the cleanup] if you don't plan to launch the migration within one week or if you need several days to upload snapshots or import data. - [WARNING] ==== For large migrations, it can take several days to upload snapshots and import data. Make sure you xref:sideloader:cleanup-sideloader.adoc#reschedule-a-cleanup[manually reschedule the cleanup] to avoid automatic cleanup. ==== +As an added security measure, migrations that remain continuously idle for one week are subject to xref:sideloader:cleanup-sideloader.adoc[automatic cleanup], which deletes all associated snapshots, revokes any unexpired upload credentials, and then closes the migration. + +{company} recommends that you xref:sideloader:cleanup-sideloader.adoc#reschedule-a-cleanup[manually reschedule the cleanup] if you don't plan to launch the migration within one week or if you need several days to upload snapshots or import data. + [#import-data] == Import data -After you upload snapshots for each origin node, import the data into your target database. +After you completely upload snapshots for each origin node, import the data into your target database. Data import is a multi-step operation that requires complete success. If one step fails, then the entire import operation stops and the migration fails. @@ -745,10 +746,12 @@ If one step fails, then the entire import operation stops and the migration fail include::sideloader:partial$sideloader-partials.adoc[tags=import] ====== -[TIP] +[WARNING] ==== -If necessary, you can xref:sideloader:stop-restart-sideloader.adoc[pause or abort the migration] during the import process. +* Before you start the import process, make sure all snapshots are completely uploaded. +For commands to monitor upload progress and compare uploaded data against the original snapshots, see xref:sideloader:migrate-sideloader.adoc#upload-snapshots-to-migration-directory[Upload snapshots to the migration directory]. +* If necessary, you can xref:sideloader:stop-restart-sideloader.adoc[pause or abort the migration] during the import process. include::sideloader:partial$sideloader-partials.adoc[tags=no-return] ==== diff --git a/modules/sideloader/partials/sideloader-partials.adoc b/modules/sideloader/partials/sideloader-partials.adoc index 14c5ca96..9fdfcdaa 100644 --- a/modules/sideloader/partials/sideloader-partials.adoc +++ b/modules/sideloader/partials/sideloader-partials.adoc @@ -18,7 +18,8 @@ For example, `/var/lib/cassandra/data`. * *`KEYSPACE_NAME`*: The name of the keyspace that contains the tables you want to migrate. * *`SNAPSHOT_NAME`*: The name of the xref:sideloader:migrate-sideloader.adoc#create-snapshots[snapshot backup] that you created with `nodetool snapshot`. * *`MIGRATION_DIR`*: The entire `uploadBucketDir` value that was generated when you xref:sideloader:migrate-sideloader.adoc#initialize-migration[initialized the migration], including the trailing slash. -* *`NODE_NAME`*: The host name of the current node you are uploading the snapshot from. +* *`NODE_NAME`*: The host name of the node that your snapshots are from. +It is important to use the specific node name to ensure that each node has a unique directory in the migration bucket. // end::command-placeholders-common[] // tag::validate[]