CDRouter Support

NTA1000 Rocky Linux migration procedure (online)

knowledge-base version 13.3

This article provides instructions for migrating your NTA1000 operating system from CentOS to Rocky Linux. This update is required for all NTA1000 systems running CentOS 8 (which is no longer supported) and recommended for all NTA1000 systems running CentOS 7. Please see the “NTA1000 Rocky Linux migration” article for more information.

NOTE: The instructions below are for NTA1000v5, NTA1000v6, or NTA1000v7 hardware platforms only. If you have an older NTA1000(v2,v3,v4), please contact the QA Cafe Support team support@qacafe.com.

NOTE: This procedure requires an active Internet connection on the NTA1000. All steps in the procedure below will be executed directly from your NTA1000 system. If the NTA1000 does not have Internet access, please follow the offline migration procedure instead.

Step 1: Install the nta1000-create-image package

The QA Cafe nta1000-create-image package may be installed automatically from the QA Cafe rpm repository using the yum command.

  • For NTA1000v7 platforms running CentOS 8:

    yum install --disablerepo="*" --enablerepo=nta1000-base nta1000-create-image
    
  • For NTA1000v5 and NTA1000v6 platforms running CentOS 7:

    yum install --enablerepo=nta1000-base nta1000-create-image
    

This will install the image utility, which is a python script, in the /usr/share/nta1000/bin directory. This script will be used in the next step.

Step 2: Create the Disk Image Utility bootable USB drive

The nta1000-create-image.py script creates a bootable USB drive that is used to clone a new Rocky Linux 8 operating system image onto the system drive of the NTA1000.

  • To get started, plug a USB drive into the NTA1000.

  • Next, run the nta1000-create-image.py script using the following command:

    /usr/share/nta1000/bin/nta1000-create-image.py
    

    The script will verify that a properly sized USB drive (>= 4GB) exists and will abort if one is not found.

  • If a properly sized USB drive is found, the script will download and copy the QA Cafe Disk Image Utility package from the QA Cafe repository server and then burn it to the USB drive. You will use this utility to migrate your NTA1000 to the Rocky Linux operating system.

  • Once the image utility has been burned to the USB drive, the script will provide additional instructions for properly booting the system from the USB drive.

    • Press <Enter> to power off the system and continue with Step 3 below.
    • Press <Ctrl-C> to exit the utility if you wish to continue the migration procedure later instead.

The following screenshot shows an example of what you should see when running the steps above.

Step 3: Boot the NTA1000 from the USB drive

  • Power on the NTA1000 with the bootable USB drive created in the previous step inserted.

  • Press the F7 key to get to the boot menu when the initial splash screen is displayed on the monitor.

  • Select the USB drive and press enter. DO NOT select any USB entry with UEFI Note that the screenshot below is only an example of what may be displayed; the exact output may be different in some cases.

Step 4: Install Rocky Linux 8 from USB drive

  • After the NTA1000 boots from the USB drive, the QA Cafe NTA1000 Disk Image Utility will start and display the menu below.

    Important - If you do not see the “Migrate to Rocky Linux” option in the menu, STOP!
    Please contact the QA Cafe Support team support@qacafe.com to get the latest release of the NTA1000 Disk Image Utility before proceeding any further.

  • Select (m) Migrate to Rocky Linux - this will take you to the Rocky Linux Migration menu, shown below.

  • Select (s) Rebuild system drive - This will begin the imaging process to install Rocky Linux on the system drive.

  • After the imaging process completes, the menu will be displayed again.

  • Remove the USB drive, then select ® Reboot to reboot your system.

Step 5: Install CDRouter software and license

Once the NTA1000 has rebooted, it should be running Rocky Linux 8. This may be verified by running the following command in a terminal window:

cat /etc/redhat-release

Output should be:

Rocky Linux release 8.4 (Green Obsidian)

Now that the system has been successfully migrated to Rocky Linux 8, CDRouter must be reinstalled.

Please follow the instructions in the Manual installation using the command line section of the CDRouter Installation Guide.

Once CDRouter has been reinstalled, an active CDRouter license file must also be installed. This can be done automatically by running the following command:

cdrouter-cli -update-license

The following command may be used to verify that CDRouter and a valid, active license file have been properly installed:

cdrouter-cli -info

CDRouter’s web UI, and all CDRouter data should now be available.

Contents

×

About CDRouter

QA Cafe CDRouter is a comprehensive and powerful test automation solution focused on feature, security, and performance testing for broadband and enterprise edge gateways, Wi-Fi and mesh systems, and other CPE.

Get in touch via our Contact page or by following us on your favorite service: