Documente Academic
Documente Profesional
Documente Cultură
Release 2.0.2
FRAFOS GmbH
Contents
1
2
2
2
2
.
.
.
.
3
3
3
3
4
5
5
5
6
8
8
8
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
10
10
11
12
13
15
17
17
18
18
18
19
System interfaces
20
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
10 SBC interfaces
10.1 Virtual IP address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.2 Signaling and Media interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21
21
21
23
25
25
26
26
27
ii
This document describes hardware and software requirements, installation procedure for single node and highavailability (two nodes in pair) deployment. It also deals with users administrations, licensing key management,
system (network) and SBC interfaces desctiption and configuration.
Contents
Chapter 1
1.2 Software
FRAFOS ABC SBC is installed on CentOS operating system (version 6.4 - x86_64 architecture).
Chapter 2
2.2 VM Interfaces
There are two physical interfaces configured:
eth0 - 192.168.1.110/24 (default gw 192.168.1.1)
eth1 - 10.0.1.110/24
User should modify the IP addresses to follow his network topology. In CentOS, system interfaces can be configured (use any text editor) in networking scripts:
% /etc/sysconfig/network-scripts/ifcfg-ethX
When all the interfaces are configured, restart the network sevice (or reboot) the machine:
% service network restart
Note: If user is connected using ssh to the machine, it may happen user is disconnected...
2.3 VM initialization
As the interfaces configuration has changed, user has to perform initial configuration of the ABC SBC services
(like configure GUI access and management interfaces)
Follow chapter FRAFOS ABC SBC initial configuration to update the GUI access configuration.
Follow chapter Initial services configuration to update the HA and management configuration.
Follow chapter User accounts and login to access GUI and modify users access (security).
From GUI, user can modify the SBC interfaces configuration to use the real system IP addresses etc. Using edit
link, update all the Signaling and Media interfaces in order to use the real systems IP addresses.
Important: After changing all needed interfaces, it is necessary to activate network configuration using activate
link shown in GUI warning message.
Now your ABC SBC should have correctly configured (updated) all interfaces.
This is configuration when FRAFOS ABC SBC serves as an border controller to connect public users with private
PBX or proxy.
Public users are defined with IP netmask 0.0.0.0/0 which means users from every IP address. Users has to
register through ABC SBC to proxy/PBX server. The SBC does performs registration cache action, where it
translates contacts in REGISTER requests to an alias and with this alias SBC is registering to the proxy/PBX.
In the oposite direction, when request is coming from proxy/PBX, SBC performs re-targeting and translates
alias (that is in R-URI) to original users contact.
There are several other actions which are described in the Configuration guide.
For more information or any questions regarding configuration, please contact FRAFOS support.
Chapter 3
frafos_abcsbc_repo.sh
Run frafos_abcsbc_repo.sh script with parameter of company name (used when generating request)
% ./frafos_abcsbc_repo.sh company
This command creates /etc/frafos/certs directory and copies company_cert.pem and frafos_ca_cert.pem
there.
Important: Administrator has to copy the company_key.pem file to this directory!
It also creates FRAFOS ABC SBC repository configuration file Frafos.repo in /etc/yum.repos.d/ directory.
Make sure that yum DB is successfully updated with FRAFOS repository content:
yum makecache
Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: centos...
* extras: ftp...
* updates: ftp...
...
frafos-2.0-official
frafos-2.0-official/filelists_db
frafos-2.0-official/other_db
...
updates/other_db
Metadata Cache Created
| 2.9 kB
| 1.5 MB
| 182 kB
00:00
00:01
00:00
| 387 kB
00:02
Important: If the package database is not successfully updated (e.g. could not get frafos-2.0-official info),
contact FRAFOS support .
Chapter 4
Important: Please check Hardware specific configuration installation guide section before continuing the installation. The recommended Mysql server setting have to be applied before installing the Sbc application.
FRAFOS ABC SBC is installed from repository using:
% yum install frafos-sbc
The installation process is non-interactive and all required packages are installed from standard CentOS or
FRAFOS repositories.
For installation output details, administrator can check installation log file:
% less /var/log/yum.log
Important: In case of any error or problem during installation, contact FRAFOS support .
Chapter 5
Error: If the IP address is not configured on the system, error dialog screen is shown. Enter a valid configured
IP address.
If the XMI configration is successful, administrator can access FRAFOS ABC SBC GUI interface using Web
browser at configured IP address.
Chapter 6
Important:
1. If FRAFOS ABC SBC is deployed as cluster, both nodes has to be running and has to be accessible.
2. If any of the configuration step fails, contact FRAFOS support . In many cases, the problem is caused
because the remote node is not accessible from the local host.
10
Important: There is no difference in following steps regarding single mode or HA pair mode on the first (only
first) node setup. Every configuration step that has to be performed differently on the second node is noted in
Second node subsection.
11
12
13
14
15
16
Note: Be sure you have correctly configured iptables (firewall). CentOS iptables initial setting is very restrictive.
17
Chapter 7
18
Chapter 8
19
Chapter 9
System interfaces
System (network) interfaces can be configured either by manual editing network configuration files in CentOS or
using System -> Networking screen.
To create/modify interface use Network interfaces page. Several types, like simple system network interface
(e.g. eth1), VLAN tagged interface (e.g. eth1.100) or bonded interface (e.g. bond0) can be configured and use in
SBC configuration.
20
Chapter 10
SBC interfaces
As mentioned in SBC interfaces overview section, SBC uses four interfaces. So far (using GUI and HA initialization scripts), XMI and IMI interfaces are configured.
For two nodes cluster deployment, Virtual IP addresses for signaling and media interfaces should be used.
Important: In two nodes cluster deployment, administrator has to configure interfaces on both nodes. Be carefull
to use the same interface name (identificators) for same signaling interfaces on both nodes! This is important for
successful call restoration on the standby node - to use the same inbound/outbound SI and MI interfaces.
22
Chapter 11
Important: If not all services (resources) are correctly running, contact FRAFOS support .
23
24
Chapter 12
25
System administrator should add the previous options to Mysql server configuration file [mysqld] section:
% /etc/my.cnf
The options can be tuned depending on server memory available.
Important: These Mysql server setting have to be applied before Sbc is installed, because they affect the way
Sbc database is created during installation.
After modifying the values main Sbc sems process configuration file has to be re-created and application
restarted:
% sbc-create-config sems
% pcs resource disable sems; sleep 5; pcs resource enable sems
26
Chapter 13
FRAFOS support
email: support@frafos.com
phone: +493057706930
Vladimir Broz
Manager Support and Services
email: vladimir.broz@frafos.com
27