hw-mgmt

hw-mgmt is the command branch that changes the configuration of the physical network interfaces on the hardware device. It has a single subcommand: configure.

The command targets the interfaces by their hardware addresses; for this reason there is no record adding or listing action, and the configuration is applied directly.

This command can restart the system

When it is run, a confirmation window opens first: You are about to modify hardware configuration — This operation may cause a system restart. No change is applied without confirmation being given.

Command Summary

TR7 WEB-CLI · hw-mgmt

# Tab after the command: a single subcommand

admin@TR7LBWAF01> hw-mgmt

configure

 

admin@TR7LBWAF01> hw-mgmt configure <fields>

admin@TR7LBWAF01> hw-mgmt configure --info # see what it does without running it

admin@TR7LBWAF01>  

Fields

There is no mandatory field in this command; only the settings that are to be changed are written.

Field	Value
--syncInterface	The synchronization interface to be used for high availability
--interfaceUpdates.0.target	The interface on which the change will be applied; it is selected by the hardware address
--interfaceUpdates.0.name	The new name to be given to the interface
--interfaceUpdates.0.vf	The number of virtual functions; between 0 and 63
--interfaceUpdates.0.inventory	Whether the interface will be taken into the inventory: true or false

More than one interface can be updated in a single command; every interface is written with its own index.

Examples

TR7 WEB-CLI · A) Renaming an interface

admin@TR7LBWAF01> hw-mgmt configure --interfaceUpdates.0.target <interface> --interfaceUpdates.0.name wan1

⚠ You are about to modify hardware configuration

This operation may cause a system restart.

Type "yes" to confirm: yes

admin@TR7LBWAF01>  

TR7 WEB-CLI · B) The synchronization interface and the virtual function

admin@TR7LBWAF01> hw-mgmt configure --syncInterface <interface> \

--interfaceUpdates.0.target <interface> --interfaceUpdates.0.vf 8

admin@TR7LBWAF01>  

TR7 WEB-CLI · C) Updating two interfaces together

admin@TR7LBWAF01> hw-mgmt configure \

--interfaceUpdates.0.target <interface-1> --interfaceUpdates.0.inventory true \

--interfaceUpdates.1.target <interface-2> --interfaceUpdates.1.inventory false

admin@TR7LBWAF01>  

Things to Know

• It is not applied without confirmation. When the command is run, the confirmation screen opens and waits for the confirmation word to be written exactly; when something else is written or when it is exited with Esc, no change is written. The confirmation word is evet in the Turkish interface and yes in the English interface.
• The interface is selected from a list. The target interface is selected from the hardware addresses on the device; Tab lists the existing interfaces.
• The number of virtual functions is limited. The value must be between 0 and 63.
• The authorization area is the settings. This branch is bound to the Settings authorization area; a change permission in that area is required for writing.