10-WLAN Advanced Features Command Reference

HomeSupportResource CenterH3C Access Points Cloud Mode Command References(E2442 R2442)-6W10010-WLAN Advanced Features Command Reference
03-Bonjour gateway commands
Title Size Download
03-Bonjour gateway commands 107.80 KB

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.

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

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 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 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/MAC address

  ichat                                 192.168.0.1

  printer                               Not configured

  airplay                               24f6-770c-f6d4

 

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/MAC address

IP address, instance name, or MAC address 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

Global status: Enabled

Bonjour service-mode: typical

Total number of discarded query packets:622

Total number of discarded response packets:72

Total number of bonjour services: 4

-------------------------------------------------------------------

Instance name           : 787B8ACE40C3@ALEX

Service type            : raop

Protocol                : TCP

VLAN                    : 10

TTL                     : 120

IP                      : 192.168.77.134

MAC                     : 24f6-770c-f6d4

-------------------------------------------------------------------

Instance name           : 787B8ACE40C3@ALEX

Service type            : raop

Protocol                : TCP

VLAN                    : 10

TTL                     : 120

IP                      : FE80::4BA:5A28:C78E:9B70

MAC                     : 24f6-770c-f6d4

-------------------------------------------------------------------

Instance name           : ALEX

Service type            : airplay

Protocol                : TCP

VLAN                    : 10

TTL                     : 120

IP                      : 192.168.77.134

MAC                     : 24f6-770c-f6d4

-------------------------------------------------------------------

Instance name           : ALEX

Service type            : airplay

Protocol                : TCP

VLAN                    : 10

TTL                     : 120

IP                      : FE80::4BA:5A28:C78E:9B70

MAC                     : 24f6-770c-f6d4

Table 4 Command output

Field

Description

Global status

Global enabling status of Bonjour gateway.

Bonjour service-mode

Bonjour service mode:

·     custom.

·     typical.

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.

MAC

MAC 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

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 | mac mac-address ]

undo service type service-type [ ip ipv4-address | ipv6 ipv6-address | instance instance-name | mac mac-address ]

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.

mac mac-address: Specifies a service by its MAC address.

Usage guidelines

If you do not specify the ip ipv4-address, ipv6 ipv6-address, instance instance-name, or mac mac-address option, clients can discover all services of the specified type. If you specify the ip ipv4-address, ipv6 ipv6-address, instance instance-name, or mac mac-address option, clients can discover a service type with the specified IP address, instance name, or MAC address.

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

service type