...

Firmware Upgrade validation Procedure

TFTP Server

...

STEP 1:

Install xinetd and tftpd-hpa application in your local PC to setup tftp server by using below command
TFTP Server Installation Step

sudo apt-get install xinetd sudo apt-get install tftpd-hpa

STEP 2

...

Either TFTP/ HTTP server can be used to download the image, depends on the requirement.

Things to be done before checking for the server configurations:

STEP 1:

Create a .tar file and place the image files.

...

tar -cvf <imagefile_name>.tar <path-of-rdkb*.rootfs.tar.gz> <path-of-zImage*.bin> For Ex: tar -cvf rdkb-generic-broadband-image_default_20200629035029.tar /home/kaviya/rdkb-generic-broadband-image_default_20200629035029.rootfs.tar.gz /home/kaviya/zImage--4.14.22-r0-turris-20200629035029.bin

STEP 23:

Create checksum file for the upgrading image.
md5sum checksum creation

md5sum "<imagefile_name>.tar" > imagefile_name.txt   For Ex: md5sum "rdkb-generic-broadband-image_default_20200629035029.tar" > rdkb-generic-broadband-image_default_20200629035029.txt

...

STEP 1:

Install xinetd and tftpd-hpa application in your local PC to setup tftp server by using below command
TFTP Server Installation Step

...

sudo apt-get install xinetd
sudo apt-get install tftpd-hpa

STEP 2:

Create new folder for example "tftp" in your PC home directory and place the checksum file and upgrading image file (the .tar file generated).

STEP 34:

Check for tftp file in /etc/xinetd.d/ directory. If not, then create tftp file under this /etc/xinetd.d/ directory and add below content.

...

service tftp { protocol        = udp port            = 69 socket_type     = dgram wait            = yes user            = nobody server          = /usr/sbin/in.tftpd server_args     = -c -v -s /home/xyz/tftp ( upgrading file and checksum file  maintained in this directory ) disable         = no }

STEP 45:

Verify /etc/default/tftpd-hpa file content

...

# /etc/default/tftpd-hpa   TFTP_USERNAME="tftp" TFTP_DIRECTORY="/home/xyz/tftp" ( upgrading file and checksum file  maintained in this directory ) TFTP_ADDRESS="0.0.0.0:69" TFTP_OPTIONS="--secure"

STEP 56:

Start tftp server and xinetd server

sudo service tftpd-hpa restart /etc/init.d/xinetd restart

HTTP Server

STEP 1:

Ensure the http server in running in the local PC. If not, then activate or install it (For Example, Lighttpd)

STEP 2:

Once the server is running, place the necessary files in the below path.

Path of the image file to be placed: /var/www/html

This directory should contain the image file and the checksum file:

XCONF Server Setup

XConf URL

...

After entered Download Location Round Robin filter, then edit your image downloading details.

For TFTP Server

STEP 1FOR TFTP SERVER CONFIGURATION:

Enable Never use HTTP and select your Rogue model.

Give TFTP server running IP address to download image.

STEP 2:

Verify that XConf Server configuration displays the Json response from the mentioned URL:

http://35.155.171.121:9092//xconf/swu/stb?eStbMac=<Turris MAC address>&model=<model_name>&capabilities=RCDL&capabilities=supportsFullHttpUrl

Example, http://35.155.171.121:9092//xconf/swu/stb?eStbMac=D8:58:D7:00:A6:B4&model=%3Cmodel_name%3E&capabilities=RCDL&capabilities=supportsFullHttpUrl

Image Removed

For HTTP Server

STEP 1:

1) Enter the "Location (FQDN)" field is local/Public http server (fully qualified domain name ) (ex : www.myfirmware.com)
2) Enter the "Location (full URL)" field is full location path of local/Public http server (ex : http://www.myfirmware.com)
3) Unclick the check box of Never use HTTP
4) Removed the model name from Rogue Models and removed the firmware version (If it's not updated earlier, please ignore this step).
5) click the save button.
6) In DUT, please edit the following file with below format,If it's local http server
i) Open the /etc/hosts
ii) Add your local http server ip with DNS ( Ex : <Machine IP where http server is running> www.myfirmware.com)
iii) Save the file.

Note : Every reboot, You need to add the above three steps if it's local http server.

7) If it's local http server, please add the below line in /etc/hosts

 <wan IP of board> http://myfirmware.com

Image Removed

STEP 2:

Verify Xconf Server Configuration

Verify that XConf Server configuration displays the Json response from the mentioned URL:

http://35.155.171.121:9092//xconf/swu/stb?eStbMac=<Turris MAC address>&model=<model_name>&capabilities=RCDL&capabilities=supportsFullHttpUrl

Example, http://35.155.171.121:9092//xconf/swu/stb?eStbMac=D8:58:D7:00:A6:B4&model=%3Cmodel_name%3E&capabilities=RCDL&capabilities=supportsFullHttpUrl

Image RemovedImage Added

Turris-Omnia Board

...

• Build the Rdkb Turris Image
• Flash the build image 
• Setup xconf server ready with rules and download location for Turris-Omnia device
• Place the upgrading image and checksum file in tftp /http server as neededserver 
• Boot the flashed image

Limitations

...

Yet to have http support