Skip to main content
NetApp Data Migrator

Upgrade the control plane and workers in NetApp Data Migrator

Contributors netapp-pcarriga netapp-mj39955
PDFs

You can upgrade a control plane, Linux worker, or Windows worker in NetApp Data Migrator.

Before you begin

  • Stop all job runs and make all jobs inactive.

  • Download the upgrade bundle (tar.gz file) from the NetApp Support Site and save it in your local directory.

  • Verify that the workers that are in use are online. Workers that are offline during an upgrade are not upgraded.

Step 1: Upload the upgrade bundle

Upload the upgrade bundle from your local directory.

Steps

  1. Log in to the NetApp Data Migrator UI, then navigate to the home page.

  2. Select the help icon in the top right corner.

  3. Select the Upgrade tab.

  4. Select Select file, then select the upgrade bundle tar.gz file.

  5. Select Upload after selecting the file.

    Wait for the message to appear that confirms that the upload and validation are complete.

  6. Optionally, start the process again by selecting Start Over to upload a different file.

Step 2: Upgrade the control plane and workers

Upgrade the control plane followed by the Linux worker or Windows worker.

Steps

  1. Select Upgrade. The system starts upgrading the control plane. This takes approximately five to ten minutes.

    During the upgrade, the UI might become temporarily unavailable because the application is restarting with the new version. Log back in to the UI when it becomes accessible again.

  2. After the upgrade completes, return to the Upgrade page.

  3. Verify that the upgrade status is Success.

  4. After a successful control plane upgrade, the worker upgrade starts automatically for all online workers.

    Note The online workers automatically install and restart with the new version. Offline workers are not upgraded.

  5. If a worker upgrade doesn't start automatically, use SSH to connect to the worker and start the upgrade:

    Linux worker
    sudo /opt/datamigrator/staging/<version>/upgrade.sh <version>
    Windows worker
    ExecutionPolicy Bypass -File C:\datamigrator\staging\<version>\upgrade.ps1 -Version <version>

Step 3: View logs and troubleshoot

View the virtual machine logs to support troubleshooting issues that you encounter during the upgrade.

Steps

  1. Connect to the control plane VM using SSH and run the following command to view logs:

    tail -f /upgrade/upgrade-<version>.log

  2. Connect to the Linux worker or Windows worker VM using SSH and view the logs by using the following path:

    Linux worker
    /opt/datamigrator/upgrade.log
    Windows worker
    C:\datamigrator\upgrade.log

  3. If the upgrade fails, the system automatically rolls back to the previous version and the UI shows the upgrade status as Failed.

    Review the Ansible logs, then contact NetApp support and attach the Ansible logs to your communication.