CDRouter Support

NTA1000 Rocky Linux migration procedure (offline)

knowledge-base version 13.5

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: The instructions below will require the use of a separate CentOS or Rocky Linux system with Internet access. This system will be used to download and run a python script that will create a bootable USB drive. The USB drive that is created will then be used to install Rocky Linux 8 on your CDRouter system.

Step 1: Download the nta1000-create-image package

Connect to a CentOS or Rocky Linux system that is connected to the Internet and download the nta1000-create-image directly from the QA Cafe rpm repository.

  • Download Link: QA Cafe NTA1000 Disk Image Utility
  • File Size: 8,108 bytes
  • MD5 Checksum: 680ef452035222a52e10d7bcb34058da
  • SHA1 Checksum: 706a8378bc2044061d89a8f26de6ea848ec320d8
  • SHA256 Checksum: e0b2e77d264eda0144fe41a1c334b72f6fe4f39a57910af93955d18d4bcaab00

Step 2: Install the nta1000-create-image package

Install the QA Cafe NTA1000 Disk Image Utility using the yum command on a CentOS or Rocky Linux system that is connected to the Internet:

yum install <path_to_rpm_file>/nta1000-create-image-1.0-1.noarch.rpm

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 3: 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 to the system drive of the NTA1000.

  • To get started, plug a USB drive into the system used in the previous step.

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

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

    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 prompt for the serial number of the NTA1000 that you plan to migrate. The serial number is located on a white sticker on the back of the system. It will be in the format similar to either NTA1000vx-xxx or NTA1000-10xxx.

  • Next, 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.

  • Eject and remove the USB drive from the system before continuing to the next step. This USB drive will now be used to boot your NTA1000 system.

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

Step 4: Boot the NTA1000 from the USB drive

  • Move to your NTA1000 system.

  • Connect a keyboard, mouse, and monitor to the NTA1000. Power off the system from the desktop or open a terminal and enter the following command:

    shutdown -h now
    
  • Once the system has powered down, move the power switch on the rear of the NTA1000 to the off position.

  • Insert the bootable USB drive created in the previous step and power on the NTA1000.

  • 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 5: 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 (r) Reboot to reboot your system.

Step 6: Install CDRouter Software and License

The NTA1000 should be running Rocky Linux 8 once rebooted. 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: