CDRouter Support

Rebuild the NTA1000 Operating System

knowledge-base version 10.4

Which upgrade do you need?

This guide provides detailed instructions for rebuilding the NTA1000 internal disk(s) based on custom CentOS disk images provided by QA Cafe. Rebuilding a disk may be necessary due to a disk failure, accidental deletion of system files, or to bring an older NTA1000 system up to date.

Rebuilding the internal disk(s) is not necessary for simply upgrading the CDRouter software.
For instructions on how to upgrade CDRouter on your system, please refer to this document:

Before you start

Please be aware that installing a new disk image will erase all data from that disk and will require a full backup and restoration of any data you wish to keep.

Also, before starting it’s important to know which hardware version of the NTA1000 you have. NTA1000 v2, v3, and v4 hardware requires a 4.x disk image. NTA1000 v5 hardware requires a 5.x disk image. The process of installing a new disk image will be slightly different depending on the hardware version and image version. If you’re not sure which model you have, please refer to this page:

Please note that NTA1000 v1 systems are no longer supported. If you have an NTA1000 v1, please contact sales@qacafe.com to discuss upgrade options.

The detailed procedure below will guide you through the steps required to back up your data and install the CentOS disk image(s). Once the installation is complete, you will be able to restore your CDRouter configuration settings and test results, and continue testing where you left off.

Please note:

  • You will need a 2 GB or larger USB flash drive in order to complete this procedure

  • All commands shown in this procedure should be run as root

  • NTA1000 v2 hardware has a single internal hard drive, therefore there is a single disk image to restore. NTA1000 v3, v4, and v5 hardware have two internal drives, therefore there are two disk images to restore. In this case, you will have the choice to restore either or both disks.

  • Please note that the USB flash drive and the NTA1000 internal hard drive(s) will both be completely erased and reformatted as part of this procedure. Any data or separate partitions that may be present on these drives will be destroyed.

Upgrade procedure

BackUp CDRouter Configuration Files and Test Results

Before starting, please make sure that you have backed up all of your CDRouter data to a remote location. If you use the CDRouter web interface for all of your CDRouter testing, all devices, configs, packages, and results are managed by CDRouter under the /usr/cdrouter-data directory (/usr/buddyweb directory for CDRouter versions prior to 10.0).

If you do not use the CDRouter web interface, then you will need to locate your CDRouter configuration files and test results yourself, along with any other files that you wish to save. Anything that you do not back up will be lost.

More information about backing up your CDRouter data can be found in the following Knowledge Base article on the QA Cafe Customer Support website: What’s the best way to back up and restore CDRouter?.

Download the NTA1000 Disk Image

The NTA1000 disk image can be downloaded from the QA Cafe website. (Note: the actual file name and details may differ from the examples below):

For NTA1000 v5 hardware:

  • Download Link: nta1000-5.1.img
  • File Size: 2,031,091,712 bytes
  • MD5 Checksum: 50aca03a4cf3e99cac4d81005abbdc35

For NTA1000 v2, v3, or v4 hardware:

  • Download Link: nta1000-4.3.img
  • File Size: 2,031,091,712 bytes
  • MD5 Checksum: 80879be6ffc4b02465f844f0ee29a5ca

Verify that your copy of the image file has the correct file size and MD5 checksum to be sure there were no errors when downloading it to your system. Use the information with the link above to verify your downloaded disk image file.

  • For NTA1000 v5 hardware:
root@nta1000:/home/qacafe/Downloads# ls -l nta1000-5.1.img
-rw-r--r-- 1 root root 2031091712 2016-09-27 12:24 nta1000-5.1.img

root@nta1000:/home/qacafe/Downloads# md5sum nta1000-5.1.img
50aca03a4cf3e99cac4d81005abbdc35  nta1000-5.1.img
  • For NTA1000 v2, v3, or v4 hardware:
root@nta1000:/home/qacafe/Downloads# ls -l nta1000-4.3.img
-rw-r--r-- 1 root root 2031091712 2016-09-27 12:24 nta1000-4.3.img

root@nta1000:/home/qacafe/Downloads# md5sum nta1000-4.3.img
80879be6ffc4b02465f844f0ee29a5ca  nta1000-4.3.img

Copy NTA1000 Disk Image to flash drive

