ipe-filename: Specifies an IPE software file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .ipe extension.

boot boot-filename: Specifies a boot image file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .bin extension.

system system-filename: Specifies a system image file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .bin extension.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Specify IPE software file device.ipe for Winet group testgroup.

<Sysname> system-view

[Sysname] winet group testgroup

[Sysname-winet-group-testgroup] boot-loader file device.ipe

Related commands

winet group

winet upgrade boot-loader

create batch-file

Use create batch-file to create a batch file.

Syntax

create batch-file batch-file-name

Default

No batch files exist.

Views

User view

Predefined user roles

network-admin

Parameters

batch-file-name: Specifies the name of the batch file, a case-insensitive string of 1 to 255 characters. If you do not specify a file extension when specifying a file name, the default extension .cmdset is used.

Usage guidelines

After executing this command, you will enter the batch edit mode. In this mode, each command occupies a line. When you finish editing all command lines, enter a percent sign (%) to return to user view.

Make sure the command lines that you enter are correct because the system does not verify whether the command lines are correct.

Examples

# Create a batch file named test.cmdset, and enter the command lines for specifying the device name as Sysname and enabling Telnet.

<Sysname> create batch-file test.cmdset

Begin to edit batch commands, and quit with the character '%'.

system-view

sysname Sysname

telnet server enable%

Related commands

display winet batch-file status

winet batch-file deploy

display winet backup configuration status

Use display winet backup configuration status to display the backup status on members.

Syntax

display winet backup configuration status

Views

Any view

Predefined user roles

network-admin

Usage guidelines

This command displays the status of the ongoing backup task or the most recent backup task if the member is not performing backup.

Examples

# Display the backup status on members.

<Sysname> display winet backup configuration status

ID IpAddress MacAddress Status Time

1 192.168.56.30 08d2-38ff-0300 Finished 2017-04-05 11:30:35

2 192.168.56.40 62d2-c21c-0400 Finished 2017-04-05 11:30:40

Table 1 Command output

Field	Description
ID	ID of the member.
IpAddress	IP address of the member.
MacAddress	MAC address of the member.
Status	Backup status: · Waiting—The member is waiting for configuration backup. · Processing—The member is backing up the configuration. · Finished—The member has finished backing up the configuration. · Timeout—Configuration backup times out. · Failed—The member failed to back up the configuration.
Time	Time when the member finished backing up the configuration. If the member has not finished backing up the configuration, this field displays a hyphen (-).

Related commands

winet backup configuration

winet backup configuration interval

winet backup configuration max-number

display winet batch-file status

Use display winet batch-file status to display the batch file deployment result.

Syntax

display winet batch-file status [ ap | last number | phone ]

Views

Any view

Predefined user roles

network-admin

Parameters

ap: Displays the result of the most recent batch file deployment for ports connected to APs.

last number: Specifies a batch file deployment (performed by using the winet batch-file deploy command) by its number counting from the most recent batch file deployment. The value range for the number argument is 1 to 5.

phone: Displays the result of the most recent batch file deployment for ports connected to IP phones.

Usage guidelines

If you do not specify any parameters, this command displays the result of the most recent batch file deployment performed by using the winet batch-file deploy command.

Examples

# Display the result of the most recent batch file deployment. In this example, the batch file contains the display winet configuration command.

<Sysname> display winet batch-file status last 1

TC ID 1

Device MAC : 8a73-60c3-0200

Start Time : 2018-12-24 14:55:39

End Time : 2018-12-24 14:55:43

Result :

<Sysname>display winet configuration

Device role : TC

TM IP : 192.168.22.103

TM MAC : 8a73-4faa-0100

TM sysname : Sysname

TC ID 2

Device MAC : 8a73-6b31-0300

Start Time : 2018-12-24 14:55:43

End Time : 2018-12-24 14:55:48

Result :

<Sysname>display winet configuration

Device role : TC

TM IP : 192.168.22.103

TM MAC : 8a73-4faa-0100

TM sysname : Sysname

Table 2 Command output

Field	Description
TC ID	ID of the member.
Device MAC	MAC address of the member.
Start Time	Batch file deployment start time.
End Time	Batch file deployment end time.
Result	Batch file deployment result in details.

Related commands

create batch-file

winet batch-file apply

winet batch-file deploy

display winet configuration

Use display winet configuration to display the Winet configuration.

Syntax

display winet configuration

Views

Any view

Predefined user roles

network-admin

Examples

# Display the Winet configuration on the commander.

<Sysname> display winet configuration

Device role : TM

FTP server IP : 192.168.22.103

FTP server username : admin

Topology-refresh interval : 60(s)

Backup startup-configuration interval : N/A

Sync backup number : 5

Device status : Lack

Some configurations are absent on the TM, such as Telnet or LLDP configuration.

# Display the commander information on a member.

<Sysname> display winet configuration

Device role : TC

TM IP : 192.168.22.103

TM MAC : 8288-468d-0100

TM sysname : Sysname

Table 3 Command output

Field	Description
Device role	Role of the device.
FTP server IP	IP address of the FTP server. If no FTP server IP address is configured, this field displays N/A.
FTP server username	FTP server username. If no username is configured, this field displays N/A.
Topology-refresh interval	Topology refresh interval, in seconds.
Backup startup-configuration interval	Automatic configuration file backup interval, in hours. If no interval is set, this field displays N/A.
Sync backup number	Number of members that can perform configuration backup at the same time.
Device status	Commander status: · Normal. · Lack—Lack of configuration, such as NETCONF, Telnet, local user, and LLDP.
TM IP	IP address of the commander. If the member failed to obtain the commander IP address, this field displays N/A.
TM MAC	MAC address of the commander, If the member failed to obtain the commander MAC address, this field displays N/A.
TM sysname	Name of the commander. If the member failed to obtain the commander name, this field displays N/A.
Some configurations are absent on the TM, such as XXX.	This field is available only when the Device status field displays Lack. Lack of configuration will affect Winet functions. Please follow the prompt to complete the configuration.

