OpenSIPS VM

OpenSIPS Virtual Machine

OpenSIPS VM

Table of Contents
1. OpenSIPS VM Description..........................................................................................................3
2. Prerequisites.................................................................................................................................3
3. How to access VM.......................................................................................................................3
4. System Config via OpenSIPS CP................................................................................................3
4.1 Access OpenSIPS CP............................................................................................................3
4.2 Configure Domains...............................................................................................................3
4.3 Configure Dialplan................................................................................................................3
4.4 Configure Dynamic Routing.................................................................................................4
4.5 Configure RTP Proxies..........................................................................................................4
5. Authentication & Users Management via OpenSIPS CP............................................................4
5.1 Adding Users.........................................................................................................................4
5.2 Adding Trunks.......................................................................................................................4
5.3 Alias Management.................................................................................................................4

OpenSIPS VM

1. OpenSIPS VM Description

OpenSIPS VM is a basic OpenSIPS-based SIP residential platform that, among

other features it offers IP and Digest Authentication support, NAT traversal with
media pinning support, presence & IM support, accounting to the local MySQL DB,
SIP Trace, multiple domain support, DID support, PSTN inbound and outbound
connectivity with LCR, both user and system provisioning web interface and easy
integration with an external Voicemail Service

2. Prerequisites

OpenSIPS - VM archive downloaded (tgz format) and unpacked

VM Ware player to run the virtual machine.
import your OpenSIPS VM into the VMware player

3. How to access VM

you need to place the OpenSIPS VM into a network where a DHCP server is
available
by default at startup, OpenSIPS VM will try to get an IP via DHCP
you can connect to the OpenSIPS VM using SSH
VM credentials:
username: root
password: opensips

4. System Config via OpenSIPS CP

4.1 Access OpenSIPS CP

to access OpenSIPS CP web interface use your browser and type

http://vm_ip_address/cp
OpenSIPS Control Panel (CP) credentials:
username: admin
password: admin

4.2 Configure Domains

use System Domains tool to manage the SIP domains settings

if you want to change your sip domain or add more domains feel free to do it
default is test.com for testing purposes

4.3 Configure Dialplan

use System Dialplan tool to manage the dialplan settings

you can add as many rules as needed, but remember that the dialplan id must be 0

OpenSIPS VM

4.4 Configure Dynamic Routing

use System Dynamic Routing tool to change the way your calls are routed
if you want to send your calls to PSTN you have to add some gateways and/or
carriers

4.5 Configure RTP Proxies

use System RTP Proxy tool to provision the RTP Proxies that the platform will
use
the VM ships with a local instance of RTPProxy which is already provisioned
if you want to replace it or to add new media relays, feel free to do so

5. Authentication & Users Management via OpenSIPS CP

5.1 Adding Users

use Users Users Management to add or remove users

to add a user click Add New and fill in the fields

5.2 Adding Trunks

use System IP Auth to add the IP addresses that will be trusted.

You can either add a single IP address, or an entire range of IPs if needed (by using
the mask field)

5.3 Alias Management

use Users Alias Management to add or remove aliases (DIDs) for each user
a user can have as many aliases as he wishes