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, the AP uses the configuration in AP group view.

In AP group view, Bonjour gateway is enabled for APs in the AP group.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-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 WA4320i-ACN

[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 gateway commands -- 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 for an interface.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

mdc-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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet0/0/1] bonjour enable

Bonjour gateway commands -- 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

mdc-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

This command is not available when the custom service mode is used.

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.

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 gateway commands -- 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, the 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

mdc-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 WA4320i-ACN

[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/2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/2

[Sysname-GigabitEthernet1/0/2] bonjour apply policy teacher

Related commands

bonjour policy

Bonjour gateway commands -- 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

mdc-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 gateway commands -- 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

mdc-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 gateway commands -- 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

mdc-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 gateway commands -- 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

mdc-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 gateway commands -- 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

mdc-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 gateway commands -- 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

mdc-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 gateway commands -- bonjour stop-m2u threshold

Use bonjour stop-m2u threshold to set the request threshold at which the Bonjour gateway sends a multicast response to the request for a service.

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

mdc-admin

Parameters

threshold-number: Specifies the request threshold at which the Bonjour gateway sends a multicast response to the request for a service, in the range of 1 to 64.

Usage guidelines

This command prevents the Bonjour gateway from sending excessive unicast responses to save bandwidth.

Examples

# Set the value to 8 for the request threshold at which the Bonjour gateway sends a multicast response to the request for a service.

<Sysname> system-view

[Sysname] bonjour global enable

[Sysname] bonjour stop-m2u threshold 8

Bonjour gateway commands -- 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

mdc-admin

mdc-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

Total number of configured Bonjour policies: 1

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 or 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.

Bonjour gateway commands -- 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

mdc-admin

mdc-operator

Examples

# Display information about services discovered by the Bonjour gateway.

<Sysname> display bonjour service

Global status: Disabled

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
Global status | Global Bonjour gateway status: Enabled or Disabled.
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.

Bonjour gateway commands -- 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

mdc-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

Bonjour gateway commands -- 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

mdc-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

Bonjour gateway commands -- service vlan

Use service vlan to specify a list of VLANs to which the AC 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 specified.

Views

Bonjour policy view

Predefined user roles

network-admin

mdc-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 AC 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 AC to forward queries and service advertisements to VLAN 100.

<Sysname> system-view

[Sysname] bonjour policy teacher

[Sysname-bp-teacher] service vlan 100

Related commands

service type