Configuring an H.323 Trunk Group
An H.323 trunk group implements voice communication between PBX users and inter-office users. The H.323 trunk is a packet trunk based on the IP network, and it uses H.323.
Context
Unlike a circuit trunk that defines a physical channel, an H.323 trunk defines a logical channel. The H.323 trunk is used to authenticate the gateway, gatekeeper, and external gatekeeper on the H.323 network where the PBX is used.
Peer gateway mode
As shown in Figure 2-25, PBX1 and PBX2 are enterprise routers that can communicate with each other on a LAN (or WAN). Voice data between PBX1 and PBX2 is transmitted through the H.323 trunk. The H.323 trunks on PBX1 and PBX2 use the peer gateway mode, and do not need to register with the gatekeeper.
Peer gatekeeper mode
As shown in Figure 2-25, PBX3 and PBX4 are enterprise routers that can communicate with each other on a LAN (or WAN). Voice data between PBX3 and PBX4 is transmitted through the H.323 trunk. The H.323 trunks on PBX3 and PBX4 use the peer gatekeeper mode.
Registration mode
One-to-one registration mode
As shown in Figure 2-26, PBX5 is a gateway and PBX6 is a gatekeeper. PBX6 needs to authenticate the registered PBX5 through gwid. After PBX5 is successfully authenticated, PBX5 and PBX6 can communicate with each other.
One-to-many registration mode
As shown in Figure 2-27, PBX7 and PBX8 are gateways, and PBX9 is a gatekeeper. PBX9 needs to authenticate the registered PBX7 and PBX8 through gkid. After PBX7 and PBX8 are successfully authenticated, PBX7, PBX8, and PBX9 can communicate with one another.
Prerequisites
Media and signaling IP address pools have been configured. For details, see Configuring Media and Signaling IP Address Pools.
Configuring Protocol Attributes
Step |
Action |
Command |
Description |
---|---|---|---|
1 |
Enter the system view. |
system-view |
- |
2 |
Enter the voice view. |
voice |
- |
3 |
Enter the H.323 attribute view. |
h323-attribute |
- |
4 |
Configure the default local IP address. |
localip ip-address |
- |
5 |
(Optional) Configure Q.931 signaling port. |
q931-listenport q931listenport-value |
By default, the Q.931 signaling port is 1720. |
6 |
(Optional) Configure whether to enable the fast start mode. |
faststart-flag { enable | disable } |
By default, fast start is enabled.
NOTE:
After the fast start function is enabled, sessions can be set up quickly. |
7 |
(Optional) Configure whether to support the H.245 signaling tunnel. |
support-h245tul { enable | disable } |
By default, the PBX does not support the H.245 signaling tunnel. |
8 |
(Optional) Configure the work mode of the H.323 protocol stack. |
workmode workmode-value |
The values are as follows:
|
9 |
(Optional) Configure the UDP port of RAS signaling. |
rasport rasport-value |
By default, the UDP port number of RAS signaling in peer gateway mode is 1720, and that in peer gatekeeper mode and registration mode is 1719. |
(Optional) Configure the name of the H.323 protocol stack. |
h323-systemname H.323systemname-value |
By default, the H.323 stack system name is HUAWEI. |
|
10 |
(Optional) Configure the name of the H.323 protocol stack. |
productname productname-value |
By default, the name of the product using the H.323 stack is HUAWEI-AR. |
11 |
(Optional) Set the H.323 protocol version. |
h323version H.323version-value |
The values are as follows:
The default H.323 protocol version is V4. |
12 |
(Optional) Set the H.245 protocol version. |
h245version h245version-value |
The values are as follows:
The default H.245 protocol version is V4. |
13 |
(Optional) Configure the display header in Q.931 messages. |
displayname displayname-value |
By default, the display header in Q.931 messages is HUAWEI. |
14 |
(Optional) Set the TCP keepalive timer. |
tcp-keepalive-timerlen tcp-keepalive-timerLen-value |
By default, the TCP keepalive timer is 3600 ms. |
15 |
(Optional) Configure whether to support automatic setup of the H.245 channel. |
auto-connect-controlchannel { enable | disable } |
By default, H.245 channels cannot be set up automatically. |
16 |
(Optional) Configure whether the H.245 address is received in the setup messages. |
earlyh245 { enable | disable } |
By default, the H.245 address is not received in setup messages. |
17 |
(Optional) Set the TCP connection timeout interval. |
tcp-connection-timeout tcp-connection-timeout-value |
By default, the timeout interval of TCP connections is 15000 ms. |
18 |
(Optional) Configure the setup message timeout. |
setup-wait-response-timeout setup-wait-response-timeout-value |
By default, the setup message timeout is 500000 ms. |
19 |
(Optional) Set the timeout interval for the Alerting or Connect message from the called party. |
callproc-wait-response-timeout callproc-wait-response-timeout-value |
By default, the interval between Alerting and Connect messages is 500000 ms. |
20 |
(Optional) Configure Connect message timeout. |
recvalert-wait-response-timeout recvalert-wait-response-timeout-value |
By default, the Connect message timeout is 500000 ms. |
21 |
(Optional) Set the channel establishment timeout. |
channels-timeout channels-timeout-value |
By default, the channel establishment timeout is 15000 ms. |
22 |
(Optional) Set the timeout interval of the roundtrip delay process. |
roundtrip-delay-timeout roundtrip-delay-timeout-value |
By default, the timeout interval of the roundtrip delay process is 15000 ms. |
23 |
(Optional) Set the timeout interval for mode switching. |
requestmode-timeout requestmode-timeout-value |
By default, the timeout interval for mode switching is 15000 ms. |
24 |
(Optional) Set the timeout interval of the media loop process. |
medialoop-timeout medialoop-timeout-value |
By default, the timeout interval of the media loop process is 15000 ms. |
25 |
(Optional) Set the timeout interval for the peer end to send EndSessionCommand messages. |
endsession-timeout endsession-timeout-value |
By default, the timeout interval for the peer end to send EndSessionCommand messages is 3000 ms. |
26 |
(Optional) Configure the H.323 timer. |
h323-app-timer timerindex timerlen |
For the default values, see the command reference. |
27 |
Restart the H.323 system. |
reset |
After configuring the H.323 attributes, restart the H.323 system to make the parameters effective. |
28 |
(Optional) Return to the voice view. |
quit |
- |
Configuring the Trunk Group
Step |
Action |
Command |
Description |
---|---|---|---|
1 |
Create an H.323 trunk group and enter the H.323 trunk group view. |
trunk-group name [ h323 h323-type ] |
If a trunk group has been created, you can directly enter the trunk group view. |
2 |
Configure the local media IP address or dynamic media IP address name. |
media-ip { ip-address | addr-name addr-name-value } |
- |
3 |
Configure the gateway ID of the trunk group. |
gwid gwid-value |
This command is applicable to the H.323 trunks of the register-gateway and gw-gk types. The H.323 trunk group of the gw-gk type must have a gateway ID configured, and the gateway ID must be the same as that on the peer H.323 trunk group of the register-gateway type; otherwise, authentication will fail. |
4 |
Configure the remote IP address and port. |
peer-address static primary-ip-address primary-port-value [ secondary secondary-ip-address secondary-port-value ] |
This command is applicable to the H.323 trunks of the symmetrical, gw-gk, and gk-gk types. The connection data on the trunk group must be the same as that on the peer. |
5 |
(Optional) Configure IDs of the active and standby gatekeepers with which a gateway registers on the gateway. |
gkid id secondary secondary-id |
This command is applicable to the H.323 trunk groups of the gw-gk type. |
6 |
Reset the H.323 trunk group. |
reset |
After creating or modifying an H.323 trunk group, run this command to make the configuration effective. |
7 |
(Optional) Configure a technical prefix. |
techprefix techprefix-value |
When multiple H.323 trunk groups are configured, this step is required. |
8 |
(Optional) Configure whether to send the technical prefix. |
send-techprefix H.323-send-techprefix-value |
When multiple H.323 trunk groups are configured, this step is required. |
9 |
(Optional) Configure whether to delete the technical prefix. |
del-techprefix H.323-send-techprefix-value |
When multiple H.323 trunk groups are configured, this step is required. |
10 |
(Optional) Configure the gateway registration timeout for the trunk group. |
ttlrrq id |
This command is applicable to the H.323 trunk groups of the gw-gk type. |
11 |
(Optional) Configure the gatekeeper to or not to send heartbeat messages. |
send-heartbeat { disable | enable } |
This command is applicable to the H.323 trunk groups of the gk-gk type. |
12 |
(Optional) Configure the heartbeat detection timeout and retransmission times for the gatekeeper. |
heartbeat { timeout time | retrycount count } * |
This command is applicable to the H.323 trunk groups of the gk-gk type. By default, the heartbeat detection timeout is 10s and retransmission times is 3. |
13 |
(Optional) Configure the enterprise that the H.323 trunk group belongs to and the bound DN set. |
enterprise enterprise-name [ dn-set dn-set-name ] |
By default, an H.323 trunk group belongs to the enterprise default and DN set DefaultDialPlan. You need to perform this step only when multiple enterprises and DN sets are configured. For details on how to configure an enterprise and a DN set, see Configuring an Enterprise and a DN Set. |
14 |
(Optional) Configure a trunk group circuit selection mode. |
select-mode selectmode-value |
The following circuit selection modes are available:
|
15 |
(Optional) Configure the default country code and area code. |
country-code country-code-value area-code area-code-value |
This command configures the country code and area code for incoming calls over an H.323 trunk group. When incoming calls do not carry the country code and area code, the PBX adds the configured country code and area code so that intra-office users can view calls and call back through call display. |
16 |
(Optional) Configure the default number displayed. |
default-caller-telno telno-value |
- |
17 |
(Optional) Configure the description for the H.323 trunk group. |
description desc-value |
- |
18 |
(Optional) Configure a registration E.164 number on an H.323 trunk group. |
register-E164-number E164-telno-value |
This step needs to be performed when the remote GK uses the registration E.164 number. |
19 |
(Optional) Configure a gateway prefix. |
gatekeeper-techprefix gatekeeper-techprefix-value |
This operation is applicable to gw-gk type H.323 trunk groups. By default, no gateway technical prefix is configured in the system. |
20 |
Restart the H.323 trunk group. |
reset |
After configuring the H.323 trunk group, restart the H.323 trunk group to make the parameters effective. |
21 |
Save the configuration. |
save |
- |
Example 1 (H.323 Peer Gateway Mode)
PBX1 of the enterprise headquarters and PBX2 of the branch are located in different areas. They communicate with each other through the H.323 trunk group (h323a) in peer gateway mode. The media IP address of PBX1 is 192.168.1.3 and of PBX2 is 192.168.1.4. The port numbers of the PBX1 and PBX2 are both 1720.
# Configure the H.323 attributes for PBX1. <Huawei> system-view [Huawei] voice [Huawei-voice] h323-attribute [Huawei-voice-h323-attribute] localip 192.168.1.3 [Huawei-voice-h323-attribute] reset [Huawei-voice-h323-attribute] quit # Configure the trunk group for PBX1. [Huawei-voice] trunk-group h323a h323 symmetrical [Huawei-voice-trunkgroup-h323a] media-ip 192.168.1.3 [Huawei-voice-trunkgroup-h323a] peer-address static 192.168.1.4 1720 [Huawei-voice-trunkgroup-h323a] reset [Huawei-voice-trunkgroup-h323a] save # The methods on PBX1 and PBX2 are the same except that the local and remote IP addresses on the two ends are different.
Example 2 (H.323 Peer Gatekeeper Mode)
PBX3 of the enterprise headquarters and PBX4 of the branch are located in different areas. They communicate with each other through the H.323 trunk group (h323a) in peer gatekeeper mode. The media IP address of PBX3 is 192.168.3.3 and of PBX4 is 192.168.3.4. The port numbers of the PBX3 and PBX4 are both 1719.
# Configure the H.323 attributes for PBX3. <Huawei> system-view [Huawei] voice [Huawei-voice] h323-attribute [Huawei-voice-h323-attribute] localip 192.168.3.3 [Huawei-voice-h323-attribute] reset [Huawei-voice-h323-attribute] save # Configure the trunk group for PBX3. [Huawei-voice] trunk-group h323a h323 gk-gk [Huawei-voice-trunkgroup-h323a] media-ip 192.168.3.3 [Huawei-voice-trunkgroup-h323a] peer-address static 192.168.3.4 1719 [Huawei-voice-trunkgroup-h323a] send-heartbeat enable [Huawei-voice-trunkgroup-h323a] reset [Huawei-voice-trunkgroup-h323a] quit # The methods on PBX3 and PBX4 are the same except that the local and remote IP addresses on the two ends are different.
Example 3 (One-to-One Registration Mode)
PBX6 of the enterprise headquarters and PBX5 of the branch are located in different areas. They communicate with each other through the H.323 trunk group (h323a) in registration mode. PBX5 functions as the gateway, and PBX6 functions as the gatekeeper. The media IP address of PBX5 is 192.168.5.5. The media IP address of PBX6 is 192.168.5.6 and port number is 1719.
# Configure the H.323 attributes for PBX5. <Huawei> system-view [Huawei] voice [Huawei-voice] h323-attribute [Huawei-voice-h323-attribute] localip 192.168.5.5 [Huawei-voice-h323-attribute] reset [Huawei-voice-h323-attribute] quit # Configure the trunk group for PBX5. [Huawei-voice] trunk-group h323a h323 gw-gk [Huawei-voice-trunkgroup-h323a] media-ip 192.168.5.5 [Huawei-voice-trunkgroup-h323a] gwid gwpbx6 [Huawei-voice-trunkgroup-h323a] peer-address static 192.168.5.6 1719 [Huawei-voice-trunkgroup-h323a] reset [Huawei-voice-trunkgroup-h323a] save # Configure the H.323 attributes for PBX6. <Huawei> system-view [Huawei] voice [Huawei-voice] h323-attribute [Huawei-voice-h323-attribute] localip 192.168.5.6 [Huawei-voice-h323-attribute] reset [Huawei-voice-h323-attribute] quit # Configure the trunk group for PBX6. [Huawei-voice] trunk-group h323a h323 register-gateway [Huawei-voice-trunkgroup-h323a] media-ip 192.168.5.6 [Huawei-voice-trunkgroup-h323a] gwid gwpbx6 [Huawei-voice-trunkgroup-h323a] reset [Huawei-voice-trunkgroup-h323a] quit
Example 4 (One-to-Many Registration Mode)
PBX9 of the enterprise headquarters, and PBX7 and PBX8 of the branch are located in different areas. PBX7 and PBX8 communicate with PBX9 through the H.323 trunk group (h323a) in registration mode. PBX7 and PBX8 function as the gateways, and PBX9 functions as the gatekeeper. The media IP addresses of PBX7, PBX8, and PBX9, are 192.168.7.7, 192.168.7.8, and 192.168.7.9, respectively. The port number of PBX9 is 1719.
# Configure H.323 attributes for PBX7. <Huawei> system-view [Huawei] voice [Huawei-voice] h323-attribute [Huawei-voice-h323-attribute] localip 192.168.7.7 [Huawei-voice-h323-attribute] reset [Huawei-voice-h323-attribute] quit # Configure the trunk group for PBX7. [Huawei-voice] trunk-group h323a h323 gw-gk [Huawei-voice-trunkgroup-h323a] media-ip 192.168.7.7 [Huawei-voice-trunkgroup-h323a] gkid gkpbx9 [Huawei-voice-trunkgroup-h323a] gwid gwpbx7 [Huawei-voice-trunkgroup-h323a] peer-address static 192.168.7.9 1719 [Huawei-voice-trunkgroup-h323a] reset [Huawei-voice-trunkgroup-h323a] quit # Configure H.323 attributes for PBX8. <Huawei> system-view [Huawei] voice [Huawei-voice] h323-attribute [Huawei-voice-h323-attribute] localip 192.168.7.8 [Huawei-voice-h323-attribute] reset [Huawei-voice-h323-attribute] quit # Configure the trunk group for PBX8. [Huawei-voice] trunk-group h323a h323 gw-gk [Huawei-voice-trunkgroup-h323a] media-ip 192.168.7.8 [Huawei-voice-trunkgroup-h323a] gkid gkpbx9 [Huawei-voice-trunkgroup-h323a] gwid gwpbx8 [Huawei-voice-trunkgroup-h323a] peer-address static 192.168.7.9 1719 [Huawei-voice-trunkgroup-h323a] reset [Huawei-voice-trunkgroup-h323a] quit # Configure H.323 attributes for PBX9. <Huawei> system-view [Huawei] voice [Huawei-voice] h323-attribute [Huawei-voice-h323-attribute] localip 192.168.7.9 [Huawei-voice-h323-attribute] reset [Huawei-voice-h323-attribute] quit # Configure the trunk group for PBX9. [Huawei-voice] trunk-group h323a h323 gatekeeper [Huawei-voice-trunkgroup-h323a] media-ip 192.168.7.9 [Huawei-voice-trunkgroup-h323a] gkid gkpbx9 [Huawei-voice-trunkgroup-h323a] reset [Huawei-voice-trunkgroup-h323a] save
Verification
Action |
Command |
Expected Result |
---|---|---|
Verify the H.323 trunk group configuration. |
display voice trunk-group [ name [ para-value ] ] |
The parameter values in the command output are consistent with the settings. |
Verify information about the prefix used by the H.323 trunk group registered with a gatekeeper. |
display voice gatekeeper callprefix |
The prefix information of the gateway registered with the gatekeeper is displayed in the command output. |
Verify the dynamic information of a gateway registered with a gatekeeper. |
display voice gatekeeper endpoints |
The dynamic information of the gateway registered with the gatekeeper is displayed in the command output. |