Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Goal

This guide helps you setup a simple, mature and flexible open source SIP server. OpenSER can be used on systems with limitted resources as well as on carrier grade servers, scaling to up to thousands call setups per second.

Applicability

OpenSER includes all major entity of a SIP Network. It is a registrar, location server, proxy server, redirect server, gateway to SMS/XMPP, or advanced VoIP application server.

Prerequisites (OS, dependencies on other software)

  • Linux/Unix OS

Installation (OS agnostic)

Read first carefully the INSTALL file, paying especially attention to section 3C) and 3D).

...

Tip
titleMake packages

If you need a newer version. Make packages by typing 'make deb' or 'make rpm' instead of 'make install'.

Configuration (OS agnostic)

The configuration is located in /etc/openser. The default configuration is ready for a very simple setup and for some very basic tests. You can already try to register to the SIP server.

Troubleshooting with ngrep

Before you try to register to your SIP server make sure udp and tcp port 5060 are open. Use ngrep for tracing SIP messages on the SIP server. Useful commands are:

...

Warning
titleMessage too big

If you get the following error when registering: <Message too big> then probably your host forwards the SIP Message to itself. So trace on localhost to see if this is the case. If your server has more than one DNS entry, make sure that you have all hostnames in /etc/hosts and that you have the following line in your openser.cfg alias="yoursipdomain.ch:5060"

Troubleshooting with the xlog module

For debugging purposes, it may be very helpful to use the xlog module, which logs directly with syslog.

...

The full set of variables is available on http://openser.org/docs/pseudo-variables.htmlImage Removed

Control server with openserctl

With sudo openserctl moni you can monitor the state of your openser (whether it is actually running after the installation).

...