Rollback

Rollback allows you to revert an actively running migration job and restore the pre-migration state. The rollback process creates a new job that replicates data in the reverse direction, from the original destination back to the original source. The suite evaluates rollback eligibility per tool type: Cluster Link (bidirectional), MirrorMaker 2, and Replicator each have their own rollback behavior.

Replicator Rollback

Replicator rollback operates at the topic level. It creates a new rollback job with the source and destination clusters swapped.

Availability

The rollback option becomes available in the Monitor tab when the suite determines that the job has reached cutover readiness.

Rollback Process

1. Navigate to the Monitor tab of the running Replicator job.
2. Click Rollback on the topics you want to revert.
3. A confirmation popup displays the rollback direction and the topics that will be included.
4. Confirm to create the rollback job.

Behavior

• A new migration job is created with the source and destination clusters swapped.
• If a rollback job already exists for this migration, the selected topics are added to the existing rollback job rather than creating a new one.
• Topics can be returned to the original migration job later by removing them from the rollback job.

Cluster Linking Rollback

Cluster Linking rollback provides more comprehensive reversal capabilities, but requires that Include Data Rollback Support was selected during job creation in the Core Configuration step.

Availability

Rollback is available for Cluster Linking jobs in the Running or Stopped state. You can roll back the entire job or select specific topics.

Rollback Process

1. Open the migration job detail view.
2. Click Rollback.
3. Select whether to roll back the entire job or specific topics and consumer groups.
4. A confirmation popup displays the rollback scope.
5. Confirm to proceed. A success banner is displayed upon completion.

Behavior

• A new job is created with an inverted configuration, named rollback-<original job name>.
• The rollback job replicates data from the original destination back to the original source.
• In the rollback job, removing a topic or consumer group returns it to the main migration job.
• Removing all topics and consumer groups from the rollback job automatically deletes it.

MirrorMaker 2 Rollback

MirrorMaker 2 rollback operates similarly to Replicator rollback at the topic level. It creates a new rollback job with the source and destination clusters swapped.

Availability

The rollback option becomes available in the Monitor tab when the suite determines that the MM2 job has reached cutover readiness.

Rollback Process

1. Navigate to the Monitor tab of the running MirrorMaker 2 job.
2. Click Rollback on the topics you want to revert.
3. A confirmation popup displays the rollback direction and the topics that will be included.
4. Confirm to create the rollback job.

Behavior

• A new migration job is created with the source and destination clusters swapped.
• If a rollback job already exists for this migration, the selected topics are added to the existing rollback job rather than creating a new one.
• Topics can be returned to the original migration job later by removing them from the rollback job.

Tip

The suite supports rollback for Cluster Link (full bidirectional rollback), MirrorMaker 2 (topic-level reversal), and Replicator (topic-level reversal). WarpStream Orbit does not support automated rollback.