Configuring a Voice VLAN
This section describes the data model of a voice VLAN and provides examples of XML packets.
Data Model
The configuration model files matching VLAN management are huawei-vlan.yang and ietf-interfaces.yang.
Object |
Description |
Value |
Remarks |
|---|---|---|---|
/huawei-vlan:voice-vlan/remark-8021p |
Specifies the 802.1p priority. |
The value is an integer that ranges from 0 to 7. The default value is 6. A larger value indicates a higher priority. |
NA |
/huawei-vlan:voice-vlan/remark-dscp |
Specifies the DSCP priority. |
The value is an integer that ranges from 0 to 63. The default value is 46. A larger value indicates a higher priority. |
NA |
/huawei-vlan:voice-vlan/address/mac |
Specifies the OUI address of voice packets that can be transmitted in the voice VLAN. |
The value is in H:H:H:H:H:H format. H is a hexadecimal number that contains 1 to 2 digits, such as e0 and fc. The address cannot be all 0s, multicast address, or broadcast address. |
NA |
/huawei-vlan:voice-vlan/address/mask |
Specifies the mask length of the OUI address. |
The value is an integer that ranges from 1 to 48. |
NA |
/huawei-vlan:voice-vlan/address/description |
Indicates the description of the OUI address. |
The value is a string of 1 to 80 case-sensitive characters. |
NA |
/ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan/voice-vlan-id |
Configures a specified VLAN as a voice VLAN. |
The value is an integer that ranges from 2 to 4094. |
NA |
/ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan/include-untagged |
Adds voice VLAN IDs to untagged packets. |
The value is of the Boolean type:
The default value is false. |
NA |
/ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan/include-tag0 |
Changes VLAN 0 in packets to the voice VLAN ID. |
The value is of the Boolean type:
The default value is false. |
The X series cards do not support include-tag0. |
/ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan/remark-mode |
Configures a mode to increase the priority of voice packets. |
The value is of the enumerated type:
The default value is vlan. |
You must enable the voice VLAN function on interfaces before configuring a mode to increase the priority of voice packets. |
/ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan/security |
Configures the secure or normal mode of a voice VLAN. |
The value is of the enumerated type:
The default value is disable. |
You must specify that the priority of voice VLANs is increased based on MAC addresses before enabling the secure mode of the voice VLAN. |
/ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan/mode |
Specifies the working mode of the voice VLAN. |
The value is of the enumerated type:
The default value is manual. |
You must specify that the priority of voice VLANs is increased based on MAC addresses before specifying the auto mode for the voice VLAN. Access, negotiation-auto, or negotiation-desirable interfaces cannot work in auto mode. To configure these interfaces to work in auto mode, change the interface type to trunk or hybrid. |
/ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan/legacy |
Enables the CDP-compatible voice VLAN function so that the switch encapsulates voice VLAN information in CDP packets and sends them to connected IP phones. |
The value is of the enumerated type:
The default value is disable. |
You must enable the voice VLAN function on interfaces before enabling the CDP-compatible voice VLAN function so that the switch encapsulates voice VLAN information in CDP packets and sends them to connected IP phones. |
Sample of Configuring a MAC Address-based Voice VLAN
This section provides a sample of configuring a MAC address-based voice VLAN using the edit-config method.
Operation |
XPATH |
|---|---|
edit-config |
/huawei-vlan:voice-vlan/remark-8021p /huawei-vlan:voice-vlan/remark-dscp /huawei-vlan:voice-vlan/address /ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan |
Data Requirements
Item |
Data |
Description |
|---|---|---|
802.1p priority of the voice VLAN |
7 |
Set the 802.1p priority of the voice VLAN to 7. |
DSCP priority of the voice VLAN |
50 |
Set the DSCP priority of the voice VLAN to 50. |
OUI addresses of voice packets |
12:34:12:34:12:34 |
Allow the voice packets coming from an IP phone whose MAC address is 1234-1234-1234 to be identified by the voice VLAN. |
Mask length of the OUI address |
24 |
The OUI mask address is ffff-ff00-0000. |
Description of the OUI address |
PhoneA |
The description of the OUI address is PhoneA. |
Interface name |
XGigabitEthernet1/0/1 |
Enable the voice VLAN function on the XGigabitEthernet1/0/1 interface and specify VLAN 103 as a voice VLAN. Add voice VLAN IDs to untagged packets and change VLAN 0 in packets to the voice VLAN ID. |
Interface type |
iana-if-type:ethernetCsmacd |
|
Voice VLAN ID |
103 | |
Adding voice VLAN IDs to untagged packets |
true | |
Changing VLAN 0 in packets to the voice VLAN ID |
true | |
Mode of increasing the priority of voice packets |
mac-address | Specify that the priority of voice packets is increased based on MAC addresses. |
Working mode of the voice VLAN |
enable | Configure the voice VLAN to work in secure mode. |
Mode of adding an interface to a voice VLAN |
manual | Configure an interface to be added to a voice VLAN in manual mode. |
To create a VLAN and add an interface to the VLAN, refer to VLAN Management. The related configuration is not provided here.
Request Example
# Sample of configuring the 802.1p priority and DSCP priority for a voice VLAN and setting the OUI address
<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="11" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<edit-config>
<target>
<running/>
</target>
<config>
<huawei-vlan:voice-vlan xmlns:huawei-vlan="urn:huawei:params:xml:ns:yang:huawei-vlan">
<huawei-vlan:remark-8021p>7</huawei-vlan:remark-8021p>
<huawei-vlan:remark-dscp>50</huawei-vlan:remark-dscp>
<huawei-vlan:address>
<huawei-vlan:mac>12:34:12:34:12:34</huawei-vlan:mac>
<huawei-vlan:mask>24</huawei-vlan:mask>
<huawei-vlan:description>PhoneA</huawei-vlan:description>
</huawei-vlan:address>
</huawei-vlan:voice-vlan>
</config>
</edit-config>
</rpc>
# Sample of configuring a MAC address-based voice VLAN on the XGigabitEthernet1/0/1 interface
<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="12" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<edit-config>
<target>
<running/>
</target>
<config>
<if:interfaces xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces">
<if:interface>
<if:name>XGigabitEthernet1/0/1</if:name>
<if:type xmlns:iana-if-type="urn:ietf:params:xml:ns:yang:iana-if-type">iana-if-type:ethernetCsmacd</if:type>
<huawei-vlan:voice-vlan xmlns:huawei-vlan="urn:huawei:params:xml:ns:yang:huawei-vlan">
<huawei-vlan:voice-vlan-id>103</huawei-vlan:voice-vlan-id>
<huawei-vlan:include-untagged>true</huawei-vlan:include-untagged>
<huawei-vlan:include-tag0>true</huawei-vlan:include-tag0>
<huawei-vlan:remark-mode>mac-address</huawei-vlan:remark-mode>
<huawei-vlan:security>enable</huawei-vlan:security>
<huawei-vlan:mode>manual</huawei-vlan:mode>
</huawei-vlan:voice-vlan>
</if:interface>
</if:interfaces>
</config>
</edit-config>
</rpc>
Response Example
Sample of successful response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="11"> <ok/> </rpc-reply>
Sample of failed response
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="4">
<rpc-error>
<error-app-tag>-1</error-app-tag>
<error-message> Auto-mode voice VLAN cannot be configured on a negotiation port.</error-message>
<error-info>Error on node /ietf-interfaces:interfaces/interface[name="XGigabitEthernet1/0/1"]/huawei-vlan:voice-vlan</error-info>
</rpc-error>
</rpc-reply>
Sample of Configuring a VLAN ID-based Voice VLAN
This section provides a sample of configuring a VLAN ID-based voice VLAN using the edit-config method.
Operation |
XPATH |
|---|---|
edit-config |
/huawei-vlan:voice-vlan/remark-8021p /huawei-vlan:voice-vlan/remark-dscp /ietf-interfaces:interfaces/interface/huawei-vlan:voice-vlan |
Data Requirements
Item |
Data |
Description |
|---|---|---|
802.1p priority of the voice VLAN |
7 |
Set the 802.1p priority of the voice VLAN to 7. |
DSCP priority of the voice VLAN |
50 |
Set the DSCP priority of the voice VLAN to 50. |
Interface name |
XGigabitEthernet1/0/2 |
Enable the voice VLAN function on the XGigabitEthernet1/0/2 interface and specify VLAN 105 as the voice VLAN. Add voice VLAN IDs to untagged packets and change VLAN 0 in packets to the voice VLAN ID. |
Interface type |
iana-if-type:ethernetCsmacd |
|
Voice VLAN ID |
105 | |
Whether to add voice VLAN IDs to untagged packets |
true | |
Whether to change VLAN 0 in packets to the voice VLAN ID |
true | |
Mode of increasing the priority of voice packets |
vlan | Specify that the priority of voice packets is increased based on VLAN IDs. |
CDP-compatible capability |
enable | Enable the CDP-compatible voice VLAN function so that the switch encapsulates voice VLAN information in CDP packets and sends them to connected IP phones. |
To create a VLAN and add an interface to the VLAN, refer to VLAN Management. The related configuration is not provided here.
Request Example
# Sample of configuring the 802.1p priority and DSCP priority for a voice VLAN
<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="7" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<edit-config>
<target>
<running/>
</target>
<config>
<huawei-vlan:voice-vlan xmlns:huawei-vlan="urn:huawei:params:xml:ns:yang:huawei-vlan">
<huawei-vlan:remark-8021p>7</huawei-vlan:remark-8021p>
<huawei-vlan:remark-dscp>50</huawei-vlan:remark-dscp>
</huawei-vlan:voice-vlan>
</config>
</edit-config>
</rpc>
# Sample of configuring a VLAN ID-based voice VLAN on the XGigabitEthernet 1/0/2 interface
<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="8" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<edit-config>
<target>
<running/>
</target>
<config>
<if:interfaces xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces">
<if:interface>
<if:name>XGigabitEthernet1/0/2</if:name>
<if:type xmlns:iana-if-type="urn:ietf:params:xml:ns:yang:iana-if-type">iana-if-type:ethernetCsmacd</if:type>
<huawei-vlan:voice-vlan xmlns:huawei-vlan="urn:huawei:params:xml:ns:yang:huawei-vlan">
<huawei-vlan:voice-vlan-id>105</huawei-vlan:voice-vlan-id>
<huawei-vlan:include-untagged>true</huawei-vlan:include-untagged>
<huawei-vlan:include-tag0>true</huawei-vlan:include-tag0>
<huawei-vlan:remark-mode>vlan</huawei-vlan:remark-mode>
<huawei-vlan:legacy>enable</huawei-vlan:legacy>
</huawei-vlan:voice-vlan>
</if:interface>
</if:interfaces>
</config>
</edit-config>
</rpc>
Response Example
Sample of successful response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="8"> <ok/> </rpc-reply>
Sample of failed response
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="8">
<rpc-error>
<error-type>application</error-type>
<error-tag>operation-failed</error-tag>
<error-severity>error</error-severity>
<error-path>/ietf-interfaces:interfaces/interface[name='XGigabitEthernet1/0/2']/huawei-vlan:voice-vlan/security</error-path>
<error-message>parse rpc config error.(Invalid value "true" in "security" element.).</error-message>
</rpc-error>
</rpc-reply>