Insert the flash drive into the machine where the image file resides and determine its assigned device ID. For the purposes of this example, we will assume the device ID of the flash drive is “sdb”.

NOTE: It is very important that you correctly determine device ID of your flash drive. Copying the NTA1000 disk image to the device ID of your system’s hard drive or any other device will overwrite and destroy the contents of that drive!

You can check the output from the "lsusb" and "dmesg" commands immediately after inserting the USB flash drive in order to confirm which device ID has been assigned.

In the example below, we are using a “SanDisk Cruzer Glide” flash drive, which is recognized and assigned device ID “sdb”:

root@nta1000:/home/qacafe/Downloads# lsusb
Bus 008 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 007 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 006 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 005 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 004 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 003 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 002 Device 005: ID 0781:5575 SanDisk Corp. 
Bus 002 Device 004: ID 046d:c313 Logitech, Inc. 
Bus 002 Device 003: ID 0461:4d64 Primax Electronics, Ltd 
Bus 002 Device 002: ID 1a40:0101 TERMINUS TECHNOLOGY INC. USB-2.0 4-Port HUB
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

root@nta1000:/home/qacafe/Downloads# dmesg 
       ........
[435434.580010] usb 2-1: new high speed USB device using ehci_hcd and address 5
[435434.758282] Initializing USB Mass Storage driver...
[435434.758359] scsi6 : usb-storage 2-1:1.0
[435434.758417] usbcore: registered new interface driver usb-storage
[435434.758418] USB Mass Storage support registered.
[435435.751127] scsi 6:0:0:0: Direct-Access     SanDisk  Cruzer Glide     1.26 PQ: 0 ANSI: 5
[435435.751419] sd 6:0:0:0: Attached scsi generic sg1 type 0
[435435.753053] sd 6:0:0:0: [sdb] 15375360 512-byte logical blocks: (7.87 GB/7.33 GiB)

Make sure the USB drive is NOT mounted.

Use the device ID of your flash drive with the "dd" utility to copy the contents of the NTA1000 disk image file to the flash drive device.

This command should take about 5-10 minutes to complete:

  • For NTA1000 v5 hardware:
dd if=nta1000-5.1.img of=/dev/sdb bs=1M
  • For NTA1000 v2, v3, or v4 hardware:
dd if=nta1000-4.3.img of=/dev/sdb bs=1M

When finished, remove the USB drive and insert it into one of the two front USB ports of the target NTA1000.

Update NTA1000 BIOS to boot from USB Flash Drive

In order for the NTA1000 to boot from the USB flash drive, you will need to update the system BIOS settings. The BIOS is different depending on the NTA1000 hardware version.

NTA1000 v5 BIOS

  • Make sure the USB flash drive is inserted into the NTA1000 and reboot the system.
  • Press the <DELETE> key to enter the system BIOS interface. Navigate to each of the following menu items and make the appropriate changes. Press the <ESC> key to back out of each menu and return to the top level.
  • Set the USB Flash Drive to be the first boot device.
    • Navigate to: Boot >> Boot Option #1 and press Enter
    • Use the up/down arrows to highlight the USB drive, then press Enter
  • Navigate to Save & Exit >> Save Changes and Exit to save settings and reboot.

NTA1000 v2, v3, v4 BIOS

  • Make sure the USB flash drive is still inserted into the NTA1000 and reboot the system.
  • Press the <DELETE> key to enter the system BIOS interface. Navigate to each of the following menu items and make the appropriate changes. Press the <ESC> key to back out of each menu and return to the top level.
  • Set the USB Flash Drive to be the first boot device.
    • Navigate to: Boot >> Hard Disk Drives
    • Highlight the USB drive, then press <+> on the keypad to move it to the top of the list
  • Press <F10> to save settings and reboot.

Install NTA1000 Disk Image from USB Flash Drive

The NTA1000 should now boot from the flash drive. You will see the “NTA1000 Disk Image” menu.

Use the arrow keys to highlight the appropriate option.

For NTA1000 v5 hardware, there are two internal drives, so there are two drive images to restore. Only one drive image is restored at a time, and you can decide to restore either or both drives. If you plan to restore both drives, the order of the restores makes no difference.

For the operating system disk:

 NTA1000 v5 hardware 
 * Rebuild operating system disk (/dev/sda)

For the data disk:

 NTA1000 v5 hardware  
 * Rebuild data disk (/dev/sdb)

