- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
04-EPON VoIP commands | 102.13 KB |
EPON VoIP commands
Basic EPON VoIP commands
display epon iad
Use display epon iad to display information about the IAD module on an ONU.
Syntax
display epon iad interface interface-type interface-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type, ONU or RONU.
interface-number: Specifies an interface number.
Examples
# Display information about the IAD module on ONU 1.
<Sysname> display epon iad interface onu 1/0/1:1
IAD basic information
MAC address: 000f-e200-0004
Protocol: SIP
Software version: 101
User count: 2
IAD configuration
IAD IP address configuration mode: Manual
IAD IP address: 172.3.170.58
IAD IP mask: 255.255.255.0
IAD IP gateway: 172.3.103.8
Voice VLAN mode: Tag
CVLAN: 4094
SVLAN: N/A
Priority: 5
Fax/modem configuration
Fax/modem transmission mode: Transparent
Fax/modem negotiation mode: Negotiate
Table 1 Command output
Field |
Description |
IAD basic information |
Basic information about the IAD module. |
MAC address |
MAC address of the IAD module. |
Protocol |
Voice protocol supported by the IAD module: · SIP. · H.248. |
Software version |
Software version of the IAD module. |
User count |
Number of VoIP ports on the ONU. |
IAD configuration |
IAD module configuration. |
IAD IP address configuration mode |
Configuration mode of the IP address on the IAD module: · Manual—The IP address is manually assigned. · DHCP—The IP address is obtained through DHCP. · PPPoE—The IP address is obtained through PPPoE. |
IAD IP address |
IP address of the IAD module. |
IAD IP mask |
Subnet mask of the IAD module's IP address. |
IAD IP gateway |
Gateway address of the IAD module. |
IAD PPP authentication mode |
PPP authentication mode on the IAD module: · Auto—Automatically chooses CHAP or PAP authentication. · CHAP—Uses CHAP authentication. · PAP—Uses PAP authentication. |
IAD PPPoE username |
PPPoE username on the IAD module. |
Voice VLAN mode |
Operation mode for the voice VLAN feature: · Transparent—Voice packets are directly transmitted without VLAN tagging. · Tag—VLAN packets are tagged with a VLAN ID before transmission. · QinQ—VLAN packets are tagged with an outer VLAN ID and an inner VLAN ID before transmission. |
CVLAN |
Inner VLAN ID tagged for voice packets. This field displays N/A if the voice VLAN operation mode is transparent. |
SVLAN |
Outer VLAN ID tagged for voice packets. This field displays N/A if the voice VLAN operation mode is transparent or VLAN tagging. |
Priority |
802.1p priority for voice packets that belong to the outer VLAN. |
Fax/modem configuration |
Fax or modem configuration. |
Fax/modem transmission mode |
Transmission mode for the fax and modem services: · Transparent. · T38. |
Fax/modem negotiation mode |
Negotiation mode for the fax and modem services: · Negotiate—Auto-negotiation mode. · Auto VBD—Auto VBD mode. |
display epon voip-port status
Use display epon voip-port status to display the status of a VoIP port on an ONU.
Syntax
display epon interface interface-type interface-number voip-port port-number status
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type, ONU or RONU.
interface-number: Specifies an interface number.
port-number: Specifies a VoIP port by its port number, in the range of 1 to the number of VoIP ports on the ONU. An ONU can have a maximum of 64 VoIP ports.
Examples
# Display the status of VoIP port 1 on ONU 1.
<Sysname> display epon interface onu 1/0/1:1 voip-port 1 status
Port status: Idle
Service status: Normal
Codec mode: Other
Table 2 Command output
Field |
Description |
Port status |
Status of the VoIP port: · Connected. · Connecting. · Disconnecting. · Idle. · Inactive. · Off-hook. · Registering. · Ringing. · Ringing-back. · RegFailure. · Dialing. · Other. |
Service status |
Service status of the VoIP port: · EndAuto—The service is terminated because of MGC failure. · EndLocal—The service is terminated because the VoIP port is shut down. · EndRemote—The service is terminated because the MGC issued a command to terminate the service. · Normal—The service in available. |
Codec mode |
Codec used by the VoIP port: · G.711A. · G.729. · G.711U. · G.723. · G.726. · T.38. · Other. |
iad address
Use iad address to configure the IP address of the IAD module on an ONU.
Use undo iad address to restore the default.
Syntax
iad address { ip-address { mask-length | mask } gateway gateway | dhcp-alloc | pppoe username username password { cipher | simple } password [ authentication-mode { auto | chap | pap } ] }
undo iad address
Default
No IP address is configured for the IAD module on an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
ip-address: Manually configures an IP address in dotted decimal notation.
mask-length: Specifies the mask length of the IP address, in the range of 1 to 31.
mask: Specifies the subnet mask of the IP address, in dotted decimal notation.
gateway gateway: Configures the gateway address.
dhcp-alloc: Obtains an IP address through DHCP.
username: Specifies a PPPoE user by its name, a case-sensitive string of 1 to 32 characters.
cipher: Specifies a password in encrypted form.
simple: Specifies a password in plaintext form. For security purposes, the password specified in plaintext form will be stored in encrypted form.
password: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 32 characters. Its encrypted form is a case-sensitive string of 1 to 73 characters.
authentication-mode: Specifies a PPP authentication mode. For more information about PPP authentication modes, see PPP configuration in Layer 2—WAN Access Configuration Guide.
auto: Specifies the auto mode, in which the device automatically chooses CHAP or PAP authentication.
chap: Specifies the CHAP authentication mode.
pap: Specifies the PAP authentication mode.
Examples
# Configure the IAD module on an ONU to automatically obtain an IP address through DHCP.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] iad address dhcp-alloc
iad operation
Use iad operation to issue an operation to the IAD module on an ONU.
Syntax
iad operation { cancel | re-register | reset }
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
cancel: Cancels the registration of the IAD module from the SIP registrar server or MGC.
re-register: Registers the IAD module with the SIP registrar server or MGC.
reset: Restores the factory defaults to the IAD module.
Examples
# Register the IAD module with the SIP registrar server or MGC.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] iad operation re-register
voice vlan
Use voice vlan to configure the voice VLAN operation mode on an ONU.
Use undo voice vlan to restore the default.
Syntax
Transparent mode:
undo voice vlan
VLAN tagging mode:
voice vlan cvlan-id [ priority priority ]
QinQ mode:
voice vlan cvlan-id svlan svlan-id [ priority priority ]
Default
The transparent mode is used.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
cvlan-id: Specifies the inner VLAN ID to tag voice packets, in the range of 1 to 4094.
svlan svlan-id: Specifies the outer VLAN ID to tag voice packets, in the range of 1 to 4094.
priority priority: Specifies the 802.1p priority for voice packets that belong to the outer VLAN. The value range for the priority argument is 0 to 7 and the default is 5.
Examples
# Configure ONU 1 to tag voice packets with VLAN 100.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voice vlan 100
voip fax-modem negotiation-mode
Use voip fax-modem negotiation-mode to configure the negotiation mode for the fax and modem services on an ONU.
Use undo voip fax-modem negotiation-mode to restore the default.
Syntax
voip fax-modem negotiation-mode { auto-vbd | negotiate }
undo voip fax-modem negotiation-mode
Default
The auto-negotiation mode is used for the fax and modem services on an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
auto-vbd: Specifies the auto-VBD mode. The ONU automatically changes the codecs for the fax and modem services without negotiating with the SIP server or MGC.
negotiate: Specifies the auto-negotiation mode. The ONU negotiates the codecs for the fax and modem services with the SIP server or MGC.
Examples
# Configure ONU 1 to use the auto-VBD mode for the negotiation of the fax and modem services.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip fax-modem negotiation-mode auto-vbd
Related commands
voip fax-modem transmission-mode
voip fax-modem transmission-mode
Use voip fax-modem transmission-mode to configure the transmission mode for the fax and modem services on an ONU.
Use undo voip fax-modem transmission-mode to restore the default.
Syntax
voip fax-modem transmission-mode { t38 | transparent }
undo voip fax-modem transmission-mode
Default
The transparent mode is used for the fax and modem services on an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
t38: Specifies the T.38 transmission mode.
transparent: Specifies the transparent transmission mode.
Examples
# Configure ONU 1 to use the T.38 transmission mode for the fax and modem services.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip fax-modem transmission-mode t38
Related commands
voip fax-modem negotiation-mode
voip heartbeat
Use voip heartbeat to set the heartbeat parameters for the voice service on an ONU.
Use undo voip heartbeat to restore the default.
Syntax
voip heartbeat { cycle interval | count count }*
undo voip heartbeat
Default
The heartbeat cycle is 60 seconds and the heartbeat count is 3 on an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
cycle interval: Specifies the heartbeat cycle, in the range of 1 to 65535 seconds.
count count: Specifies the heartbeat count, in the range of 1 to 255.
Usage guidelines
An ONU sends a keepalive message to the SIP server or MGC at the heartbeat cycle. If no reply message from the server or MGC is received after the specified heartbeat count, the ONU determines that the connection with the server is down.
Examples
# Set the heartbeat cycle to 180 seconds on ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip heartbeat cycle 180
voip-port shutdown
Use voip-port shutdown to shut down a VoIP port on an ONU.
Use undo voip-port shutdown to bring up a VoIP port on an ONU.
Syntax
voip-port port-number shutdown
undo voip-port port-number shutdown
Default
All VoIP ports on an ONU are shut down.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
port-number: Specifies a VoIP port by its number, in the range of 1 to the current number of VoIP ports on the ONU.
Examples
# Bring up VoIP port 1 on ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] undo voip-port 1 shutdown
EPON SIP commands
display epon voip sip
Use display epon voip sip to display the SIP configuration on an ONU.
Syntax
display epon voip sip interface interface-type interface-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type, ONU or RONU.
interface-number: Specifies an interface number.
Examples
# Display the SIP configuration on ONU 1.
<Sysname> display epon voip sip interface onu 1/0/1:1
SIP configuration
SIP MG port number: 5060
Main SIP proxy server IP address: 172.3.170.1
Main SIP proxy server port number: 5061
Standby SIP proxy server IP address: N/A
Standby SIP proxy server port number: 5060
Active SIP proxy server: 172.3.170.1
Main SIP registrar server IP address: 172.3.170.1
Main SIP registrar server port number: 5061
Standby SIP registrar server IP address: N/A
Standby SIP registrar server port number: 5060
SIP outbound server IP address: 172.3.170.1
SIP outbound server port number: 5061
SIP registration interval: 3600s
SIP heartbeat cycle: 60s
SIP heartbeat count: 3
Table 3 Command output
Field |
Description |
SIP configuration |
SIP protocol configuration. |
SIP MG port number |
Port number of the SIP media gateway. |
Main SIP proxy server IP address |
IP address of the primary SIP proxy server. |
Main SIP proxy server port number |
Port number of the primary SIP proxy server. |
Standby SIP proxy server IP address |
IP address of the backup SIP proxy server. |
Standby SIP proxy server port number |
Port number of the backup SIP proxy server. |
Active SIP proxy server |
IP address of the active SIP proxy server. |
Main SIP registrar server IP address |
IP address of the primary SIP registrar server. |
Main SIP registrar server port number |
Port number of the primary SIP registrar server. |
Standby SIP registrar server IP address |
IP address of the backup SIP registrar server. |
Standby SIP registrar server port number |
Port number of the backup SIP registrar server. |
SIP outbound server IP address |
IP address of the outbound SIP server. |
SIP outbound server port number |
Port number of the outbound SIP server. |
SIP registration interval |
SIP user registration interval, in seconds. |
SIP heartbeat cycle |
Heartbeat cycle, in seconds. |
SIP heartbeat count |
Heartbeat count in a heartbeat cycle. |
voip digit-map
Use voip digit-map to configure a SIP digit map for an ONU.
Use undo voip digit-map to delete a SIP digit map for an ONU.
Syntax
voip digit-map map-name map-content
undo voip digit-map map-name
Default
No SIP digit maps are configured for an ONU.
Default digit maps exist on some ONUs. Calls can be directly placed on these ONUs and no digit maps are required to be configured. Support for default digit maps depends on ONU model.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
map-name: Specifies a digit map name, a case-sensitive string of 1 to 31 characters.
map-content: Specifies the content of the digit map, a case-sensitive string of 1 to 125 characters.
Usage guidelines
A digit map is a dial plane used to restrict outgoing calls that can be placed on an ONU. If the dialed number does not meet the requirements of a digit map, the call cannot be placed.
The device issues the configured digit maps to ONUs. Support for digit maps depends on the ONU model. Interpretation of digit maps varies by ONU model.
To allow an ONU to place any call number, configure only one digit map [0-9*#]..
If you configure the content multiples times for the same digit map, the most recent configuration takes effect.
You can configure a maximum of 64 digit maps.
Examples
# Configure a digit map named map1 to allow four-digit call numbers starting with 3 to be dialed out..
<Sysname> system-view
[Sysname] interface Onu1/0/1:1
[Sysname-Onu1/0/1:1] voip digit-map map1 8888xxxx
voip sip mg-port
Use voip sip mg-port to specify the port number of the SIP media gateway for an ONU.
Use undo voip sip mg-port to restore the default.
Syntax
voip sip mg-port port
undo voip sip mg-port
Default
The port number is 5060 for the SIP media gateway on an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
port: Specifies the port number of the SIP media gateway, in the range of 1 to 65535.
Examples
# Specify 5080 as the port number of the SIP media gateway on ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip mg-port 5080
voip sip outbound-server
Use voip sip outbound-server to specify the outbound SIP server for an ONU.
Use undo voip sip outbound-server to remove the outbound SIP server.
Syntax
voip sip outbound-server ip ip-address [ port port ]
undo voip sip outbound-server
Default
No outbound SIP server is specified for an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the IP address of the outbound SIP server, in dotted decimal notation.
port: Specifies the port number of the outbound SIP server, in the range of 1 to 65535. The default is 5060.
Examples
# Specify 10.10.10.12 and 4098 as the IP address and port number of the outbound SIP server for ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip outbound-server ip 10.10.10.12 port 4098
voip sip proxy-server
Use voip sip proxy-server to specify a SIP proxy server for an ONU.
Use undo voip sip proxy-server to remove a SIP proxy server for an ONU.
Syntax
voip sip proxy-server [ standby ] ip ip-address [ port port ]
undo voip sip proxy-server [ standby ]
Default
NO SIP proxy servers are specified.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
standby: Specifies the backup SIP proxy server. To specify the primary SIP proxy server, do not specify this keyword.
ip ip-address: Specifies the IP address of the SIP proxy server, in dotted decimal notation.
port port: Specifies the port number of the SIP proxy server, in the range of 1 to 65535. The default is 5060.
Usage guidelines
If you specify the primary or backup SIP proxy server multiple times, the most recent configuration takes effect.
Examples
# Specify 10.10.10.10 and 4096 as the IP address and port number of the primary SIP proxy server for ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip proxy-server ip 10.10.10.10 port 4096
voip sip registrar-server
Use voip sip registrar-server to specify a SIP registrar server for an ONU.
Use undo voip sip registrar-server to remove a SIP registrar server for an ONU.
Syntax
voip sip registrar-server [ standby ] ip ip-address [ port port ]
undo voip sip registrar-server [ standby ]
Default
No SIP registrar servers are specified for an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
standby: Specifies the backup SIP registrar server. To specify the primary SIP registrar server, do not specify this keyword.
ip ip-address: Specifies the IP address of the SIP registrar server, in dotted decimal notation.
port port: Specifies the port number of the SIP registrar server, in the range of 1 to 65535. The default is 5060.
Usage guidelines
If you specify the primary or backup SIP registrar server multiple times, the most recent configuration takes effect.
Examples
# Specify 10.10.10.11 and 4097 as the IP address and port number of the primary SIP registrar server for ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip registrar-server ip 10.10.10.11 port 4097
voip sip registration-interval
Use voip sip registration-interval to set the SIP user registration interval for an ONU.
Use undo voip sip registration-interval to restore the default.
Syntax
voip sip registration-interval interval
undo voip sip registration-interval
Default
The SIP user registration interval is 3600 seconds for an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the SIP user registration interval, in the range of 1 to 4294967295 seconds.
Usage guidelines
An ONU registers SIP users with the SIP registrar server at the specified interval. This mechanism ensures that the SIP registrar server manages only active SIP user accounts, which reduces the burden of the SIP registrar server.
As a best practice, use the default setting.
The SIP registrar and the ONU will negotiate the SIP user registration interval, which might be different from the value you set.
Examples
# Set the SIP user registration interval to 3000 seconds for ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip registration-interval 3000
voip-port sip account
Use voip-port sip account to add a SIP user to an ONU.
Use undo voip-port sip account to remove a SIP user from an ONU.
Syntax
voip-port port-number sip account phone-number username username password { cipher | simple } password
undo voip-port port-number sip account
Default
No SIP users exist on an ONU.
Views
ONU interface view
RONU interface view
Predefined user roles
network-admin
Parameters
port-number: Specifies a VoIP port by its number, in the range of 1 to the current number of VoIP ports on the ONU. An ONU can have a maximum of 64 VoIP ports.
phone-number: Specifies the phone number of the SIP user, a string of 1 to 16 digits.
username: Specifies the username of the SIP user, a string of 1 to 32 characters.
cipher: Specifies a password in encrypted form.
simple: Specifies a password in plaintext form. For security purposes, the password specified in plaintext form will be stored in encrypted form.
password: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 16 characters. Its encrypted form is a case-sensitive string of 1 to 53 characters.
Usage guidelines
The SIP user to be added must use the phone number as well as the username and password that have already been registered with the SIP registrar server.
Only one SIP user can be added to a VoIP port and a SIP user can be added to only one VoIP port.
Examples
# Add a SIP user to ONU 1. The phone number of the user is 13812345678, and the username and password of the user is alan and 123 in plaintext form, respectively.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip-port 1 sip account 13812345678 username alan password 123