h323 CONFIGURATION
h323 CONFIGURATION
Copyright
Disclaimer
The contents of this document are subject to revision without notice due to
continued progress in methodology, design, and manufacturing.
Ericsson shall have no liability for any errors or damages of any kind resulting
from the use of this document.
Abstract
Contents
1 General................................................................................................2
1.1 Revision History ..................................................................................2
1.2 Glossary ..............................................................................................2
1.3 Scope ..................................................................................................4
1.4 Introduction..........................................................................................7
2 How to Use ........................................................................................18
3 Configuration .....................................................................................30
4 References ........................................................................................35
Open
USER GUIDE 2 (40)
Prepared (also subject responsible if other) No.
1 General
1.1 Revision History
Version
Date Comments
Signature
A This is a new document.
2005-09-16
ETKTPZ
PB1 Document is updated to reflect changes introduced as
2006-01-27 part of CN-G1:
- Possibility to add/remove destination IP addresses
to/from IPG during operation for both types of RHOST.
- Possibility to define local and remote port number for
call signalling for RHOST of type gateway when
corresponding IPG contains more than one destination IP
address.
1.2 Glossary
1.2.1 Concepts
Telephony Server
The Telephony Server controls the Media Gateway (MGW) application in the
MSG in order to provide support for voice and narrowband data services. It
comprises three main parts:
The CCF is based on the AXE platform and it handles call control and
telephony functions such as termination of call control signalling, number and
routing analysis, charging analysis, supplementary services, etc.
Open
USER GUIDE 3 (40)
Prepared (also subject responsible if other) No.
Server port
Server port is a TCP/UDP port used by the server to listen for incoming
requests.
Client port
Client port is a TCP/UDP port used by the client to initiate a request to server.
Well-known port
Endpoint
H.323 Gateway
Gatekeeper
H.323 entity
H.323 zone
Open
USER GUIDE 4 (40)
Prepared (also subject responsible if other) No.
Administrative domain
Transport Address
H.323
H.225.0
H.245
RAS
1.2.2 Abbreviations
CP Central Processor
EM Extension Module
EP Endpoint
GK Gatekeeper
GW Gateway
HW Hardware
IP Internet Protocol
ML Mediation Logic
RP Regional Processor
1.3 Scope
1.4 Introduction
1.4.1 General
ISUP
network H.323
network
SIP/SIP-T
network EIN H.323
network
H.323
network H.323
BICC network
network
The H.323 Gateway supports the following signalling protocols from H.323
family:
While H.225.0 Call signalling and H.245 are used between TeS, as an
endpoint of gateway type, and peer endpoint (gateway, gatekeeper), H.225.0
RAS signalling is used exclusively between TeS and corresponding
gatekeeper. The H.323 Gateway function supports transfer of H.225.0 Call
signalling and H.245 signalling over TCP, while transfer of H.225.0 RAS
signalling is supported over UDP. For detailed protocol information, please,
refer to [PS1] and [PS2].
The H.323 Gateway supports non-call related and call related RAS signalling.
Non-call related RAS signalling constitutes procedures used to register and
unregister TeS, as an endpoint of gateway type, with the gatekeeper. In
addition, the gatekeeper can request unregistration of TeS using non-call
related RAS signalling.
Call related RAS signalling constitutes procedures to obtain admission for the
call from the gatekeeper, to request the gatekeeper to perform address
translation and to inform the gatekeeper of the call status or call release. The
gatekeeper can use RAS signalling to request call status or force call release.
Open
USER GUIDE 8 (40)
Prepared (also subject responsible if other) No.
Call signalling is used towards peer H.323 endpoint in order to establish and
release calls and to provide call status. Also, bearer can be established and
released using call signalling, in case remote peer supports such procedure.
Detailed call setup related information is available in [FS2].
GW
GW
GK
TeS
GW
GW
GK
GW
GW
GW
GW GW
TeS
GW
GW
GW
H.323 network
N:1
DEVICE ROUTE
1:1
EP
1:1
1:1
IPG RHOST
M:N
1:1
IPPORT LHOST
1:1 1:1
IP EQM
CP
1:1
IP EM H.323 EM
RP
1:1 1:1
GARP HW
Internet Protocol Group (IPG) is another ‘one per H.323 network’ object and
it enables definition of IP addresses of remote peers belonging to a particular
network. In addition to its numerical value, ‘source’ and/or ‘destination’
property can be defined for each IP address. Based on this property, IPG is
internally divided in two sub-groups: source and destination IP addresses.
Note that at least one destination IP address has to be defined in an IPG
while RHOST is connected to it.
Open
USER GUIDE 11 (40)
Prepared (also subject responsible if other) No.
For H.323 networks comprising only H.323 gateways, the H.323 Gateway
function uses both sub-groups and offers outgoing calls only to gateways
defined as destinations and accepts incoming calls only from gateways
defined as sources. This offers significant flexibility since each H.323 gateway
can be defined as source, destination or source and destination for H.323
calls.
For H.323 networks comprising H.323 zones, the H.323 Gateway function
does not use sub-group of source IP addresses, because it does not perform
filtering of incoming calls based on source IP address. Responsibility for
admitting incoming, as well as, outgoing calls, lies with the gatekeeper
controlling the corresponding zone.
For H.323 networks comprising zones, TeS, using the H.323 Gateway
function, registers its available RAS and call signalling transport addresses
with the gatekeeper in every zone. Addresses are registered after every
restart and whenever set of working transport addresses out of those
provisioned for particular H.323 network changes (due to GARP failure or
recovery). In addition, registration procedure is initiated in certain cases not
related to changes in the set of working transport addresses such as:
• At manual deblocking of an EP
• After gatekeeper-initiated unregistration procedure is concluded.
• At any time registration is considered lost by the H.323 Gateway or
gatekeeper has indicated loss of registration
The H.323 Gateway registration with a gatekeeper can be valid for a limited
time. In such a case, the H.323 Gateway function will refresh its registration
prior to expiration time. Note that this only extends validity of an existing
registration including registered transport addresses.
Gatekeeper itself uses registered RAS transport addresses for sending call
related and non-call related RAS signalling towards gateway. On the other
hand, the gatekeeper can, during admission procedure, provide one of the
TeS’s registered call signalling transport addresses to another gateway
originating the call. In this case, peer gateway communicates directly with
TeS and this is referred to as ‘direct call model’. Another option is for the
gatekeeper to route the call signalling itself and use TeS’s address as
destination address for call signalling. Such model is called ‘gatekeeper
routed call model’. The H.323 Gateway function supports both models.
The H.323 Gateway uses server port for RAS signalling as client port, that is,
the same port number is used for incoming and outgoing RAS signalling.
Client ports for call signalling (used for outgoing calls) are dynamically opened
and port number is seized from the operator controllable range. For more
details regarding related AXE parameters, refer to [AI10]. Calls are destined
to the address provided by the gatekeeper during admission procedure.
Open
USER GUIDE 13 (40)
Prepared (also subject responsible if other) No.
Described usage of port numbers and different call models are illustrated in
the figure below. Please note that only server ports are marked with colored
circles.
GW
GK
TeS
GW
GK
GW
Port for call signalling as provided Well-known port for RAS signalling
during admission procedure
For such networks, the H.323 Gateway function accepts incoming calls on the
well-known port number for call signalling (server port). However, it is possible
to manually configure port number for call signalling server port at TeS for
H.323 network comprising only H.323 gateways.
Similarly, H.323 Gateway uses well-known port number for call signalling as
server port at peer gateways when establishing outgoing calls. But it is
possible to manually configure port number used as call signalling server port
at peer gateways. Client ports for call signalling in TeS (used for outgoing
calls) are dynamically opened and port number is seized from the operator
controllable range. For more details regarding related AXE parameters, refer
to [AI10].
GW
GW
GW
TeS
GW
GW
GW
GW
GW
Configured port
Call direction
AXE
EP 1 EP 2 EP 3
Using the first method, all outgoing calls will be offered to one gateway/zone.
Other destination gateways/zones serve only as a backup. See below for
description of call re-routing to a different destination. The second method
offers possibility of distributing outgoing traffic between certain destination
gateways/zones according to provisioned percentage distribution assigned to
corresponding destination IP addresses. For this method, all gateways/zones
not offered the call initially could serve as backup if particular call fails.
GW
GW
GW
GW
TeS
GW 30% GW
GW
50%
20%
0%
GW
GW
GW
0%
TeS
Please note that H.323 Gateway function does not in any way verify whether
called terminal is reachable through all destination gateways/zones or not.
Such network architecture is assumed by this solution.
Incoming calls are accepted from all gateways defined as part of source sub-
group of IPG (defined in 1.4.2) corresponding to particular H.323 network
comprising only gateways. Similarly, for calls received over any of the network
interfaces registered with gatekeepers controlling the zones contained in
particular H.323 network, the H.323 Gateway function will initiate call
admission procedure with the respective gatekeeper. This allows for similar
call re-routing function to be deployed by the node in the cooperating network
in case of fault in transit H.323 gateway/zone.
Open
USER GUIDE 18 (40)
Prepared (also subject responsible if other) No.
GW
GW
GW
GW
GW
TeS
2 How to Use
2.1 Printouts
In order to facilitate usage of the H.323 Gateway function and due to large
number of managed objects, corresponding data and relationships, a number
of printouts are grouped in this chapter and organized according to related
objects.
EXRPP:RP=2;
EXRUP:RP=2;
EXRIP:RP=2;
Printout of EM state and associated device for one or several EMs is ordered
by means of EXEMP command. As an example, printout of EM state is
ordered for all EMs connected to the RP with address 2.
EXEMP:RP=2,EM=ALL;
IHCOP:IPPORT=IP-1-2;
IHSTP:IPPORT=ALL;
Printout of binding state and bound IP address, as well as, associated RP for
specified LHOST is ordered by means of H3SBP command. As an example,
printout of binding state and related data is ordered for LHOST with
equipment number 1.
H3SBP:LHOST=H3STH-1;
H3SRP:RHOST=DUBLIN,RL;
Printout of detailed IPG data including IPG state, all connected IP addresses
and percentage distribution is ordered by means of IFIGP command. In
addition, the same command can be used to obtain IPGs that certain IP
address is connected to. Printout ‘IP GROUP DATA’ is received as a result in
both cases. As an example, printout of detailed IPG data is ordered for IPG 1.
IFIGP:IPG=IPG-1;
IFFSP;
2.1.5 EP Data
Printout of EP data, its state and connections to route and RHOST is ordered
by means of H3EPP command. As an example, printout of EP data is ordered
for all defined EPs.
H3EPP:EP=ALL;
EXROP:DETY=HACORE;
EXRFP:R=H3231O;
EXDEP:R= H3231O;
STDEP:DEV=HACORE-1&&-2048;
STRDP:R=H3231O,STATE=BUSY&INCO;
Open
USER GUIDE 22 (40)
Prepared (also subject responsible if other) No.
STRSP:R=H3231O;
STBSP:DETY=HACORE,BLSTATE=MBL;
H3SRC:RHOST=DUBLIN,LHOST=H3STH-1&-3&&-6;
H3SRC:RHOST=DUBLIN,LHOST=H3STH-1&&-6;
Depending on the type of RHOST and number of remote peers (as described
in 1.4.3), local and remote server port number for call signalling and local
server port number for RAS can be manually assigned to RHOST. If required,
configured port numbers can be changed but only when corresponding EP is
manually blocked and without traffic.
As an example of this procedure, local and remote server port number for call
signalling are changed for RHOST of gateway type (DUBLIN). In addition,
local server port number for call signalling and for RAS is changed for RHOST
of gatekeeper type (CORK).
H3SRC:RHOST=DUBLIN,LCS=1589,RCS=2500;
H3SRC:RHOST=CORK,LCS=1560,LRAS=2090;
H3SRP:LHOST= H3STH-2,LR;
H3SBP:LHOST=H3STH-2;
Then, LHOST can be unbound, IP address changed and LHOST bound to the
new address:
H3SBE:IPADD=”159.107.227.183”,LHOST=H3STH-2;
IHCOC:IPPORT=IP-6-2,IPADD1=”159.107.227.207”;
H3SBI: IPADD=”159.107.227. 207”,LHOST=H3STH-2;
Note that other IPPORT parameters, such as subnet mask, MTU or address
of the default gateway, can be modified during operation according to the
procedure defined in [OPI21] regardless of the bounding state of the LHOST.
Open
USER GUIDE 24 (40)
Prepared (also subject responsible if other) No.
For H.323 networks comprising only H.323 gateways, this procedure can be
used to change supported direction of H.323 calls. Thus, it is possible to
restrict the traffic (on a remote gateway basis) to incoming or outgoing only or
allow bothway traffic, according to bilateral agreements. This possibility can
be useful for blocking incoming traffic from non-paying operators but allowing
traffic outgoing towards these operators.
IFIAI:IPG=IPG-4,IPADD=”159.108.227.156”;
IFIAE:IPG=IPG-4,SOURCE;
It, also, supports online switching between selection methods, as well as,
changing the percentage distribution. These changes take effect immediately
upon completion of the procedure. Execution of the procedure is defined in
[OPI6] and this chapter will, as an example, present a command sequence
required to change selection method from Master Destination to Percentage
Distribution as depicted in Figure 9.
IFIGP:IPG=IPG-4;
Open
USER GUIDE 25 (40)
Prepared (also subject responsible if other) No.
IFFPI:IPG=IPG-4;
IFFSC:IPADD=”159.108.227.156”,FREQ=50;
IFFSC:IPADD=”159.108.227.157”,FREQ=30;
IFFSC:IPADD=”159.108.227.158”,FREQ=20;
IFFSC:IPADD=”159.108.227.159”,FREQ=0;
IFFSC:IPADD=”159.108.227.160”,FREQ=0;
IFFSP;
IFFPE;
IHPRI:IPPORT=IP-6-2,RIP=”159.108.227.156”;
H3EPC:EP=NYTES,TA=”GW1[at]MCI.COM”,VCESP=”6#”;1
1
The text ‘[at]’ is used instead of @ sign in the example to prevent Word from interpreting the TA parameter as an
email address and, thereby, hiding the proper parameter syntax.
Open
USER GUIDE 26 (40)
Prepared (also subject responsible if other) No.
The H.323 Gateway function offers these as a means for engineering traffic
levels to and from H.323 networks. However, it doesn’t control soundness of
parameter settings. It is left to the operator to utilize the parameters in a
sensible fashion. For example, it doesn’t make any sense to set MAXI or
MAXO parameter to a value higher than the number of devices connected to
the route and manually deblocked. Similarly, if number of devices connected
to corresponding route and manually deblocked is higher than the value of
(MAXI + MAXO), the total number of simultaneous calls is defined by the sum
(MAXI + MAXO) and additional devices will not carry traffic.
As an example, incoming and outgoing traffic levels are limited for a route
having 12000 devices connected and manually deblocked.
H3EPC:EP=NYTES,MAXI=8000,MAXO=10000;
By this command, 4000 devices are reserved for outgoing traffic while 2000
devices are reserved for incoming traffic.
Parameters KATIME, PGARQ, RMNR and RRT are RAS related parameters
that define behavior of TeS as an H.323 gateway in particular H.323 network
comprising H.323 zones.
KATIME parameter defines how often will H.323 Gateway function refresh the
registration of the TeS as H.323 gateway in case its registration with the
gatekeeper is valid for a limited time.
Open
USER GUIDE 27 (40)
Prepared (also subject responsible if other) No.
Since RAS signalling is transferred over UDP, messages are not delivered
reliably by the TCP/IP stack. Therefore, the H.323 Gateway function
implements the retransmission of RAS messages as defined by H.225.0
recommendation. Parameters RMNR and RRT are related to retransmission
and define whether retransmission will be performed at all, how many times
will a message be retransmitted before message sending is considered failed
and time period between retransmissions.
Parameter MWC defines whether remote peer will be requested, through call
signalling, to withhold sending of media stream before it sends Connect
message.
In case connected H.323 network consists of H.323 zones but operator, for
whatever reason, does not want to use RAS signalling between TeS as H.323
gateway and gatekeepers controlling corresponding zones, the H.323
Gateway function should be configured as connected to H.323 network
comprising only H.323 gateways.
H3SRI:RHOST=DUBLIN,IPG=IPG-4,TYPE=GW;
At TeS side, the H.323 Gateway function has to be manually configured with
call signalling transport addresses of all gateways that TeS will accept
incoming calls from and of all gateways that TeS will offer outgoing calls to.
For detailed description of remote peers’ addresses handling and source and
destination properties, refer to IPG description in 1.4.2.
IFIAI:IPG=IPG-4,IPADD=”159.108.227.186”;
IFIAI:IPG=IPG-4,IPADD=”159.108.227.156”;
IFIAI:IPG=IPG-4,IPADD=”159.108.227.157”;
IFIAI:IPG=IPG-4,IPADD=”159.108.227.158”;
IFIAI:IPG=IPG-4,IPADD=”159.108.227.159”;
IFIAI:IPG=IPG-4,IPFIRST=”159.108.227.156”, IPLAST=”159.108.227.165”;
IFIAI:IPG=IPG-4,IPFIRST=”159.108.227.186”, IPLAST=”159.108.227.186”;
Please note that IPG is configured before RHOST is connected to it. For a
detailed explanation of the H.323 Gateway function configuration, turn to
chapter 3.
Call capacity of an H.323 route can be properly sized using commands for
manual blocking/deblocking (BLODI/BLODE) of connected devices and for
connecting/disconnecting (EXDRI/EXDRE) devices to/from the route during
operation (online) without any disturbances to the ongoing traffic.
SAAII:SAE=500,BLOCK=HACSPH,NI=70000;
SAAII:SAE=500,BLOCK=HA245PH,NI=70000;
SAAII:SAE=500,BLOCK=HACORE,NI=70000;
Open
USER GUIDE 29 (40)
Prepared (also subject responsible if other) No.
SAAII:SAE=500,BLOCK=HARASPH,NI=52000;
Finally, devices can be connected to the route and manually deblocked. Note
that a maximum of 32 devices can be manually deblocked with one BLODE
command.
EXDRI:R=H323O&H323I,DEV=HACORE-68000&&-69999;
BLODE:DEV= HACORE-68000&&-68031;
BLODE:DEV= HACORE-68032&&-68063;
…..
Certain fault indicating events for H.323 EMs are handled through ‘Event
Reporting and Disturbance Supervision’ function (see [FS5]) as described in
[FS4]. If the H.323 Gateway function detects loss of communication with
H.323 EM during operation, it will start communication test. Depending on the
result, it will report one of the following two events:
For the latter event, it is recommended to store reports in the ‘Permanent’ list
with maximum number of reports being set to 16. As for the former event,
neither time nor number filtering shall be ordered. In addition, it is
recommended to set single alarm threshold to the value 0. Such setting will
result in ‘EVENT REPORTING THRESHOLD REACHED’ alarm being
received for every reported occurrence of event 1067.
Prior to activation of the Event Reporting, Event Reports data file should be
increased sufficiently. For more detailed information, refer to [AI12]. Event
reporting for above listed events should be activated with specified event
reporting data according to the procedure defined in [OPI19]. Some additional
information regarding the procedure, including examples, can be found in
[ADI4].
DIRRP:RP=2;
BLRPI:RP=2,FORCED;
BLRPE:RP=2;
3 Configuration
3.1 General
IP 600 [AI3]
IP 601 [AI3]
IP 602 [AI3]
The first step in initializing the function is to equip the magazines with
sufficient number of RP boards that will be used for H.323 signalling and to
connect power and bus cables. It should be noted that used RP boards must
be of type GARP (e.g. GARP1A). Usage of multiple RP boards is
recommended for the reasons of scalability and fault resilience.
All RP boards have to be loaded with the following Operating System RSUs:
• RPFDR
• RPIFDR
• INETR
• GPEXR
• IPR
• H3STHR
Note that EM0 is, usually, used for IP EM while EM1 is used for H3STH EM.
Definition of other EMs, in addition to those mentioned above, is not
recommended due to capacity reasons (to reserve GARP capacity for
handling of H.323 signalling).
Finally, the route and the EP are deblocked, thereby, enabling H.323 traffic. In
addition to configuration steps described in previous chapters, prerequisite for
this step is definition of Media Gateway Groups to be used for H.323 calls
over the particular route. Procedure described above is executed according to
[OPI9].
Open
USER GUIDE 35 (40)
Prepared (also subject responsible if other) No.
Before other actions can be performed, the H.323 traffic has to be stopped.
Manual EP blocking is used for this purpose. When traffic is completely
stopped, route has to be disconnected from the EP, the EP has to be
disconnected from the RHOST and deleted. Subsequently, H.323 devices
connected to the route have to be manually blocked and disconnected from
the route. Before the route is deleted, it has to be removed from the routing
analysis. This procedure is executed according to [OPI10].
As a first step for this task, RHOST has to be disconnected from the
corresponding IPG, from connected LHOSTs and deleted according to
[OPI11]. Then, IPG has to be deleted by deleting all defined source and
destination IP addresses of the remote peers according to [OPI12].
As a final step in this task, IPPORT has to be blocked, disconnected from the
corresponding IP EM and deleted. This procedure is executed according to
[OPI14]. Note that this OPI is not written in generic fashion (it is SCTP
oriented), and some actions are not applicable to H.323 Gateway. However,
those actions will be skipped because, after executing previous actions,
LHOST is no longer registered as a user of the IP address on IPPORT (state
of IPPORT is not BUSY). In addition, when End point is mentioned in the OPI
it, actually, refers to SCTP End point, not H.323 EP.
Both EMs (H323 and IP EM) connected to RP used for the H.323 Gateway
have to be disconnected. As GARP type of RP board is used by this function,
manual blocking of EMs is not applicable. In addition, RP of GARP type is
connected to RP bus of serial type (RPB-S). The procedure is executed
according to [OPI15].
Some of the AXE parameters used by the H.323 Gateway function are
mentioned in this document. However, the complete set of used AXE
parameters and corresponding descriptions can be found in the following
Application Information documents:
4 References
4.1 Function Specifications
[OPI17] RP FAULT
[POD1] RP DATA
[POD4] EM DATA
[POD19] RP FAULT