For v3 and v4 NTA1000 units, there are two internal drives, so there are two drive images to restore. Only one drive image is restored at a time, and you can decide to restore either or both drives. If you plan to restore both drives, the order of the restores makes no difference.

For the operating system disk:

 NTA1000 v3, v4 hardware 
 * Rebuild operating system disk (/dev/sda)

For the data disk:

 NTA1000 v3, v4 hardware  
 * Rebuild data disk (/dev/sdb)

For NTA1000 v2 units, there is one internal drive, so there is only one drive image to restore:

 NTA1000 v2 hardware 
 * Rebuild disk

Once you’ve made your choice, press <ENTER> to begin the image restore. You will be asked to confirm that you want to continue. Answer ‘y’ at both prompts to continue. The image restore should take a few minutes.

The newly restored disk images are intentionally small initially, so that they can fit on most any size disk (128 GB minimum). After a disk image is restored, a final step is to automatically resize the last partition to make full use of disk space.

If a second internal disk is to be restored (v3, v4, or v5 NTA1000), enter

(1) Reboot

(You’ll be presented once again with the main menu allowing you to repeat this procedure for the other disk.)

If there are no more disks to restore, enter

(0) Poweroff

Once the system finishes shutting down, remove the USB drive, locate the power switch on the rear of the NTA1000, turn the power switch off, wait 10 seconds, and turn it back on.

Configure Network Interfaces

Note that this step is necessary only for the 4.3 image (NTA1000 hardware v2, v3, or v4).

The NTA1000 should now boot into CentOS.

When the NTA1000 boots for the first time following the installation, you will need to run a custom /usr/share/nta1000/bin/configure_network_interfaces.pl script as root. This script will ensure that the system identifies each of the network interfaces with the correct name (eth0, eth1, etc.) as well as configure NetworkManager to ignore the test interfaces.

Complete the following steps to run this script:

  • Open a terminal window and enter the following command to run the script as root:
/usr/share/nta1000/bin/configure_network_interfaces.pl

The default password is “cdrouter”.

  • Reboot the system after running the script.

Restore CDRouter Configuration Files and Test Results

Before installing CDRouter, we recommend restoring your old CDRouter configs, packages, and test results from your backup location. If you use the CDRouter web interface for your CDRouter testing, you will need to restore the entire /usr/cdrouter-data directory (or the entire /usr/buddyweb directory for CDRouter versions prior to 10.0. Please see our Knowledge Base for more details:

Download and Install CDRouter

Open a web browser on the NTA1000 and connect to the QA Cafe Customer Lounge to download the CDRouter installer.

Be sure to download the appropreate product depending on what your NTA1000 system is licensed for. You will not be able to activate and use CDRouter if the installed product does not match your license. If you are unsure which product to install, you can check the license for your NTA1000 in the Customer Lounge as well.

Run the CDRouter installer to install CDRouter onto the NTA1000. Please see the following guide for details: CDRouter Installation and Upgrade Guide

Update License with New CDRouter System-ID

Once the CDRouter installation completes, your NTA1000 may have a new CDRouter system-id. CDRouter will not be able to acquire a valid license file until we have updated your license with the new system-id.

Please send the new CDRouter system-id displayed at the end of the installation script along with the QA Cafe serial number of your NTA1000 to Support, and we will update your license with the new system-id. You can also find the system-id by pulling up the CDRouter web interface in your browser. A third way is to run the following command in a terminal window:

  • For CDRouter 10.0 and newer:
cdrouter-cli -show-system-id
  • For CDRouter pre-10.0:
buddy -show-system-id

Once your new system-id has been registered with your CDRouter license, you will need to download and install a new license file. This can be done automatically from the CDRouter web interface or by running the following command in a terminal window:

  • For CDRouter 10.0 and newer:
cdrouter-cli -update-license
  • For CDRouter pre-10.0:
buddy -update-license

If your NTA1000 does not have Internet access, you may download your license file from the QA Cafe Customer Support site and install it manually. Instructions can be found in the Activate your CDRouter License section of the CDRouter Installation and Upgrade Guide.

Getting Help

If you have any questions about this procedure or run into any problems, please contact QA Cafe Customer Support, and we will be happy to help you.

Contents

×

About CDRouter

CDRouter is made by QA Cafe, a technology company based in Portsmouth, NH.

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