Installation Guide
MediaProxy must run natively on the host operating system and not in a virtual environment.
You can install MediaProxy in the following ways:
- From a tar file
- From a Debian repository
- From the version control repository
- From the tar file hosted at AG Projects downloads page
The software is available as a tar archive at:
http://download.ag-projects.com/MediaProxy/
- From a Debian repository
Add these lines to /etc/apt/sources.list according to your distribution:
- Debian Stable (Squeeze)
# AG Projects software deb http://ag-projects.com/debian stable main deb-src http://ag-projects.com/debian stable main
- Debian Unstable (Sid)
# AG Projects software deb http://ag-projects.com/debian unstable main deb-src http://ag-projects.com/debian unstable main
- Ubuntu Lucid (10.04)
# AG Projects software deb http://ag-projects.com/ubuntu lucid main deb-src http://ag-projects.com/ubuntu lucid main
- Ubuntu Maverick (10.10)
# AG Projects software deb http://ag-projects.com/ubuntu maverick main deb-src http://ag-projects.com/ubuntu maverick main
- Ubuntu Natty (11.04)
# AG Projects software deb http://ag-projects.com/ubuntu natty main deb-src http://ag-projects.com/ubuntu natty main
Install the AG Projects debian software signing key:
wget http://download.ag-projects.com/agp-debian-gpg.key sudo apt-key add agp-debian-gpg.key
After that, run:
sudo apt-get update sudo apt-get install mediaproxy-dispatcher mediaproxy-relay mediaproxy-web-sessions
to install all the packages, or you can install only the packages you actually need on that specific system.
- Installing from the version control repository (development branch)
The source code is managed using darcs version control tool. The darcs repository can be fetched with:
darcs get http://devel.ag-projects.com/repositories/mediaproxy
To obtain the incremental changes after the initial get:
cd mediaproxy darcs pull -a
Running the software
MediaProxy is meant to be used together with OpenSIPS' mediaproxy module.
Both OpenSIPS and MediaProxy must use a public IP address.
To run the software, you will need a server running the Linux Operating System using a kernel version 2.6.18 or higher that has been compiled with connection tracking support (conntrack). IPtables 1.4.3 or higher is also required. Because of this dependency on Linux, other operating systems are not supported. This dependency only applies to the media relay component. The dispatcher component which runs on the same host as OpenSIPS, can run on any platform that has a python interpreter and supports the twisted framework.
Communication between the dispatcher and the relays uses TLS encryption and requires a set of X509 certificates to work. For more information about this please read tls/README which contains information about the sample certificates that are included as well as information about how to generate your own.
No STUN or TURN support are required in the clients.
The SIP User Agents must work symmetrically (that is to send and receive data on the same port for each stream), which is documented in RFC 4961.
To display the history of the media streams you may use CDRTool application.
For supporting ICE negotiation between end-points see this page ICE support.
CentOS
This is a page maintained by a third-party for an older version:
http://kb.smartvox.co.uk/index.php/opensips/installing-mediaproxy-2-centos-5-64bit/
