Instructions to Install HART Test System (HTS) v4.0 Image on HTS v3.8
This document describes the steps to install the HTS v4.0 image from an external storage medium (e.g.,
hard drive) to the internal hard drive of the HTS v3.8 that is being updated. It is assumed that the correct
image has been downloaded from FCG and saved on to the external storage medium.
The following place holder names are used in this document:
Image file: HTS4_0_MyHTS.img.gz (image downloaded from FCG)
Image drive: MyImageHD (external medium on which image is saved)
Target HTS: MyHTS (your HTS to be upgraded to v4.0)
Bootable USB drive with Xubuntu 22.04.5: Boot_USB (bootable USB drive that you have created)
The actual names of the image file, the image drive, etc., would be different. Please use the actual
names as applicable.
NOTE:
Please read all the steps in this document once before you begin the installation so that the steps are
clearly understood and the procedure does not need to be aborted midway.
Before proceeding with the installation of the image, please shutdown MyHTS. Remove everything
connected to MyHTS except the power connector and the connectors for the monitor, keyboard and
mouse. Make sure that no ethernet cable, modems, USB cables/devices, etc., are connected to the HTS.
Perform the following steps to install the image on your HTS:
1. Insert Boot_USB in one of the USB ports of MyHTS. The USB ports on the back panel usually work
better.
2. Power on MyHTS and let the system boot up from Boot_USB. Refer to the
“readme_boot_from_Boot_USB.pdf” document in the package for steps on how to do this.
3. Select "Try or Install Ubuntu" from the displayed list on the terminal using the arrow keys on the
keyboard and pressing <Enter>.
4. After a few minutes, the "Install" window will be displayed with two buttons. Press "Try Ubuntu" (do
NOT press "Install Ubuntu").
5. After a few minutes, the Desktop will appear. Right-click on the Desktop and select "Open Terminal
Here" from the drop-down list.
6. Type the following commands on the terminal one by one:
[Note: The '$' represents the shell prompt on the terminal and must not be typed. The comments
enclosed within [[...]] describe what the preceding command does. They must not be typed]
$ sudo fdisk -l | grep sd | grep bytes
[[ The above would show the size of the hard drive of MyHTS (/dev/sda) and the size of the Boot_USB
drive (/dev/sdb). Please note that the parameter after "fdisk" in the above command is the letter "l" (el),
not the number "1" ]]
$ sudo swapoff -a $ $ cd /media $ $ ls
[[ The above command would show the Boot_USB (as "cdrom") ]]
7. Connect MyImageHD to MyHTS. Wait for MyImageHD to be detected and a GUI window showing the
contents of MyImgeHD to be displayed.
8. Then, type the following commands on the terminal one by one -
$ ls
[[ The above command would show the newly connected media (MyImageHD) in addition to Boot_USB.
The new media would be under "xubuntu" ]]
$ cd xubuntu $ $ ls
[[ The above command would show the name of MyImageHD as seen by Linux. It could be something
obvious like "Hitachi" or "T7" (based on the manufacturer or model of MyImageHD), or something
cryptic like CC2XAR... We will refer to it as "MyImageHDName" ]]
$ cd MyImageHDName
[[ Please use the actual name for MyImageHD as seen by Linux after "cd" in the above command, not
“MyImageHDName". The actual name is seen in the previous "ls" command ]]
$ sudo gzip -dc ./HTS4_0_MyHTS.img.gz | sudo dd of=/dev/sda bs=1M
[[ Please use the actual name of the image that is saved on MyImageHD, not "HTS4_0_MyHTS.img.gz".
The above command would uncompress the image and install it on the internal HD of MyHTS ]]
The installation of the image takes several hours (2-10), depending on the hardware (MyHTS,
MyImageHD, Boot_USB) and the image itself. Please do not interrupt the process. The screen may go
dark during this time. It can be re-activated by moving the mouse.
When the installation is complete, the number of "records in" and the number of "records out" will be
printed on the terminal. They must match.
9. After the image has been installed on MyHTS, shut down the system by pressing the small mouse/rat
Xubuntu icon on the top left of the screen and selecting "Shutdown". You may need to press <Enter> if
the system has not shut down after more than 10 minutes and the screen remains dark or the Xubuntu
logo stays displayed on the screen.
10. Once MyHTS is powered down, remove the Boot_USB and the MyImageHD from the USB ports, then
power up MyHTS.
11. When MyHTS powers up and displays the login screen, select user1 from the dropdown list for
username and enter user1 in the password field.
12. Read the “GettingStarted.txt” document on the Desktop for guidance on best practices for how to
run tests on the HART Test System.
Your HART Test System now has Xubuntu 22.04.5 and is ready to be used with Test Automation
Software v4.0.