Manual Migration of Systems Without NVMe Boot Support

Some hardware vendors do not support booting from NVMe drives where the /ws/ddb/iso path resides. In such cases, NVMe drives do not appear in the BIOS boot order menu. A manual mode migration is required.

Before You Begin

• Ensure the latest HyperScale X image is available.

• Access to the IPMI console for each node.

Procedure

1. Prepare the ISO.

   1. Copy the latest HyperScale X image to the /ws/ddb/iso directory on the Remote Cache Node.

   2. Using the IPMI console, attach a separate copy of the ISO to each 2.x node that requires an upgrade.

2. Configure BIOS boot settings.

   1. Edit the BIOS boot settings for each node to boot from the attached DVD.

      Do not reboot the node at this point.

   2. Exit the IPMI settings.

      Alternatively, as each node auto-reboots, enter the boot menu and manually select the DVD as the boot device.

3. From the Remote Cache Node, run the following command:

   cd /opt/commvault/MediaAgent
   
   ./cvmanager.py -t Migrate_Cluster manual_iso=True
   

4. When prompted during the upgrade process, follow these steps:

   1. Open IPMI console on the node node1.company.com and keep it active throughout the migration.

      Press 'y' to proceed (y|n): y

   2. Attach the migration ISO:

      /ws/ddb/cvmanager/share/dvd_02132025_084957.iso via IPMI console.

      Press 'y' to proceed (y|n): y

   3. Update the BIOS boot order to boot from the ISO.

      Do NOT reboot the node at this point.

      Press 'y' to proceed (y|n): y

   4. The upgrade will sequentially update the OS and reboot each node.

      Note

      This process may take several hours to complete.

5. To verify the migration success, run the following command:

   commvault reg | grep MigrationCompleted
   

   Expected output:

   sRHELToRockyMigrationCompleted yes

6. If the upgrade fails after authentication:

   1. Retrieve the last task:

      /opt/commvault/MediaAgent/cvmanager.py --unfinished_task_check Migrate_Cluster

      This will generate a .yaml file, for example:

      /ws/ddb/cvmanager/catalog/status/Task_6554744226181603181/cvmanager_jJV8X7.yaml

   2. Resume the upgrade using the YAML file:

      /opt/commvault/MediaAgent/cvmanager.py <filepath.yaml>

      You do not need to re-verify the upgrade criteria before resuming.