display winet device-link

Use display winet device-link to display connections between devices in the Winet network.

Syntax

display winet device-link

Views

Any view

Predefined user roles

network-admin

Examples

# Display connections between devices in the Winet network.

<Sysname> display winet device-link

(TM IP)[192.168.56.20]

ID Hop LocalPort LocalIP PeerPort PeerIP

0 0 GigabitEthernet1/0/2 192.168.56.20 GigabitEthernet1/0/1 192.168.56.30

1 1 GigabitEthernet1/0/1 192.168.56.30 GigabitEthernet1/0/2 192.168.56.20

1 2 GigabitEthernet1/0/2 192.168.56.30 GigabitEthernet1/0/1 192.168.56.40

2 3 GigabitEthernet1/0/1 192.168.56.40 GigabitEthernet1/0/2 192.168.56.30

Table 4 Command output

Field	Description
TM IP	IP address of the commander.
ID	ID of the commander or member.
Hop	Number of hops between the commander and member.
LocalPort	Local port.
LocalIP	IP address of the local device.
PeerPort	Peer port.
PeerIP	IP address of the peer port.

Related commands

winet topology-refresh

winet topology-refresh interval

display winet group

Use display winet group to display Winet group information.

Syntax

display winet group [ group-name ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

Parameters

group-name: Specifies a Winet group by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this argument, the command displays information about all Winet groups.

Verbose: Displays detailed Winet group information. If you do not specify this keyword, the command displays brief Winet group information.

Examples

# Display detailed Winet group information.

<Sysname> display winet group verbose

Group name : test

TC count : 3

Boot-loader file :

Startup-configuration file :

Rule:

Match Device-type WS5850-Winet

TCID DeviceType Sysname IpAddress MacAddress Status Version

1 WS5850 S1 192.168.56.103 0e74-e2fb-0400 Normal COMWAREV700R001

2 WS5850 S2 192.168.56.102 0e74-ea13-0500 Normal COMWAREV700R001

3 WS5850 S3 192.168.56.104 0e74-db54-0300 Normal COMWAREV700R001

Table 5 Command output

Field	Description
GroupName	Name of the Winet group.
TC count	Number of members in the Winet group.
Boot-loader file	Names of the upgrade startup software files for upgrading the Winet group. If no upgrade startup software files are specified, this field displays null.
Startup-configuration file	Name of the configuration file for upgrading the Winet group. If no configuration file is specified, this field displays null.
Rule	Match criteria of the Winet group.
Match	Match type and its value. The match types include the following: · Device-type—Matches members by device type. · IP-address—Matches members by IP address. · MAC-address—Matches members by MAC address.
TCID	ID of the member.
DeviceType	Device type of the member.
Sysname	Device name of the member.
IpAddress	IP address of the member.
MacAddress	MAC address of the member.
Version	Software version of the member.
Status	Operating status of the member: · Offline—The member is offline. · Normal—The member is online.

Related commands

match

winet group

display winet replace status

Use display winet replace status to display faulty member replacement status.

Syntax

display winet replace status

Views

Any view

Predefined user roles

network-admin

Examples

# Display faulty member replacement status.

<Sysname> display winet replace status

Faulty ID : 2

Faulty MAC : 94e2-cdcb-0600

Replacement ID : 3

Replacement MAC: 2443-5f8c-0200

Mode : Manual

Status : Successful

Start time : 2017-03-21 15:01:31

End time : 2017-03-21 15:01:40

Table 6 Command output

Field	Description
Faulty ID	ID of the faulty member.
Faulty MAC	MAC address of the faulty member.
Replacement ID	ID of the new member.
Replacement MAC	MAC address of the new member.
Mode	Replacement method, which can be Manual or Auto.
Status	Replacement status: · Successful. · Failed. · Replacing. · Timeout.
Start time	Replacement start time
End time	Replacement end time.

Related commands

winet auto-replace enable

winet replace

display winet resource-monitor

Use display winet resource-monitor to display resource monitoring information.

Syntax

display winet resource-monitor [ cpu | memory | temperature ] * [ tc tc-id | tm ]

Views

Any view

Predefined user roles

network-admin

Parameters

cpu: Displays CPU usage.

memory: Displays memory usage.

temperature: Displays temperature information.

tc tc-id: Specify a member by its ID in the range of 1 to 255.

tm: Specify the commander.

Usage guidelines

If you do not specify a resource type, this command displays the resource monitoring information of all types.

If you do not specify a member or the commander, this command displays the resource monitoring information for the commander and all members.

Examples

# Display the resource monitoring information for member 1.

<Sysname> display winet resource-monitor tc 1

TC 1

Collection time : 2017-07-25 18:02:30

Slot 1:

CPU 0 CPU usage: 1%

Memory usage : 587076/903332

Temperature : 30

Table 7 Command output

Field	Description
Collection time	Time when the resource monitoring information was collected.

Related commands

winet resource-monitor

display winet resource-monitor configuration

Use display winet resource-monitor configuration to display resource monitoring configuration.

Syntax

display winet resource-monitor configuration

Views

Any view

Predefined user roles

network-admin

Examples

# Display resource monitoring configuration.

<Sysname> display winet resource-monitor configuration

ID MacAddress CPU Memory Temperature

1 1111-2222-3333 Y N N

2 1111-2222-3334 Y N N

3 1111-2222-3335 Y N N

Table 8 Command output

Field	Description
ID	Device ID.
MacAddress	MAC address of the device.
CPU	CPU usage monitoring status: · Y—CPU usage monitoring is enabled. · N—CPU usage monitoring is disabled. · -—The device does not support CPU usage monitoring.
Memory	Memory usage monitoring status: · Y—Memory usage monitoring is enabled. · N—Memory usage monitoring is disabled. · -—The device does not support memory usage monitoring.
Temperature	Temperature monitoring status: · Y—Temperature monitoring is enabled. · N—Temperature monitoring is disabled. · -—The device does not support temperature monitoring.

Related commands

winet resource-monitor

display winet tc

Use display winet tc to display member information.

Syntax

display winet tc [ tc-id ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

Parameters

tc-id: Specifies a member by its ID in the range of 1 to 255. If you do not specify a member, this command displays information about all members.

verbose: Displays detailed member information. If you do not specify this keyword, the command displays brief member information.

Examples

# Display brief information about all members.

<Sysname> display winet tc

TCID DeviceType Sysname IpAddress MacAddress Status Version

1 WS5850 S1 192.168.22.104 201c-e7c3-0300 Normal COMWAREV700R001

Table 9 Command output

Field	Description
TCID	ID of the member.
DeviceType	Device type of the member.
Sysname	Device name of the member.
IpAddress	IP address of the member.
MacAddress	MAC address of the member.
Status	Operating status of the member: · Normal—The member is operating correctly. · Offline—The member is offline.
Version	Software version of the member.

# Display detailed information about all members.

<Sysname> display winet tc verbose

TC ID : 1

Adding method : Manual

Sysname : S1

Model : WS5850-Winet

Device type : WS5850-Winet

SYSOID : 1.3.6.1.4.1.25506

MAC address : 0e74-e2fb-0400

IP address : 192.168.56.103

Boot image :

Boot image version :

System image :

System image version :

Current-configuration file :

Uptime : 2 days, 3 hours, 4 minutes

System CPU usage : 0%

System memory usage : 0%

Status : Offline

Boot-loader file :

Startup-configuration file :

Table 10 Command output

Field	Description
TC ID	ID of the member.
Adding method	Method through which the member is added to the Winet network: · Manual. · Auto.
Sysname	Device name of the member.
Model	Device model of the member.
Device type	Device type of the member.
SYSOID	SYSOID of the member.
MAC address	MAC address of the member.
IP address	IP address of the member.
Boot image	Boot image file that the member runs.
Boot image version	Version of the boot image file.
System image	System image file that the member runs.
System image version	Version of the system image file.
Current-configuration file	Current startup configuration file used by the member.
Uptime	Operation duration of the member.
System CPU usage	CPU usage on the member.
System memory usage	Memory usage on the member.
Status	Operating status of the member: · Normal—The member is operating correctly. · Offline—The member is offline.
Boot-loader file	Upgrade startup software files.
Startup-configuration file	Upgrade configuration file.

display winet tc log buffer

Use display winet tc log buffer to display log information in the log buffer on a member.

Syntax

display winet tc tc-id log buffer [ module module-name [ mnemonic mnemonic-value ] ]

Views

Any view

Predefined user roles

network-admin

Parameters

tc-id: Specifies a member by its ID in the range of 1 to 255.

module module-name: Specifies a module by its name, a case-insensitive string of 1 to 8 characters. To display module names, use the info-center source command (see information center commands in Network Management and Monitoring Command Reference).

mnemonic mnemonic-value: Specifies a mnemonic, a case-insensitive string of 1 to 32 characters.

Examples

# Display the log information for the SHELL module with the SHELL_CMD mnemonic for member 1.

<Sysname> display winet tc 1 log buffer module SHELL mnemonic SHELL_CMD

Time : 2017-07-15 13:51:46

Level : Informational

Module : SHELL

Mnemonic : SHELL_CMD

Content : -Line=con0-IPAddr=**-User=**; Command is qu

Time : 2017-07-15 13:51:39

Level : Informational

Module : SHELL

Mnemonic : SHELL_CMD

Content : -Line=con0-IPAddr=**-User=**; Command is local-user admin

Table 11 Command output

Field	Description
Time	Time when the log was generated.
Level	Log level.

display winet tc log restart

Use display winet tc log restart to display the restart log information for a member.

Syntax

display winet tc tc-id log restart

Views

Any view

Predefined user roles

network-admin

Parameters

tc-id: Specifies a member by its ID in the range of 1 to 255.

Usage guidelines

In addition to saving the logs generated by modules to the log buffer, a member sends restart logs to the commander. The commander creates a restart log buffer for each member to store their restart logs.

The commander stores a maximum of 10 restart logs for each member. The most recent restart log overwrites the oldest one when there are more than 10 restart logs for a member.

You can also use the display winet tc tc-id log buffer module SYSLOG mnemonic SYSLOG_RESTART command to display the restart log information.

Examples

# Display the restart log information for member 1.

<Sysname> display winet tc 1 log restart

Time : 2017-07-15 13:51:46

Level : Informational

Module : SYSLOG

Mnemonic : SYSLOG_RESTART

Content : System restarted -- H3C Comware Software.

Table 12 Command output

Field	Description
Time	Time when the log was generated.
Level	Log level.

Related commands

display winet tc log buffer

display winet upgrade status

Use display winet upgrade status to display member upgrade status.

Syntax

display winet upgrade status

Views

Any view

Predefined user roles

network-admin

Examples

# Display member upgrade status.

<Sysname> display winet upgrade status

ID IpAddress MacAddress Status UpdateTime UpdateFile

1 192.168.56.1 82dd-a434-0200 Finished Immediately bootloader.ipe

2 192.168.56.103 5caf-2e5f-0100 Finished Immediately bootloader.ipe

Table 13 Command output

Field	Description
ID	ID of the member.
MacAddress	MAC address of the member.
IpAddress	IP address of the member.
Status	Upgrade status: · Waiting—The member is waiting for downloading the upgrade file. · Download-failed—The member failed to download the upgrade file. · Download-finished—The member has downloaded the upgrade file. · Downloading—The member is downloading the upgrade file. · Updating—The member is upgrading. · Finished—The member has finished upgrading. · Failed—The member failed to upgrade. · Unknown—The upgrade status of the member is unknown.
Updated File	Name of the upgrade file.
UpdateTime	Upgrade time: · Immediately—Upgrade at once. · Delay(m)—Upgrade after the specified delay. · Time(HH:MM)—Upgrade at the specified time.

Related commands

winet upgrade group

winet upgrade tc

display winet vlan

Use display winet vlan to display VLAN creation results for members.

Syntax

display winet vlan

Views

Any view

Predefined user roles

network-admin

Examples

# Display VLAN creation results.

<Sysname> display winet vlan

ID IpAddress MacAddress Vlan Status

1 192.168.22.222 703d-15ad-cd02 2 Success

2 192.168.22.3 24ff-2264-0100 2 Success

3 192.168.22.4 24ff-2f74-0200 2 Success

4 192.168.22.223 487a-dac8-29ba 2 Success

Table 14 Command output

Field	Description
ID	Member ID.
IpAddress	IP address of the member.
MacAddress	MAC address of the member.
Vlan	VLAN created for the member.
Status	VLAN creation status: · Processing—The VLAN is being created. · Success—The VLAN has been created successfully. · Failure. The port xxx is not an access port—The VLAN fails to be created, because ports connected to non-Winet devices are not access ports. · Failure. xxx not exist—The VLAN fails to be created, because all access ports are connected to Winet devices.

Related commands

winet vlan

match

Use match to set a match criterion to add all matching members to a Winet group.

Use undo match to delete a match criterion.

Syntax

match { device-type device-type | ip-address ip-address { ip-mask-length | ip-mask } | mac-address mac-address mac-mask-length }

undo match { device-type device-type | ip-address ip-address { ip-mask-length | ip-mask } | mac-address mac-address mac-mask-length }

Default

No match criterion is set.

Views

Winet group view

Predefined user roles

network-admin

Parameters

device-type device-type: Sets a device type match criterion.

ip-address ip-address { ip-mask-length | ip-mask }: Sets an IP address match criterion. The ip-address argument specifies an IP address in dotted decimal notation. The ip-mask argument specifies the subnet mask in dotted decimal notation. The ip-mask-length argument specifies the subnet mask length in the range of 1 to 32.

mac-address mac-address mac-mask-length: Sets a MAC address match criterion. The mac-address argument specifies a MAC address in the format of H-H-H. The mac-mask-length argument specifies the mask length in the range of 1 to 48.

Examples

# Create a Winet group named a and add members in subnet 192.168.1.0/24 to the group.

<Sysname> system-view

[Sysname] winet group a

[Sysname-winet-group-a] match ip-address 192.168.1.0 24

Related commands

winet group

display winet group

winet auto-link-aggregation enable

Use winet auto-link-aggregation enable to enable automatic Ethernet link aggregation.

Use undo winet auto-link-aggregation enable to disable automatic Ethernet link aggregation.

Syntax

winet auto-link-aggregation enable

undo winet auto-link-aggregation enable

Default

Automatic Ethernet link aggregation is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Automatic Ethernet link aggregation is not performed between the commander and a member.

Enabling or disabling automatic Ethernet link aggregation might cause network flapping, and the members might go offline for a short period of time.

Examples

# Enable automatic Ethernet link aggregation.

<Sysname> system-view

[Sysname] winet auto-link-aggregation enable

winet auto-replace enable

Use winet auto-replace enable to enable the automatic faulty member replacement feature.

Use undo winet auto-replace enable to disable the automatic faulty member replacement feature.

Syntax

winet auto-replace enable

undo winet auto-replace enable

Default

The automatic faulty member replacement feature is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Before you execute this command, perform the following tasks:

1. Install the new member at the location where the faulty member was installed.

2. Connect all cables to the new member.

Make sure the new member and the faulty member have the same neighbor relationship, device model, and IRF member ID.

Examples

# Enable the automatic faulty member replacement feature.

<Sysname> system-view

[Sysname] winet auto-replace enable

Related commands

winet replace

winet backup configuration

Use winet backup configuration to manually back up the configuration file on members.

Syntax

winet backup configuration { group group-name-list | tc [ tc-id-list ] }

Views

System view

Predefined user roles

network-admin

Parameters

group group-name-list: Specifies a space-separated list of up to 10 Winet groups. The group name is a case-sensitive string of 1 to 31 characters.

tc tc-id-list: Specifies a space-separated list of up to 10 member items. Each item specifies a member or a range of members in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 0 to 255. If you do not specify any members, all members will perform configuration backup.

Usage guidelines

After you execute this command, the members immediately save the running configuration to the next-startup configuration files and upload the configuration files to the FTP server.

The backup configuration files are named in the format of bridge MAC address_backup.cfg.

Examples

# Back up the configuration file on member 1, member 2, member 3, and member 4.

<Sysname> system-view

[Sysname] winet backup configuration tc 1 to 4

# Back up the configuration file on all members in Winet groups test1, test2, and test3.

<Sysname> system-view

[Sysname] winet backup configuration group test1 test2 test3

Related commands

display winet configuration

winet backup configuration interval

winet backup configuration max-number

Use winet backup configuration max-number to set the maximum number of members that can perform automatic configuration backup at the same time.

Use undo winet backup configuration max-number to restore the default.

Syntax

winet backup configuration max-number max-number

undo winet backup configuration max-number

Default

A maximum of five members can perform automatic configuration backup at the same time.

Views

System view

Predefined user roles

network-admin

Parameters

max-number: Specifies the maximum number of members that can perform automatic configuration backup at the same time, in the range of 2 to 20.

Usage guidelines

The maximum number of members that can perform automatic configuration at the same time is limited by the performance of the FTP server. If automatic configuration backup fails, set the maximum number of members to a smaller value.

Examples

# Specify that a maximum of 10 members can perform automatic configuration backup at the same time.

<Sysname> system-view

[Sysname] winet backup configuration max-number 10

Related commands

display winet configuration

winet backup configuration

winet backup configuration interval

Use winet backup configuration interval to enable the automatic configuration file backup feature and set the automatic backup interval.

Use undo winet backup configuration interval to restore the default.

Syntax

winet backup configuration interval interval

undo winet backup configuration interval

Default

The automatic configuration file backup feature is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the automatic configuration file backup interval in the range of 1 to 720 hours.

Usage guidelines

This command enables the commander and members to back up their configuration files by saving the running configuration to the files and then uploading them to the FTP server. When you execute this command, the commander and members immediately perform a backup. After that, they back up the configuration files at the specified interval. The backup configuration files are named in the format of bridge MAC address_backup.cfg.

Examples

# Enable the automatic configuration file backup feature and set the backup interval to 24 hours.

<Sysname> system-view

[Sysname] winet backup configuration interval 24

Related commands

display winet configuration

winet backup configuration

winet batch-file apply

Use winet batch-file apply to specify a batch file to deploy to ports connecting APs or IP phones.

Use undo winet batch-file apply to remove a batch file specified for ports connecting APs or IP phones.

Syntax

winet batch-file batch-file-name apply { ap | phone }

undo winet batch-file apply { ap | phone }

Default

No batch file is specified for ports connecting APs or IP phones.

Views

System view

Predefined user roles

network-admin

Parameters

batch-file-name: Specifies a batch file by its name, a case-insensitive string of 1 to 255 characters.

ap: Specifies ports connecting APs.

phone: Specifies ports connecting IP phones.

Usage guidelines

When the commander detects that an AP or IP phone comes online on a port, it obtains the access device type through LLDP and deploys the command lines in the specified batch file to the port. If no batch file is specified for the device type, configuration on the port remains unchanged.

If the AP or IP phone disconnects from the port, the configurations on the port remain. When a new device comes online from the port, configurations used by the port depend on the new device type.

· If the new device is an AP or IP phone but has a different type as the disconnected device, the commander deploys new configurations to the port based on the device type. If no batch file is specified for the device type, configuration on the port remains unchanged.

· If the new device has the same device type as the disconnected device or is neither an AP nor an IP phone, configuration on the port remains unchanged.

Examples

# Specify batch file ap.cmdset for ports connecting APs or IP phones.

<Sysname> system-view

[Sysname] winet batch-file ap.cmdset apply ap

Related commands

create batch-file

winet batch-file deploy

Use winet batch-file deploy to deploy bulk command lines to a list of members or Winet groups.

Syntax

winet batch-file batch-file-name deploy { group group-name-list | tc tc-id-list }

Views

System view

Predefined user roles

network-admin

Parameters

batch-file-name: Specifies the name of a batch file, a case-insensitive string of 1 to 255 characters.

group group-name-list: Specifies a space-separated list of up to 10 Winet groups. The group name is a case-sensitive string of 1 to 31 characters.

Examples

# Deploy batch file startup.cmdset to Winet group testgroup.

<Sysname> system-view

[Sysname] winet batch-file startup.cmdset deploy group testgroup

Related commands

create batch-file

display winet batch-file status

winet enable

Use winet enable to enable Winet and set the device role.

Use undo winet enable to disable Winet.

Syntax

winet { tc | tm username username password { cipher | simple } string } enable

undo winet enable

Default

Winet is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

tc: Enables Winet and sets the device role to member.

tm: Enables Winet and sets the device role to commander.

username username: Specifies a username for the local user, a case-sensitive string of 1 to 55 characters.

password: Specifies a password for the local user.

cipher: Specifies a password in encrypted form.

simple: Specifies a password in plaintext form.

string: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 63 characters. Its encrypted form is a case-sensitive string of 1 to 117 characters.

Usage guidelines

A Winet network must have one and only one commander.

To enable Winet, execute this command on both the commander and members. To configure the other Winet features, execute associated commands only on the commander.

If you change the role of the commander to member or disable Winet on the commander, all Winet settings in its running configuration will be cleared.

Winet fails to be enabled if ACL resources are insufficient. If ACL resources are insufficient, use the undo acl command to delete unnecessary ACLs and then enable Winet. You can execute the display acl command to view ACL configuration and match statistics. For more information about ACLs, see ACL and QoS Configuration Guide.

Winet fails to be enabled if ports 80 and 443 have been used.

Examples

# Enable Winet and set the device role to member.

<Sysname> system-view

[Sysname] winet tc enable

winet ftp-server

Use winet ftp-server to configure the FTP server information.

Use undo winet ftp-server to delete the FTP server information.

Syntax

winet ftp-server server-address username username password { cipher | simple } string

undo winet ftp-server

Default

No FTP server information is configured.

Views

System view

Predefined user roles

network-admin

Parameters

server-address: Specifies an FTP server by its IP address.

username username: Specifies the FTP server username, a case-sensitive string of 1 to 55 characters.

password: Specifies the FTP server password.

cipher: Specifies a password in encrypted form.

simple: Specifies a password in plaintext form.

string: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 63 characters. Its encrypted form is a case-sensitive string of 1 to 117 characters.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the FTP server IP address, username, and password to 192.168.22.19, admin, and admin, respectively.

<Sysname> system-view

[Sysname] winet ftp-server 192.168.22.19 username admin password simple admin

Related commands

display winet configuration

winet group

Use winet group to create a Winet group and enter its view, or enter the view of an existing Winet group.

Use undo winet group to delete a Winet group.

Syntax

winet group group-name

undo winet group group-name

Default

No Winet groups exist.

Views

System view

Predefined user roles

network-admin

Parameters

group-name: Specifies the name of the Winet group, a case-sensitive string of 1 to 31 characters.

Usage guidelines

When you perform the following operations, you can specify a Winet group to apply the operations to all members in the group:

· Startup software upgrade.

· Configuration file upgrade.

· Configuration deployment.

Examples

# Create Winet group testgroup.

<Sysname> system-view

[Sysname] winet group testgroup

[Sysname-winet-group-testgroup]

Related commands

match

winet outbound

Use winet outbound to configure an outgoing interface for the Winet network.

Use undo winet outbound to restore the default.

Syntax

winet outbound

undo winet outbound

Default

No interface is used as an outgoing interface, and the Winet network cannot communicate with outside networks.

Views

Layer 3 Ethernet interface view

VLAN interface view

Predefined user roles

network-admin

Usage guidelines

VLAN interface 1 cannot be used as an outgoing interface, because the Winet network is established in VLAN 1.

Examples

# Configure GigabitEthernet 1/0/1 as an outgoing interface for the Winet network.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] winet outbound

winet resource-monitor

Use winet resource-monitor to enable resource monitoring.

Use undo winet resource-monitor to disable resource monitoring.

Syntax

winet resource-monitor [ cpu | memory | temperature ] * [ group group-name-list | tc { tc-id-list | mac-address mac-address } | tm ]

undo winet resource-monitor [ cpu | memory | temperature ] * [ group group-name-list | tc { tc-id-list | mac-address mac-address } | tm ]

Default

Resource monitoring is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

cpu: Enables CPU usage monitoring.

memory: Enables memory usage monitoring.

temperature: Enables temperature monitoring.

group group-name-list: Specifies the Winet groups to monitor. You can specify a space-separated list of up to 10 Winet groups. The group name is a case-sensitive string of 1 to 31 characters.

tc: Specifies the members to monitor.

tc-id-list: Specifies a space-separated list of up to 10 member items. Each item specifies a member or a range of members in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 1 to 255.

mac-address mac-address: Specifies a member by its MAC address in the format of H-H-H.

tm: Enables resource monitoring on the commander.

Usage guidelines

If you do not specify a resource type, this command enables resource monitoring for all resource types.

If you do not specify a device to monitor (member or the commander), this command enables resource monitoring on the commander and all members.

Examples

# Enable resource monitoring for all resource types on member 1 through member 3.

<Sysname> system-view

[Sysname] winet resource-monitor tc 1 to 3

Related commands

display winet resource-monitor

winet resource-monitor interval

winet resource-monitor max-age

winet resource-monitor interval

Use winet resource-monitor interval to set the interval for the commander to obtain resource monitoring information.

Use undo winet resource-monitor interval to restore the default.

Syntax

winet resource-monitor interval interval

undo winet resource-monitor interval

Default

The interval for the commander to obtain resource monitoring information is 1 minute.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for the commander to obtain resource monitoring information, in the range of 1 to 60 minutes.

Examples

# Set the interval for the commander to obtain resource monitoring information to 5 minutes.

<Sysname> system-view

[Sysname] winet resource-monitor interval 5

Related commands

display winet resource-monitor

winet resource-monitor

winet resource-monitor max-age

Use winet resource-monitor max-age to set the aging time for resource monitoring information.

Use undo winet resource-monitor max-age to restore the default.

Syntax

winet resource-monitor max-age max-age

undo winet resource-monitor max-age

Default

The aging time for resource monitoring information is 24 hours.

Views

System view

Predefined user roles

network-admin

Parameters

max-age: Specifies the aging time for resource monitoring information, in the range of 1 to 168 hours.

Examples

# Set the aging time for resource monitoring information to 1 hour.

<Sysname> system-view

[Sysname] winet resource-monitor max-age 1

Related commands

display winet resource-monitor

winet resource-monitor

winet replace

Use winet replace to manually replace a faulty member.

Syntax

winet replace tc tc-id1 faulty-tc tc-id2

Views

System view

Predefined user roles

network-admin

Parameters

tc tc-id1: Specifies the ID of the new member, in the range of 1 to 255.

faulty-tc tc-id2: Specifies the ID of the faulty member, in the range of 1 to 255.

Usage guidelines

Before you execute this command, perform the following tasks:

1. Install the new member at the location where the faulty member was installed.

2. Connect all cables to the new member.

Make sure the new member and the faulty member have the same neighbor relationship, device model, and IRF member ID.

Examples

# Replace faulty member 5 with new member 10.

<Sysname> system-view

[Sysname] winet replace tc 10 faulty-tc 5

Related commands

display winet replace status

winet auto-replace enable

winet tc boot-loader

Use winet tc boot-loader to specify the upgrade startup software files for a member.

Use undo winet tc boot-loader to remove the configuration.

Syntax

winet tc tc-id boot-loader { ipe-filename | boot boot-filename system system-filename }

undo winet tc tc-id boot-loader

Views

System view

Predefined user roles

network-admin

Parameters

tc tc-id: Specifies a member by its ID in the range of 1 to 255.

ipe-filename: Specifies an IPE software file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .ipe extension.

boot boot-filename: Specifies a boot image file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .bin extension.

system system-filename: Specifies a system image file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .bin extension.

Examples

# Specify upgrade boot image boot.bin and upgrade system image system.bin for member 1.

<Sysname> system-view

[Sysname] winet tc 1 boot-loader boot boot.bin system system.bin

Related commands

display winet tc

winet tc device-type

Use winet tc device-type to define a member type on the commander.

Use undo winet tc device-type to delete a member type.

Syntax

winet tc sysoid sysoid device-type device-type

undo winet tc sysoid sysoid device-type device-type

Views

System view

Predefined user roles

network-admin

Parameters

sysoid sysoid: Specifies the SYSOID of a member.

device-type device-type: Specifies a member type.

Usage guidelines

To obtain the SYSOID of a member, use the display winet tc verbose command.

Examples

# Define a member type by specifying the SYSOID as 1.3.6.1.4.1.25506.1.1588 and the member type as SW.

<Sysname> system-view

[Sysname] winet tc sysoid 1.3.6.1.4.1.25506.1.1588 device-type SW

winet tc password

Use winet tc password to modify the password for the default user on members.

Syntax

winet tc password string

Views

System view

Predefined user roles

network-admin

Parameters

string: Specifies a password, a case-sensitive string of 1 to 63 characters.

Usage guidelines

During Winet network establishment, the commander establishes NETCONF sessions to members and adds them to the network. The default username and password on the members for NETCONF session establishment are admin and admin. To enhance security, you can perform this task to change the password for the default user admin of the members after the commander adds the members to the network.

Do not modify the password for members that are manually added to the Winet network. If you modify the password for a manually added member, you will not be able to manage that member from the commander.

Examples

# Modify the password to Admin123 for the default user on members.

<Sysname> system-view

[Sysname] winet tc password Admin123

winet tc startup-configuration

Use winet tc startup-configuration to specify the upgrade configuration file for a member.

Use undo winet tc startup-configuration to remove the configuration.

Syntax

winet tc tc-id startup-configuration cfg-filename

undo winet tc tc-id startup-configuration

Views

System view

Predefined user roles

network-admin

Parameters

tc tc-id: Specifies a member by its ID in the range of 1 to 255.

cfg-filename: Specifies a configuration file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .cfg extension.

Examples

# Specify upgrade configuration file startup.cfg for member 1.

<Sysname> system-view

[Sysname] winet tc 1 startup-configuration startup.cfg

Related commands

display winet tc

winet topology-refresh

Use winet topology-refresh to manually refresh the network topology.

Syntax

winet topology-refresh

Views

Any view

Predefined user roles

network-admin

Usage guidelines

To display topology changes, use this command to manually refresh the topology.

Examples

# Manually refresh the network topology.

<Sysname> winet topology-refresh

Related commands

display winet device-link

winet topology-refresh interval

Use winet topology-refresh interval to set the automatic network topology refresh interval.

Use undo winet topology-refresh interval to restore the default.

Syntax

winet topology-refresh interval interval

undo winet topology-refresh interval

Default

The automatic network topology refresh interval is 60 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the automatic network topology refresh interval in the range of 60 to 300 seconds.

Examples

# Set the automatic network topology refresh interval to 100 seconds.

<Sysname> system-view

[Sysname] winet topology-refresh interval 100

Related commands

display winet device-link

winet topology-save

Use winet topology-save to save the current network topology.

Syntax

winet topology-save

Views

System view

Predefined user roles

network-admin

Usage guidelines

This task allows you to save the current network topology to the topology.dba file in the flash memory. After the commander reboots, it uses the topology.dba file to restore the network topology.

Examples

# Save the current network topology

<Sysname> system-view

[Sysname] winet topology-save

Related commands

display winet device-link

winet upgrade boot-loader

Use winet upgrade boot-loader to upgrade the startup software on a list of members or Winet groups.

Use undo winet upgrade delete the startup software upgrade task.

Syntax

winet upgrade boot-loader { group | tc } list [ delay minutes | time time ]

winet upgrade boot-loader { group | tc } { list { boot boot-filename system system-filename | file ipe-filename } }&<1-40> [ delay delay-time | time time ]

undo winet upgrade

Views

System view

Predefined user roles

network-admin

Parameters

group: Specifies the Winet groups to be upgraded.

tc: Specifies the members to be upgraded.

list: Specifies a space-separated list of up to 10 member items or Winet group items.

· Winet group—Each item specifies a Winet group name, a case-sensitive string of 1 to 31 characters.

· Member—Each item specifies a member ID or a range of member IDs in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 1 to 255.

boot boot-filename: Specifies a boot image by its name.

system system-filename: Specifies a system image by its name.

file ipe-filename: Specifies an IPE file by its name, a case-insensitive string of 5 to 45 characters.

delay delay-time: Specifies the upgrade delay time in the range of 1 to 1440 minutes.

time in-time: Specifies the upgrade time in the format of hh:mm. The value range for the hh argument is 0 to 23 hours. The value range for the mm argument is 0 to 59 minutes.

Usage guidelines

To use this command to upgrade the startup software on members without specifying the upgrade files, you must first perform one of the following tasks:

· Execute the winet tc boot-loader command to specify the upgrade files for members.

· Execute the boot-loader command to specify the upgrade files for a Winet group.

A member can perform only one upgrade task at a time.

If you execute this command without specifying the delay time or update time, the members or Winet group immediately upgrades the startup software and the upgrade operation cannot be cancelled. If you specify a delay time or upgrade time to perform a scheduled upgrade, the upgrade operation can be cancelled by using the undo winet upgrade command before it starts.

Examples

# Upgrade startup software images boot.bin and sys.bin on all members in Winet groups test1 and test2.

<Sysname> system-view

[Sysname] winet upgrade boot-loader group test1 test2 boot boot.bin system sys.bin

Related commands

boot-loader

startup-configuration

winet upgrade startup-configuration

Use winet upgrade startup-configuration to upgrade the configuration file on a list of members or on all members in Winet groups.

Use undo winet upgrade delete the configuration file upgrade task.

Syntax

winet upgrade startup-configuration { group | tc } list [ delay minutes | time time ]

winet upgrade startup-configuration { group | tc } { list cfg-filename }&<1-40> [ delay delay-time | time time ]

undo winet upgrade

Views

System view

Predefined user roles

network-admin

Parameters

group: Specifies the Winet groups to be upgraded.

tc: Specifies the members to be upgraded.

list: Specifies a space-separated list of up to 10 member items or Winet group items.

· Winet group—Each item specifies a Winet group name, a case-sensitive string of 1 to 31 characters.

cfg-filename: Specifies a configuration file by its name.

delay delay-time: Specifies the upgrade delay time in the range of 1 to 1440 minutes.

time in-time: Specifies the upgrade time in the format of hh:mm. The value range for the hh argument is 0 to 23 hours. The value range for the mm argument is 0 to 59 minutes.

Usage guidelines

To use this command to upgrade the configuration file on members without specifying the upgrade file, you must first perform one of the following tasks:

· Execute the winet tc startup-configuration command to specify the upgrade file for members.

· Execute the startup-configuration command to specify the upgrade file for a Winet group.

A member can perform only one upgrade task at a time.

If you execute this command without specifying the delay time or update time, the members or Winet group immediately upgrades the configuration file and the upgrade operation cannot be cancelled. If you specify a delay time or upgrade time to perform a scheduled upgrade, the upgrade operation can be cancelled by using the undo winet upgrade command before it starts.

Examples

# Upgrade configuration file startup.cfg on all members in Winet groups test1 and test2.

<Sysname> system-view

[Sysname] winet upgrade boot-loader group test1 test2 boot boot.bin system sys.bin

Related commands

boot-loader

startup-configuration

winet vlan

Use winet vlan to create a VLAN for members.

Syntax

winet vlan vlan-id { group group-name-list | tc tc-id-list }

Views

System view

Predefined user roles

network-admin

Parameters

vlan-id: Specifies the VLAN ID in the range of 1 to 4094.

group group-name-list: Specifies the Winet groups for which the VLAN is created. You can specify a space-separated list of up to 10 Winet groups. The group name is a case-sensitive string of 1 to 31 characters.

tc tc-id-list: Specifies the members for which the VLAN is created. You can specify a space-separated list of up to 10 member items. Each item specifies a member or a range of members in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 1 to 255.

Usage guidelines

Execute this command when the network topology is stable. As a best practice, use the winet topology-refresh command to refresh the network topology before executing this command.

After you execute this command, all access ports on members except the following access ports are assigned to the VLAN:

· Access ports connecting to the commander.

· Access ports connecting to other members.

· Access ports connecting to offline devices. Remove offline devices before configuring this command.

If the VLAN is successfully created but some access ports of a member cannot be assigned to the VLAN, the VLAN memberships of the member is restored to the state before the VLAN is created.

The failure to assign an access port of a member to the created VLAN does not affect the VLAN assignment for other members.

After command execution, you can use the display winet vlan command to examine the VLAN creation result.

Examples

# Create a VLAN for member 1 and member 2.

<Sysname> system-view

[Sysname] winet vlan 2 tc 1 to 2

As a best practice, execute the display winet vlan command to verify that the VLAN has been created successfully.

startup-configuration

Use startup-configuration to specify an upgrade configuration file for a Winet group .

Use undo startup-configuration to restore the default.

Syntax

startup-configuration cfgfile

undo startup-configuration

Default

No upgrade configuration file is specified for the Winet group.

Views

Winet group view

Predefined user roles

network-admin

Parameters

cfgfile: Specifies a configuration file by its name, a string of 5 to 45 characters. The file name must include the .cfg extension.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Specify configuration file startup.cfg for Winet group testgroup.

<Sysname> system-view

[Sysname] winet group testgroup

[Sysname-winet-group-testgroup] startup-configuration startup.cfg

Related commands

winet group

Products & Technology

Solutions

Support

Training & Certification

Partners

About Us

11-Network Management and Monitoring Command Reference

Winet commands

display winet vlan

winet tc boot-loader

winet topology-refresh

winet upgrade boot-loader

winet upgrade startup-configuration

startup-configuration