| Daniel Willmann | 2778031 | 2018-07-31 18:53:45 +0200 | [diff] [blame] | 1 | == Running OsmoMGW |
| 2 | |
| 3 | The OsmoMGW executable (`osmo-mgw`) offers the following command-line |
| 4 | arguments: |
| 5 | |
| 6 | === SYNOPSIS |
| 7 | |
| 8 | *osmo-mgw* [-h|-V] [-D] [-c 'CONFIGFILE'] [-s] |
| 9 | |
| 10 | === OPTIONS |
| 11 | |
| 12 | *-h, --help*:: |
| 13 | Print a short help message about the supported options |
| 14 | *-V, --version*:: |
| Harald Welte | a8f27ab | 2019-12-01 14:25:10 +0100 | [diff] [blame] | 15 | Print the compile-time version number of the program |
| Daniel Willmann | 2778031 | 2018-07-31 18:53:45 +0200 | [diff] [blame] | 16 | *-D, --daemonize*:: |
| 17 | Fork the process as a daemon into background. |
| 18 | *-c, --config-file 'CONFIGFILE'*:: |
| 19 | Specify the file and path name of the configuration file to be |
| 20 | used. If none is specified, use `osmo-mgw.cfg` in the current |
| 21 | working directory. |
| 22 | *-s, --disable-color*:: |
| 23 | Disable colors for logging to stderr. This has mostly been |
| 24 | deprecated by VTY based logging configuration, see <<logging>> |
| 25 | for more information. |
| Neels Hofmeyr | cd13212 | 2023-11-30 18:20:51 +0100 | [diff] [blame^] | 26 | |
| 27 | |
| 28 | === Configure limits |
| 29 | |
| 30 | When servicing hundreds of media endpoints, it may be necessary to adjust the |
| 31 | operating system's limit on open file descriptors for the osmo-mgw process. A |
| 32 | typical default limit imposed by operating systems is 1024; this would be |
| 33 | exceeded by, for example, about 256 active voice calls with 4 RTP/RTPC ports |
| 34 | each, sockets for other interfaces not considered yet. |
| 35 | |
| 36 | It should be ok to set an OS limit on open file descriptors as high as 65536 |
| 37 | for osmo-mgw, which practically rules out failure from running out of file |
| 38 | descriptors anywhere (<16,000 active calls). |
| 39 | |
| 40 | When using systemd, the file descriptor limit may be adjusted in the service |
| 41 | file by the `LimitNOFILE` setting ("Number of Open FILE descriptors"). OsmoMGW |
| 42 | ships a systemd service file with a high LimitNOFILE setting. |