Login
- Table of Contents
-
- 20-Network Management and Monitoring Command Reference
- 00-Preface
- 01-Ping and tracert commands
- 02-System debugging commands
- 03-NQA commands
- 04-SNMP commands
- 05-RMON commands
- 06-NETCONF commands
- 07-Process monitoring and maintenance commands
- 08-Mirroring commands
- 09-UCC commands
- 10-SQA commands
- 11-Packet capture commands
- 12-Email Notification Service Commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 09-UCC commands | 125.74 KB |
Contents
application-subcategory rate-limit
application-subcategory remark
display apr wlan-signature library
UCC commands
application enable
Use application enable to enable UCC for an audio or video application.
Use undo application enable to disable UCC for an audio or video application.
Syntax
application app-name enable
undo application app-name enable
Default
UCC is disabled for audio and video applications.
Views
UCC profile view
Predefined user roles
network-admin
Parameters
app-name: Specifies an application name.
Usage guidelines
With UCC enabled for an audio or video application, the wireless service bound to the UCC profile will preferentially forward traffic from that application for wireless users that use the application to obtain higher-quality services.
Examples
# Enable UCC for FeiShu.
<Sysname> system-view
[Sysname] ucc profile ssidcompany
[Sysname-ucc-profile-ssidcompany] application feishu enable
Related commands
ucc profile
application flow-mark
Use application flow-mark to configure priority marking for traffic from an audio or video application.
Use undo application flow-mark to restore the default.
Syntax
application app-name flow-mark
undo application app-name flow-mark
Default
Priority marking is not configured for traffic from audio and video applications.
Views
UCC profile view
Predefined user roles
network-admin
Parameters
app-name: Specifies an application name.
Usage guidelines
Priority marking marks the priority of uplink traffic for an audio or video application and sends the priority to other service modules for them to process the traffic as configured.
Examples
# Configure priority marking for Tencent Meeting traffic.
<Sysname> system-view
[Sysname] ucc profile ssidcompany
[Sysname-ucc-profile-ssidcompany] application tencentmeeting flow-mark
Related commands
ucc profile
application-subcategory drop
Use application-subcategory drop to drop packets of an application in the specified subcategory.
Use undo application-subcategory drop to restore the default.
Syntax
application-subcategory appsubcategory [ app app-name ] drop
undo application-subcategory appsubcategory [ app app-name ] drop
Default
The device does not drop application packets.
Views
UCC profile view
Predefined user roles
network-admin
Parameters
appsubcategory: Specifies the name of the application subcategory. The name is defined by the device automatically. You can obtain the name by using the application-subcategory ？command.
app app-name: Specifies the name of the application. The name is defined by the device automatically. You can obtain the name by using the application-subcategory appsubcategory app ? command. If you do not specify this option, the command drops packets of all applications in the subcategory.
Usage guidelines
With this feature configured, the device drops application packets specified by the client. In this case, the wireless service bound to the UCC profile cannot provide the corresponding application services.
After configuring the device to drop packets of all applications in the specified subcategory, you cannot configure a specific application any more.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure the device to drop packets of YouKu in the Streaming_Media application subcategory.
<Sysname> system-view
[Sysname] ucc profile ssidcompany
[Sysname-ucc-profile-ssidcompany] application-subcategory streaming_media app youku drop
application-subcategory rate-limit
Use application-subcategory rate-limit to enable and specify a packet rate limit for an application in the specified subcategory.
Use undo application-subcategory rate-limit to disable packet rate limit for an application in the specified subcategory.
Syntax
application-subcategory appsubcategory [ app app-name ] rate-limit rate
undo application-subcategory appsubcategory [ app app-name ] rate-limit
Default
Rate limit for application packets is disabled.
Views
UCC profile view
Predefined user roles
network-admin
Parameters
appsubcategory: Specifies the name of the application subcategory. The name is defined by the device automatically. You can obtain the name by using the application-subcategory ？command.
app app-name: Specifies the name of the application. The name is defined by the device automatically. You can obtain the name by using the application-subcategory appsubcategory app ? command. If you do not specify this option, the command set rate limit for all application packets in the subcategory.
rate: Specifies the rate limit, in the range of 64 to 10000000 kbps.
Usage guidelines
With this feature enabled, the wireless service bound to the UCC profile restricts the packet rate of a specified application. In a scenario featuring a large traffic volume, to ensure the service quality of key applications, you can set low rate limits for non-key application packets and high rate limits for key application packets.
After specifying a rate limit for packets of all applications in a specified subcategory, you cannot configure a specific application any more.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Specify the rate limit as 100 kbps for packets of YouKu in the Streaming_Media subcategory.
<Sysname> system-view
[Sysname] ucc profile ssidcompany
[Sysname-ucc-profile-ssidcompany] application-subcategory streaming_media app youku rate-limit 100
application-subcategory remark
Use application-subcategory remark to specify packet priorities for an application in the specified subcategory.
Use undo application-subcategory remark to restore the default.
Syntax
application-subcategory appsubcategory [ app app-name ] remark { dot1p dot1p-value | dscp dscp-value }
undo application-subcategory appsubcategory [ app app-name ] remark
Default
DSCP and 802.1p priorities for packets of an application in the subcategory are defined by the application itself.
Views
UCC profile view
Predefined user roles
network-admin
Parameters
appsubcategory: Specifies the name of the application subcategory. The name is defined by the device automatically. You can obtain the name by using the application-subcategory ？command.
app app-name: Specifies the name of the application. The name is defined by the device automatically. You can obtain the name by using the application-subcategory appsubcategory app ? command. If you do not specify this option, the command set rate limit for all application packets in the subcategory.
dscp dscp-value: Specifies the DSCP priority, in the range of 0 to 63. A greater number indicates a higher priority.
dot1p dot1p-value: Specifies the 802.1p priority, in the range of 0 to 7. A greater number indicates a higher priority.
Usage guidelines
With this feature configured, the wireless service bound to the UCC profile modifies the DSCP and 802.1p priorities of packets for an application in a specified subcategory.
If you configure this feature with UCC enabled for an audio or video application for the same UCC profile, packets whose priorities are specified by this feature take precedence.
After specifying packet priorities for all applications in the specified subcategory, you cannot configure a specific application any more.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Specify the DSCP priority as 30 for packets of YouKu in the Streaming_Media subcategory.
<Sysname> system-view
[Sysname] ucc profile ssidcompany
[Sysname-ucc-profile-ssidcompany] application-subcategory streaming_media app youku remark dscp 30
apr wlan-signature update
Use apr wlan-signature update to bulk upgrade APR signature libraries for APs on the AC.
Syntax
apr wlan-signature update { file-name | default }
Views
System view
Predefined user roles
network-admin
Parameters
file-name: Specifies the name of the compressed package file containing the APR signature library file and brief application information file, a string of 1 to 255 characters with the suffix .dat.
default: Restores the APR signature library of the AP to the factory default signature library.
Usage guidelines
For the audio and video feature of the UCC module to take effect on an AP, you also need to configure the DPI application identification feature. DPI application identification depends on the APR signature library. To ensure correct audio and video operation, upgrade the APR signature library on the AP in time. In a distributed AP network environment with AC + fit AP deployed, one AC might manage multiple APs. If the audio and video feature of the UCC module is enabled for multiple APs, use this command to upgrade the APR signature library for the APs in bulk.
Examples
# Bulk upgrade APR signature libraries for APs.
<Sysname> system-view
[Sysname] apr wlan-signature update tmp.dat
display apr wlan-signature library
Use display apr wlan-signature library to display APR signature library version information on the AC.
Syntax
display apr wlan-signature library
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
In a distributed AP network environment with AC + fit AP deployed, you can execute this command to obtain the version information of the APR signature library on the AC. This allows you to check the APR signature library version information for the fit AP, or to upgrade the APR signature library for the AP on the AC.
Examples
# Display APR signature library version information on the AC.
<Sysname> display apr wlan-signature library
APR wlan-signature library information:
Type SigVersion ReleaseTime Size
Current 1.0.26 Mon Jun 27 07:50:52 2022 223792
Factory 1.0.0 Tue Feb 19 08:54:52 2019 234400
Table 1 Command output
|
Field |
Description |
|
Type |
APR signature library version. Options include: · Current—Current version. · Factory—Factory default version. |
|
SigVersion |
APR signature library version number. |
|
ReleaseTime |
Time when the APR signature library was released. |
|
Size |
Size of the APR signature library in bytes. |
display ucc profile
Use display ucc profile to display configuration information for UCC profiles.
Syntax
display ucc profile [ profile-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
profile-name: Specifies a UCC profile by its name, a case-insensitive string of 1 to 31 characters. If you do not specify a UCC profile, this command displays configuration information for all UCC profiles.
Examples
# Display configuration information for all UCC profiles.
<Sysname> display ucc profile
UCC profile information:
UCC profile name: ssidcompany1
UCC-enabled applications: tencentmeeting
Traffic-marking enabled applications: tencentmeeting
Total UCC profiles: 1
Table 2 Command output
|
Field |
Description |
|
UCC-enabled applications |
List of applications that are already enabled with UCC. |
|
Traffic-marking enabled applications |
List of applications that are already enabled with traffic priority marking. |
Related commands
application enable
application flow-mark
display ucc whitelist ap
Use display ucc whitelist ap to display UCC AP whitelist.
Syntax
display ucc whitelist ap
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display UCC AP whitelist.
<Sysname> display ucc whitelist ap
AP Whitelist Entry Info:
AP name: ap1, ap2, ap3
Related commands
ucc whitelist ap
display ucc whitelist ap-group
Use display ucc whitelist ap-group to display UCC AP group whitelist.
Syntax
display ucc whitelist ap-group
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display UCC AP group whitelist.
<Sysname> display ucc whitelist ap-group
AP-group Whitelist Entry Info：
Group name: apg1, apg2
Related commands
ucc whitelist ap-group
ucc profile
Use ucc profile to create a UCC profile and enter its view, or enter the view of an existing UCC profile.
Use undo ucc profile to delete a UCC profile.
Syntax
ucc profile profile-name
undo ucc profile profile-name
Default
No UCC profiles exist.
Views
System view
Predefined user roles
network-admin
Parameters
profile-name: Specifies the name of a UCC profile, a case-insensitive string of 1 to 31 characters. The UCC profile name can contain hyphens (-), underscores (_), left brackets ([), right brackets (]), and slashes (/).
Examples
# Create UCC profile ssidcompany and enter its view.
<Sysname> system-view
[Sysname] ucc profile ssidcompany
[Sysname-ucc-profile-ssidcompany]
Related commands
display ucc profile
ucc-profile
ucc whitelist ap
Use ucc whitelist ap to configure the UCC AP whitelist.
Use undo ucc whitelist ap to delete table entries from the UCC AP whitelist.
Syntax
ucc whitelist ap ap-name
undo ucc whitelist ap [ ap-name ]
Default
The UCC AP whitelist is not specified, and the UCC information of an AC can be reported to AC.
Views
System view
Predefined user roles
network-admin
Parameters
ap-name: Specifies an AP name, a case-sensitive string of 1 to 64 characters. Only letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), slashes (/), and hyphens (-) are allowed. If you do not specify this argument, this command deletes all table entries from the UCC AP white list.
Restrictions and guidelines
Perform this task to allow only APs that belong to the UCC AP or AP group white list to collect and report UCC statistics to AC, reducing AC pressure from too many AP reports. In this way, pressure is also released for APs that do not belong to the UCC AP or AP group white list, because they no longer collect or report UCC statistics to AC.
Only UCC APs for audio and video traffic are restricted by the whitelist.
Examples
# Add AP ap1 to the UCC AP whitelist.
<Sysname> system-view
[Sysname] ucc whitelist ap ap1
Related commands
display ucc whitelist ap
ucc whitelist ap-group
ucc whitelist ap-group
Use ucc whitelist ap-group to configure the UCC AP group whitelist.
Use undo ucc whitelist ap-group to delete table entries from the UCC AP group whitelist.
Syntax
ucc whitelist ap-group group-name
undo ucc whitelist ap-group [ group-name ]
Default
UCC AP group whitelist is not specified.
Views
System view
Predefined user roles
network-admin
Parameters
group-name: Specifies an AP group name, a case-insensitive string of 1 to 31 characters. If you do not specify this argument, this command deletes all table entries from the UCC AP group white list.
Restrictions and guidelines
Perform this task to allow only APs that belong to the UCC AP or AP group white list to collect and report UCC statistics to AC, reducing AC pressure from too many AP reports. In this way, pressure is also released for APs that do not belong to the UCC AP or AP group white list, because they no longer collect or report UCC statistics to AC.
Only UCC APs for audio and video traffic are restricted by the whitelist.
Examples
# Add AP group apg1 to the UCC AP group whitelist.
<Sysname> system-view
[Sysname] ucc whitelist ap-group apg1
Related commands
display ucc whitelist ap-group
ucc whitelist ap
ucc-profile
Use ucc-profile to bind a UCC profile to a service template.
Use undo ucc-profile to unbind a UCC profile from a service template.
Syntax
ucc-profile profile-name
undo ucc-profile
Default
No UCC profile is bound to a service template.
Views
Service template view
Predefined user roles
network-admin
Parameters
profile-name: Specifies a UCC profile by its name, a case-insensitive string of 1 to 31 characters.
Usage guidelines
Use this command to enable a service template to optimize and analyze audio and video traffic for wireless clients associated with the service template.
You can bind only one UCC profile to a service template. To bind a different UCC profile to the service template, first unbind the existing UCC profile from the service template.
Examples
# Bind UCC profile ssidcompany to service template service.
<Sysname> system-view
[Sysname] ucc profile ssidcompany
[Sysname-ucc-profile-ssidcompany] sip enable
[Sysname-ucc-profile-ssidcompany] quit
[Sysname] wlan service-template service
[Sysname-wlan-st-service] ucc-profile ssidcompany
Related commands
sip enable
ucc profile
