EasyMesh Agent upgrade

Created On23 maja 2022

Last Updated On29 października 2024

byPiotr Dydo

Document Date and version	2022.05.23
Tested with ONT HALNy HL-4GMV2/3/4, HL-4GQV / HL-4GQVS / HL-4GQVS2, HL-4GXV / HL-4GXV-F	Supported on Version: V3.1.24 or above for both controller and agent
Tested with ONT HALNy HL-4BX3V-F, HL-4GX3VR	Supported on Version: V5.0.11 or above for both controller and agent
Revision	1

Let us know how to improve below document on: support@halny.com

How to run

Prepare server available for EasyMesh controller from VLAN internet (passive mode need to be activated file server).
Put software into the server.
Configure EasyMesh Controller and Agents.
Configure EasyMesh upgrade at the Controller in the one of the three following methods.

1. Web configuration

Go to the APP > EasyMesh > Upgrade (Advanced -> EasyMesh -> Upgrade | for V3.2.X firmware series).
Choose one of the server type.
Fill in all information as in example below.

V3.1.X firmware series

V3.2.X / V5.0.X firmware series

Model Name needs to be the same as the model name on the sticker from the bottom of the device.
Firmware Version has to contain “V” at the start. Digits have to be separated by dot as in example V3.1.24.
File Name has to be the same as the file name at the server. The file name needs to contain a file extension.
Server Type – possible to choose one of four server types: FTP/FTPS/HTTP/HTTPS.
Server IP, Server Login, and Server Password have to be filled in for correct data access. IP.IP.IP.IP has to be replaced by digits.

2. XML configuration

In the XML file for V3.1.24 or above the EasyMesh Agent Upgrade is placed in the management section.

Bellow are attached EasyMesh Agent Upgrade nodes:

<MESH_AGENT_UPGRADE>
	<AGENT_TYPE_1>
		<MODEL_NAME>HL-4GXV-F</MODEL_NAME>
		<FILE_NAME>G_ONU_HL-4GXV-F_V3-1-24_001-enc.bin</FILE_NAME>
		<FIRMWARE_VERSION>V3.1.24</FIRMWARE_VERSION>
		<SERVER_TYPE>FTP</SERVER_TYPE>
		<SERVER_IP>IP.IP.IP.IP</SERVER_IP>
		<SERVER_LOGIN>FTP_login</SERVER_LOGIN>
		<SERVER_PASSWORD>FTP_password</SERVER_PASSWORD>
		<REBOOT_TIME>NOW</REBOOT_TIME>
	</AGENT_TYPE_1>
	<AGENT_TYPE_2>
		<MODEL_NAME>HLE-3GM</MODEL_NAME>
		<FILE_NAME>G_ONU_HLE-3GM_V3-1-24_001-enc.bin</FILE_NAME>
		<FIRMWARE_VERSION>V3.1.24</FIRMWARE_VERSION>
		<SERVER_TYPE>FTP</SERVER_TYPE>
		<SERVER_IP>IP.IP.IP.IP</SERVER_IP>
		<SERVER_LOGIN>FTP_login</SERVER_LOGIN>
		<SERVER_PASSWORD>FTP_password</SERVER_PASSWORD>
		<REBOOT_TIME>NOW</REBOOT_TIME>
	</AGENT_TYPE_2>
</MESH_AGENT_UPGRADE>

MODEL_NAME needs to be the same as the model name on the sticker from the bottom of the device.
FIRMWARE_VERSION has to contain “V” at the start. Digits have to be separated by dot as in example V3.1.24.
FILE_NAME has to be the same as the file name at the server. The file name needs to contain a file extension.
SERVER_TYPE – possible to choose one of four server types: FTP/FTPS/HTTP/HTTPS.
SERVER_IP, SERVER_LOGIN, and SERVER_PASSWORD have to be filled in for correct data access. IP.IP.IP.IP has to be replaced by digits.

3. RestAPI configuration

URL to use: http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/model_name
where IP_2.IP_2.IP_2.IP_2 is ONT’s ip-host 1 address.

IP.IP.IP.IP is the address IP of the server with software.

Configuration by curl

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_1_model_name":"HL-4GXV-F"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/model_name" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_1_firmware_version":"V3.1.24"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/firmware_version" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_1_server_type":"ftp"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/server_type" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_1_server_ip":"IP.IP.IP.IP"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/server_ip" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_1_server_login":"FTP_login"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/server_login" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_1_server_password":"FTP_password"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/server_password" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_1_file_name":"G_ONU_HL-4GXV-F_V3-1-24_001-enc.bin"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/file_name" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_1_reboot_time":"NOW"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/1/reboot_time" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"apply":"yes"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/apply" --connect-timeout 2


curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_2_model_name":"HLE-3GM"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/2/model_name" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_2_firmware_version":"V3.1.24"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/2/firmware_version" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_2_server_type":"ftp"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/2/server_type" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_2_server_ip":"IP.IP.IP.IP"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/2/server_ip" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_2_server_login":"FTP_login"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/2/server_login" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_2_server_password":"FTP_password"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/2/server_password" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_2_file_name":"G_ONU_HLE-3GM_V3-1-24_001-enc.bin"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/2/file_name" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"meshagentupgrade_2_reboot_time":"NOW"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/2/reboot_time" --connect-timeout 2

curl -H 'Content-Type: application/json' -d '{"apply":"yes"}' "http://IP_2.IP_2.IP_2.IP_2:48625/api/v1/meshagentupgrade/apply" --connect-timeout 2

4. Running Easy Mesh Agent Upgrade

Easy Mesh Agent Upgrade needs to be triggered by:

save button at WWW management
REST API apply – /api/v1/meshagentupgrade/apply

How Can We Help?