blob: 8b8e3bfcd06860fe9051d41d269cea1f07871749 [file] [log] [blame]
Daniel Willmann27780312018-07-31 18:53:45 +02001== Configuring OsmoMGW
2
3A basic configation of OsmoMGW mainly consists of specifying the IP address
4and port on which to listen to MGCP commands, but changing the port range at
5which the RTP streams terminate as well as limiting operation to a single call
6agent can be done as well as changing the number of endpoints.
7
8=== Configuring MGCP
9
10By default OsmoMGW listens for MGCP on port 2427 on any IP address. If a call
11agent address is configured then OsmoMGW will only answer MGCP commands from
12that IP port 2727, otherwise all sources are handled. A domain can be
13specified
14
15.Example: MGCP configuration
16----
17OsmoMGW(config-mgcp)# bind ip 127.0.0.1
18OsmoMGW(config-mgcp)# bind port 2427
19OsmoMGW(config-mgcp)# call-agent ip 127.0.0.1
20OsmoMGW(config-mgcp)# domain mgw-bsc
21OsmoMGW(config-mgcp)# local ip 127.0.0.1
22----
23
24=== Configuring the trunk
25
Philipp Maier9b444fd2020-11-25 16:09:16 +010026The first trunk is considered a virtual trunk in OsmoMGW. All
Daniel Willmann27780312018-07-31 18:53:45 +020027endpoints of type "rtpbridge" are routed here. The virtual trunk is configured
28in the config-mgcp context.
29
30All other trunks are configured in the config-mgcp-trunk context, but the
Philipp Maier242e9ad2020-11-25 16:22:40 +010031commands used are identical. Right now trunks are considered only for "ds/e1"
32type endpoints.
Daniel Willmann27780312018-07-31 18:53:45 +020033
34.Example: MGCP trunk configuration
35----
36OsmoMGW(config-mgcp)# number endpoints 63 <1>
37OsmoMGW(config-mgcp)# rtp bind-ip 10.0.0.1 <2>
38OsmoMGW(config-mgcp)# rtp port-range 12000-14000 <3>
39----
40<1> Maximum number of endpoints that can be allocated at once
41<2> Use this IP when binding RTP endpoints
42<3> Use ports in this range when binding RTP endpoints
43
44There are some options to tweak how RTP forwarding behaves in OsmoMGW:
45
46.Example: MGCP trunk rtp options
47----
48OsmoMGW(config-mgcp)# rtp keep-alive 30 <1>
49OsmoMGW(config-mgcp)# rtp-patch ssrc <2>
50OsmoMGW(config-mgcp)# rtp-patch timestamp <3>
51----
52<1> Send dummy UDP packets periodically to RTP destination
53<2> Hide SSRC changes
54<3> Ensure RTP timestamp is aligned with frame duration
55
56