For an initial installation of the sip:provider CE, it is mandatory that your production environment meets the following criteria:

	Only Debian Squeeze (6.0) 64-bit is currently supported as a host system for the sip:provider CE.

	It is HIGHLY recommended that you use a dedicated server (either a physical or a virtual one) for sip:provider CE, because the installation process will wipe out existing MySQL databases and modify several system configurations.

For quick test deployments, pre-installed virtualization images are provided. These images are intended to be used for quick test, not recommended for production use.

tar xvf sip_provider_CE_2.6_virtualbox.ova

If you have only one network card inside your system, its device name is eth0, it’s configured and only IPV4 is important to you then there should be nothing to do for you at this stage. If multiple network cards are present, your network card does not use eth0 for its device name or you need IPv6 then the only parameter you need to change at this moment is the listening address for your SIP services.

To do this, modify the parameter networking→eaddress in /etc/ngcp-config/config.yml, which by default is set to 127.0.0.1:

vim /etc/ngcp-config/config.yml

Look for the following section on top of the file:

networking:
  eaddress: 127.0.0.1

[...]

Change this parameter to the IP address configured during install time of the Debian operating system.

If you want to enable IPv6 as well, change the section networking→e6address accordingly, for example like this:

  e6address:
    enable: yes
    address: fdda:5cc1:23:4:0:0:0:1f

	Always use a full IPv6 address with 8 octets, leaving out zero octets (e.g. fdda:5cc1:23:4::1f) is not allowed.

If you haven’t fully configured your network interfaces, do this by adapting also the file /etc/network/interfaces:

vim /etc/network/interfaces

Add or adapt your interface configuration accordingly. For example, if you just want to use the system in your internal network 192.168.0.0/24, it could look something like this:

auto lo
iface lo inet loopback

auto eth0
iface eth0 inet static
        address 1.2.3.4
        netmask 255.255.255.0
        gateway 1.2.3.1
        dns-nameservers 8.8.8.8
        dns-search yourdomain.com

/etc/init.d/networking restart

If your server is running behind near-end static NAT or in cloud environment such as Amazon EC2 you need to configure the mapped public IP address as advertised address for sip:provider CE.

To set the advertised address change the section networking→aaddress accordingly, for example like this:

  aaddress:
    enable: yes
    address: 7.7.7.7

	It is HIGHLY recommended that you use a public IP for the system. If you can not get a real or mapped 1:1 public IP, all your subscribers and gateways must be in the same private network. The sip:provider CE handles gateways and subscribers behind dynamic NAT, but the sip:provider CE itself cannot be behind dynamic NAT.

In order to apply the changes you made to /etc/ngcp-config/config.yml, you need to execute the following command to re-generate your configuration files and to automatically restart the services:

ngcpcfg apply

	At this point, your system is ready to serve.

During installation, the system user cdrexport is created. This jailed system account is supposed to be used to export CDR files via sftp/scp. Set a password for this user by executing the following command:

passwd cdrexport

The installer has set up a MySQL database on your server. You need to set a password for the MySQL root user to protect it from unauthorized access by executing this command:

mysqladmin password <your mysql root password>

For the Administrative Web Panel located at https://<your-server-ip>:1443/, a default user administrator with password administrator has been created. Connect to the panel (accept the SSL certificate for now) using those credentials and change the password of this user by going to System Administration→Administrators and clicking edit.

The NGCP installer will install mailx (which has Exim4 as MTA as a default dependency) on the system, however the MTA is not configured by the installer. If you want to use the Voicemail-to-Email feature of the Voicebox, you need to configure your MTA properly. If you are fine to use the default MTA Exim4, execute the following command:

dpkg-reconfigure exim4-config

Depending on your mail setup in your environment (whether to use a smarthost or not), configure Exim accordingly. In the most simple setup, apply the following options when prompted for it:

	You are free to install and configure any other MTA (e.g. postfix) on the system, if you are more comfortable with that.

To test and use your installation, you need to follow these steps now:

Please read the next chapter for instructions on how to do this.