Document navigation

Upgrade the Migration Service

Before you begin

  • Ensure that no migration tasks are in progress. Otherwise, you cannot upgrade the migration service.
  • Ensure that the image storage has sufficient storage space before you upload the migration service upgrade package.
  • Prepare an upgrade package with a version higher than the current service version, in .tar.gz format.

Procedure

  1. In the navigation pane, select O&M Management > Migration Service > Migration Overview.
  2. On the Migration Overview page, click Upgrade.
  3. In the Upgrade Migration Service dialog, configure the following options:
    Option Description
    Migration Service Version Displays the currently deployed service version.
    Upload By Select the method for uploading the installation package, including URL and local upload. Interrupted local uploads can be resumed.
    Note:
    • The system automatically retries recoverable upload errors. If an upload is paused due to a network interruption and the page remains open, the upload resumes automatically after the network recovers.
    • If the browser retains permission to access the original local file after the page is refreshed or you sign in again, the system automatically resumes an upload that was paused due to an error. If the browser prompts you to allow access to previously selected files or folders, grant access as needed.
    • If the browser does not have permission to access the file or the permission has expired, the upload cannot resume automatically. Click Pending Uploads at the top of the page. In the Pending Upload Tasks panel, locate the task, click Select to Continue, and reselect the same local file.
    • A manually paused task does not resume automatically. In the task details, click Continue.
    • If the local file has been modified, moved, or deleted, the original upload task cannot resume. Start a new upload.
    • If an upload error occurs, the platform automatically retries the upload up to five times. If all five retry attempts fail, the upload task enters the Failed state and cannot be resumed. Start a new upload.
    • Click View Upload History to view local file upload tasks.
    URL / Installation Package Enter a URL or upload the installation package file.
    Storage Path Specify a directory path to store the uploaded upgrade package and its decompressed files.
    Note:
    • Ensure that the directory has sufficient available space. Otherwise, the installation fails.
    • Do not use system directories such as /, /dev, /proc, /sys, /usr/bin, /bin, or /opt. Using these directories might cause server issues.
  4. Click OK.

What to do next

Check the upgrade status on Migration Overview. If the upgrade fails, click Reupgrade:

  • If the package was uploaded successfully but upgrade execution failed, select Use Existing Upgrade Package or Reupload Upgrade Package under Upgrade Method.
  • If the upgrade package upload failed, upload the package again.

Review the configuration, click OK, and wait for the upgrade to finish.