Login
- Table of Contents
-
- 12-WLAN Advanced Features Command Reference
- 00-Preface
- 01-WLAN optimization commands
- 02-Hotspot 2.0 commands
- 03-WLAN probe commands
- 04-WSA commands
- 05-Wireless location commands
- 06-WLAN process maintenance commands
- 07-Bonjour gateway commands
- 08-WLAN mesh commands
- 09-AC hierarchy commands
- 10-WLAN forwarding commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 07-Bonjour gateway commands | 160.57 KB |
bonjour (AP view/AP group view)
display bonjour active-service-type
rrop anti-bmc protocol ipv6 bonjour
Bonjour gateway commands
bonjour (AP view/AP group view)
Use bonjour enable to enable Bonjour gateway for an AP.
Use bonjour disable to disable Bonjour gateway for an AP.
Use undo bonjour to restore the default.
Syntax
bonjour { disable | enable }
undo bonjour
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, Bonjour gateway is enabled for APs in an AP group.
Views
AP view
AP group view
Predefined user roles
network-admin
Usage guidelines
Bonjour gateway snoops the mDNS packets from wireless clients and service devices. For the Bonjour gateway on an AP to take effect, you must also enable Bonjour gateway globally.
Examples
# Enable Bonjour gateway for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] bonjour enable
# Enable Bonjour gateway for AP group office.
<Sysname> system-view
[Sysname] wlan ap-group office
[Sysname-ap-group-office] bonjour enable
Related commands
bonjour global enable
bonjour (interface view)
Use bonjour enable to enable Bonjour gateway for an interface.
Use undo bonjour enable to disable Bonjour gateway for an interface.
Syntax
bonjour enable
undo bonjour enable
Default
Bonjour gateway is enabled.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
Bonjour gateway snoops the mDNS packets on interfaces. For the Bonjour gateway on an interface to take effect, you must also enable Bonjour gateway globally.
Examples
# Enable Bonjour gateway for the interface GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] bonjour enable
bonjour activate service type
Use bonjour activate service type to activate a Bonjour service type.
Use undo bonjour activate service type to restore the default.
Syntax
bonjour activate service type { pre-defined-service-type | user-define user-defined-service-type } [ max-entry-count count-value ]
undo bonjour activate service type { pre-defined-service-type | user-define user-defined-service-type }
Default
If the Bonjour gateway operates in custom service mode, no service type is activated.
If the Bonjour gateway operates in typical mode, only the airplay, ipp, ipps, printer, and raop service types are activated.
The number of service entries for each service type is not limited.
Views
System view
Predefined user roles
network-admin
Parameters
pre-defined-service-type: Specifies a default service type. Table 1 lists the default service types by their names and service type strings.
Table 1 Apple Bonjour protocols and service type strings
|
Name |
Service type strings |
|
afpovertcp |
AppleTalkFiling Protocol |
|
airplay |
Airplay |
|
airport |
Airport Base Station |
|
apple-sasl |
Apple Password Server |
|
daap |
Digital Audio Access Protocol |
|
dacp |
Digital Audio Control Protocol |
|
distcc |
Distributed Compiler |
|
dpap |
Digital Photo Access Protocol |
|
eppc |
Remote AppleEvents |
|
ftp |
File Transfer Protocol |
|
http |
Hypertext Transfer Protocol |
|
ica-networking |
Image Capture Sharing |
|
ichat |
iChat Instant Messaging Protocol |
|
ipp |
Internet Printing Protocol |
|
ipps |
Internet Printing Protocol |
|
nfs |
Network File System |
|
pdl-stream |
PDL Data Stream |
|
printer |
Line Printer Daemon |
|
raop |
Remote Audio Output Protocol |
|
riousbprint |
Remote I/O USB Printer Protocol |
|
servermgr |
Server Admin |
|
ssh |
Secure Shell |
|
telnet |
Remote Login |
|
webdav |
WebDav File System |
|
workstation |
Workgroup Manager |
|
xserveraid |
Xerver RAID |
user-defined user-defined-service-type: Specifies a user-defined service type by its name, a case-insensitive string of 1 to 15 characters. The user-defined service types cannot have the same names as the default service types.
max-entry-count count-value: Specifies the maximum number of service entries for each service type, in the range of 1 to 65535. If you do not specify this option, no limit is set for the number of service entries for each service type.
Usage guidelines
Modifying or deleting the max-entry-count count-value option does not affect existing service entries.
Deactivating a service type removes all service entries of the service type.
This command is not available when the custom service mode is used.
Examples
# Activate the airport service type, and set the maximum number of service entries for the service type to 10.
<Sysname> system-view
[Sysname] bonjour activate service type airport max-entry-count 10
bonjour apply policy
Use bonjour apply policy to apply a Bonjour policy.
Use undo bonjour apply policy to restore the default.
Syntax
bonjour apply policy policy-name
undo bonjour apply policy
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, no Bonjour policy is applied.
In service template view, no Bonjour policy is applied.
In user profile view, no Bonjour policy is applied.
In interface view, no Bonjour policy is applied.
Views
AP view
AP group view
Service template view
User profile view
Interface view
Predefined user roles
network-admin
Parameters
policy-name: Specifies a Bonjour policy by its name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
You can apply a Bonjour policy to an AP, an AP group, a service template, or a user profile. If you apply different Bonjour policies in different views, all these Bonjour policies take effect.
You can apply a Bonjour policy to a Layer 2 Ethernet interface or Layer 2 aggregate interface to manage the services that can be queried by wired clients.
Examples
# Apply Bonjour policy teacher to AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] bonjour apply policy teacher
# Apply Bonjour policy teacher to AP group office.
<Sysname> system-view
[Sysname] wlan ap-group office
[Sysname-ap-group-office] bonjour apply policy teacher
# Apply Bonjour policy teacher to service template 1.
<Sysname> system-view
[Sysname] wlan service-template 1
[Sysname-wlan-st-1] bonjour apply policy teacher
# Apply Bonjour policy teacher to user profile a123.
<Sysname> system-view
[Sysname] user-profile a123
[Sysname-user-profile-a123] bonjour apply policy teacher
# Apply Bonjour policy teacher to GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] bonjour apply policy teacher
Related commands
bonjour policy
bonjour global enable
Use bonjour global enable to enable Bonjour gateway globally.
Use undo bonjour global enable to disable Bonjour gateway globally.
Syntax
bonjour global enable
undo bonjour global enable
Default
Bonjour gateway is disabled globally.
Views
System view
Predefined user roles
network-admin
Usage guidelines
Bonjour gateway takes effect only when you enable it both globally and for an AP.
Examples
# Enable Bonjour gateway globally.
<Sysname> system-view
[Sysname] bonjour global enable
Related commands
bonjour enable
bonjour policy
Use bonjour policy to create a Bonjour policy and enter its view, or enter the view of an existing Bonjour policy.
Use undo bonjour policy to delete a Bonjour policy.
Syntax
bonjour policy policy-name
undo bonjour policy policy-name
Default
The default Bonjour policy default exists and cannot be modified or deleted.
The default Bonjour policy allows clients to request the airplay, ipp, ipps, and printer services in all VLANs.
Views
System view
Predefined user roles
network-admin
Parameters
policy-name: Specifies a Bonjour policy name, a case-sensitive string of 1 to 31 characters. The name default cannot be specified.
Examples
# Create a Bonjour policy named teacher.
<Sysname> system-view
[Sysname] bonjour policy teacher
Related commands
bonjour apply policy
bonjour query
Use bonjour query to enable active query for Bonjour services.
Use undo bonjour query to disable active query for Bonjour services.
Syntax
bonjour query
undo bonjour query
Default
Active query for Bonjour services is disabled and passive query is in effect.
Views
System view
Predefined user roles
network-admin
Usage guidelines
Passive query might cause the Bonjour gateway to be unable to learn service information when the following conditions are met:
· Queries or responses are discarded because of network failures.
· Service advertisements are intercepted by other gateways.
Active query enables the Bonjour gateway to send queries for a Bonjour service at the specified interval and update the service entry based on the responses.
Examples
# Enable active query for Bonjour services.
<Sysname> system-view
[Sysname] bonjour query
Related commands
bonjour query interval
bonjour query interval
Use bonjour query interval to set the interval at which the Bonjour gateway sends queries for a service.
Use undo bonjour query interval to restore the default.
Syntax
bonjour query interval interval-number
undo bonjour query interval
Default
The Bonjour gateway sends queries for a service every 15 minutes.
Views
System view
Predefined user roles
network-admin
Parameters
interval-number: Specifies the interval at which the Bonjour gateway sends queries for a service, in the range of 10 to 120 minutes.
Examples
# Set the interval at which the Bonjour gateway sends queries for a service to 30 minutes.
<Sysname> system-view
[Sysname] bonjour query interval 30
Related commands
bonjour query
bonjour service type
Use bonjour service type to create a Bonjour service type.
Use undo bonjour service type to remove a Bonjour service type.
Syntax
bonjour service type user-defined-service-type { tcp | udp } description text
undo bonjour service type user-defined-service-type
Default
Default service types as shown in Table 2 exist on the device.
Table 2 Apple Bonjour protocols and service type strings
|
Name |
Service type strings |
|
afpovertcp |
AppleTalkFiling Protocol |
|
airplay |
Airplay |
|
airport |
Airport Base Station |
|
apple-sasl |
Apple Password Server |
|
daap |
Digital Audio Access Protocol |
|
dacp |
Digital Audio Control Protocol |
|
distcc |
Distributed Compiler |
|
dpap |
Digital Photo Access Protocol |
|
eppc |
Remote AppleEvents |
|
ftp |
File Transfer Protocol |
|
http |
Hypertext Transfer Protocol |
|
ica-networking |
Image Capture Sharing |
|
ichat |
iChat Instant Messaging Protocol |
|
ipp |
Internet Printing Protocol over HTTP |
|
ipps |
Internet Printing Protocol over HTTPS |
|
nfs |
Network File System |
|
pdl-stream |
PDL Data Stream |
|
printer |
Line Printer Daemon |
|
raop |
Remote Audio Output Protocol |
|
riousbprint |
Remote I/O USB Printer Protocol |
|
servermgr |
Server Admin |
|
ssh |
Secure Shell |
|
telnet |
Remote Login |
|
webdav |
WebDav File System |
|
workstation |
Workgroup Manager |
|
xserveraid |
Xerver RAID |
Views
System view
Predefined user roles
network-admin
Parameters
user-defined-service-type: Specifies a service type name, a case-insensitive string of 1 to 15 characters. The service type cannot have the same name as a default service type.
tcp: Specifies the TCP protocol.
udp: Specifies the UDP protocol.
text: Specifies a description for a service type, a case-sensitive string of 1 to 127 characters.
Usage guidelines
The default service types cannot be deleted or modified.
A service type takes effect only when you activate the service type by using the bonjour activate service type command.
Examples
# Create a service type named example, specify the UDP protocol, and set the description to For example.
<Sysname> system-view
[Sysname] bonjour service type example udp description For example
bonjour service-mode
Use bonjour service-mode to specify a Bonjour service mode.
Use undo bonjour service-mode to restore the default.
Syntax
bonjour service-mode { custom | typical }
undo bonjour service-mode
Default
The Bonjour gateway operates in typical service mode.
Views
System view
Predefined user roles
network-admin
Parameters
custom: Specifies the custom service mode. In this mode, no service type is activated by default, and you can manually activate any service types.
typical: Specifies the typical service mode. In this mode, only the airplay, ipp, ipps, printer, and raop service types are activated, and you cannot manually activate or deactivate a service type.
Examples
# Configure the Bonjour gateway to operate in custom service mode.
<Sysname> system-view
[Sysname] bonjour service-mode custom
bonjour stop-m2u threshold
Use bonjour stop-m2u threshold to set the threshold for the Bonjour gateway to start sending multicast responses.
Use undo bonjour stop-m2u threshold to restore the default.
Syntax
bonjour stop-m2u threshold threshold-number
undo bonjour stop-m2u threshold
Default
The threshold for the Bonjour gateway to start sending multicast responses is 10.
Views
System view
Predefined user roles
network-admin
Parameters
threshold-number: Specifies the threshold for the Bonjour gateway to start sending multicast instead of unicast responses, in the range of 1 to 64.
Usage guidelines
This command prevents the Bonjour gateway from sending excessive unicast responses to save bandwidth.
Before the threshold is reached, the gateway sends only unicast responses. After the threshold is reached, the gateway sends unicast or multicast responses as required by clients.
Examples
# Set the threshold for the Bonjour gateway to start sending multicast responses to 8.
<Sysname> system-view
[Sysname] bonjour global enable
[Sysname] bonjour stop-m2u threshold 8
display bonjour active-service-type
Use display bonjour active-service-type to display activated Bonjour service types.
Syntax
display bonjour active-service-type
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display activated Bonjour service types.
<Sysname> display bonjour active-service-type
bonjour active service type airplay
bonjour active service type ipp
bonjour active service type ipps
bonjour active service type printer
bonjour active service type raop
display bonjour policy
Use display bonjour policy to display Bonjour policy information.
Syntax
display bonjour policy [ policy-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
policy-name: Specifies a Bonjour policy 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 Bonjour policies.
Examples
# Display Bonjour policy information.
<Sysname> display bonjour policy
Bonjour policy name : student
VLAN : 1 to 5
Access-VLAN : Enabled
Service list:
Service type IP address/Instance name
ichat 192.168.0.1
printer Not configured
Bonjour policy name : default
VLAN : 1 to 4094
Access-VLAN : Enable
Service list :
Service type IP address/Instance name
airplay Not configured
ipp Not configured
ipps Not configured
printer Not configured
raop Not configured
Total number of configured Bonjour policies: 2
Table 3 Command output
|
Field |
Description |
|
VLAN |
List of VLANs to which the Bonjour gateway can forward queries and responses. |
|
Access-VLAN |
Whether the Bonjour gateway can forward queries and responses to the VLANs to which the clients belong: · Enabled. · Disabled. |
|
Service list |
List of services that can be discovered by clients. |
|
Service type |
Types of services that can be discovered by clients. |
|
IP address/Instance name |
IP address or instance name of the service that can be discovered by clients. |
display bonjour service
Use display bonjour service to display information about services discovered by the Bonjour gateway.
Syntax
display bonjour service
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display information about services discovered by the Bonjour gateway.
<Sysname> display bonjour service
Instance name Service type VLAN TTL IP
Apple TV airplay 1 4500 192.168.10.2
B8782E5101E7@Apple TV raop 2 4500 192.168.10.2
70-35-60-63.1 Apple TV sleep-proxy 3 4500 192.168.10.2
Total number of discarded query packets : 0
Total number of discarded response packets: 0
Total number of Bonjour services : 3
Table 4 Command output
|
Field |
Description |
|
Instance name |
Instance name of the service. |
|
VLAN |
VLAN to which the service belongs. |
|
TTL |
TTL of the service, in seconds. When the Bonjour gateway receives a new response for the service, it resets the TTL for the service. |
|
IP |
IP address of the service. |
reset bonjour service
Use reset bonjour service to clear Bonjour service information.
Syntax
reset bonjour service { type { pre-defined-service-type | user-defined user-defined-service-type } [ instance instance-name ] | all }
Views
System view
Predefined user roles
network-admin
Parameters
type: Specifies a Bonjour service type.
pre-defined-service-type: Specifies a default service type. Table 5 lists the default Bonjour service types by their names and service type strings.
Table 5 Apple Bonjour protocols and service type strings
|
Name |
Service type strings |
|
afpovertcp |
AppleTalkFiling Protocol |
|
airplay |
Airplay |
|
airport |
Airport Base Station |
|
apple-sasl |
Apple Password Server |
|
daap |
Digital Audio Access Protocol |
|
dacp |
Digital Audio Control Protocol |
|
distcc |
Distributed Compiler |
|
dpap |
Digital Photo Access Protocol |
|
eppc |
Remote AppleEvents |
|
ftp |
File Transfer Protocol |
|
http |
Hypertext Transfer Protocol |
|
ica-networking |
Image Capture Sharing |
|
ichat |
iChat Instant Messaging Protocol |
|
ipp |
Internet Printing Protocol |
|
ipps |
Internet Printing Protocol |
|
nfs |
Network File System |
|
pdl-stream |
PDL Data Stream |
|
printer |
Line Printer Daemon |
|
raop |
Remote Audio Output Protocol |
|
riousbprint |
Remote I/O USB Printer Protocol |
|
servermgr |
Server Admin |
|
ssh |
Secure Shell |
|
telnet |
Remote Login |
|
webdav |
WebDav File System |
|
workstation |
Workgroup Manager |
|
xserveraid |
Xerver RAID |
user-defined user-defined-service-type: Specifies a user-defined service type by its name, a case-insensitive string of 1 to 15 characters.
instance instance-name: Specifies a service by its instance name, a case-insensitive string of 1 to 63 characters. An instance name uniquely identifies a service. If you do not specify this option, the command clears all services of the specified service type.
all: Specifies all services.
Examples
# Clear information about service Airplay1 of service type airplay.
[Sysname] reset bonjour service type airplay instance Airplay1
# Clear information about all services of service type service.
[Sysname] reset bonjour service type user-define service
rrop anti-bmc protocol ipv6 bonjour
Use rrop anti-bmc protocol ipv6 bonjour to configure IPv6 Bonjour mDNS packet filtering.
Use undo rrop anti-bmc protocol ipv6 bonjour to restore the default.
Syntax
rrop anti-bmc protocol ipv6 bonjour { continue | deny }
undo rrop anti-bmc protocol ipv6 bonjour
Default
· In AP view, an AP uses the configuration in AP group view.
· In AP group view, an AP uses the configuration in system view.
· In system view, IPv6 Bonjour mDNS packet filtering is disabled.
Views
AP view
AP group view
System view
Predefined user roles
network-admin
Parameters
continue: Does not filter IPv6 Bonjour mDNS packets.
deny: Filters IPv6 Bonjour mDNS packets.
Usage guidelines
Bonjour is a zero-configuration networking protocol based on Multicast DNS (mDNS). In an IPv6 network, some Bonjour clients still send IPv6 mDNS packets even though the Bonjour server (such as a projector or printer) does not support IPv6, wasting device resources and causing mDNS packet flooding. To resolve this issue, configure APs to discard received IPv6 mDNS packets to save device resources and reduce the number of mDNS packets in the network.
· After you configure the rrop anti-bmc protocol ipv6 bonjour deny command, the IPv6 Bonjour service is not available and the IPv4 Bonjour service is not affected. As a best practice, configure this command in an IPv6 network where the Bonjour servers do not support IPv6.
· With the rrop anti-bmc protocol ipv6 bonjour continue command configured, APs do not discard received IPv6 mDNS packets. If you also configure the rrop anti-bmc default-action deny command or rrop anti-bmc protocol ipv6 deny command, APs discard received IPv6 mDNS packets.
Examples
# Enable an AP to discard IPv6 Bonjour mDNS packets.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA6320
[Sysname-wlan-ap-ap1] rrop anti-bmc protocol ipv6 bonjour deny
# Enable APs in an AP group to discard IPv6 Bonjour mDNS packets.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-ap-group-group1] rrop anti-bmc protocol ipv6 bonjour deny
# Enable APs to discard IPv6 Bonjour mDNS packets.
<Sysname> system-view
[Sysname] rrop anti-bmc protocol ipv6 bonjour deny
Related commands
bonjour global enable
service type
Use service type to configure the type of service that can be discovered by clients.
Use undo service type to remove a service type.
Syntax
service type { pre-defined-service-type | user-defined user-defined-service-type } [ ip ipv4-address | ipv6 ipv6-address | instance instance-name ]
undo service type service-type [ ip ipv4-address | ipv6 ipv6-address | instance instance-name ]
Default
No service type is configured. Clients can discover all services.
Views
Bonjour policy view
Predefined user roles
network-admin
Parameters
pre-defined-service-type: Specifies a service by its type. Table 6 lists some Bonjour protocols by their names and service type strings.
Table 6 Apple Bonjour protocols and service type strings
|
Name |
Service type strings |
|
afpovertcp |
AppleTalkFiling Protocol |
|
airplay |
Airplay |
|
airport |
Airport Base Station |
|
apple-sasl |
Apple Password Server |
|
daap |
Digital Audio Access Protocol |
|
dacp |
Digital Audio Control Protocol |
|
distcc |
Distributed Compiler |
|
dpap |
Digital Photo Access Protocol |
|
eppc |
Remote AppleEvents |
|
ftp |
File Transfer Protocol |
|
http |
Hypertext Transfer Protocol |
|
ica-networking |
Image Capture Sharing |
|
ichat |
iChat Instant Messaging Protocol |
|
ipp |
Internet Printing Protocol |
|
ipps |
Internet Printing Protocol |
|
nfs |
Network File System |
|
pdl-stream |
PDL Data Stream |
|
printer |
Line Printer Daemon |
|
raop |
Remote Audio Output Protocol |
|
riousbprint |
Remote I/O USB Printer Protocol |
|
servermgr |
Server Admin |
|
ssh |
Secure Shell |
|
telnet |
Remote Login |
|
webdav |
WebDav File System |
|
workstation |
Workgroup Manager |
|
xserveraid |
Xerver RAID |
user-defined user-defined-service-type: Specifies a user-defined service type name, a case-insensitive string of 1 to 15 characters. The user-defined service types cannot have the same names as the default service types.
ip ipv4-address: Specifies a service by its IP address.
ipv6 ipv6-address: Specifies a service by its IPv6 address.
instance instance-name: Specifies a service by its instance name, a case-insensitive string of 1 to 63 characters. An instance name uniquely identifies a service.
Usage guidelines
If you do not specify the ip ipv4-address, ipv6 ipv6-address, or instance instance-name option, clients can discover all services of the specified type. If you specify the ip ipv4-address, ipv6 ipv6-address, or instance instance-name option, clients can discover a service type with the specified IP address or instance name.
Examples
# Set the type of service that can be discovered by clients to ichat and the service IP address to 192.168.1.10.
<Sysname> system-view
[Sysname] bonjour policy teacher
[Sysname-bp-teacher] service type ichat ip 192.168.1.10
Related commands
service vlan
service vlan
Use service vlan to specify a list of VLANs to which the device can forward queries and service advertisements.
Use undo service vlan to remove the configuration.
Syntax
service vlan vlan-id-list [ access-vlan ]
undo service vlan [ vlan-id-list ] [ access-vlan ]
Default
No service VLANs are configured.
Views
Bonjour policy view
Predefined user roles
network-admin
Parameters
vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN ID or a range of VLAN IDs in the form of vlan-id1 to vlan-id2. The value range for VLAN IDs is 1 to 4094. The ID for vlan-id2 must be equal to or greater than the ID for vlan-id1.
access-vlan: Allows the device to forward queries and service advertisements to the VLANs to which the clients belong. If you remove all VLAN lists, the access-vlan keyword is unavailable.
Examples
# Enable the device to forward queries and service advertisements to VLAN 100.
<Sysname> system-view
[Sysname] bonjour policy teacher
[Sysname-bp-teacher] service vlan 100
Related commands
