Kamailio is a free and open-source SIP server written in C. It can handle over 5000 call setups per second and serve up to 300,000 active subscribers with just 4GB RAM. You can use Kamailio as a registrar server, location server, proxy server, SIP application server, and redirect server. It supports both IPv4 and IPv6 IP addresses and can be installed on all major Linux-based operating systems.
In this post, we will show you how to install a Kamailio SIP server on Oracle Linux 8.
Step 1 – Install and Configure MariaDB Server
Kamailio uses MariaDB as a database backend, so you will need to install a MariaDB server on your system. You can install it by running the following command:
dnf update -y dnf install mariadb-server -y
Once the MariaDB server is installed, start and enable the MariaDB service using the following command:
systemctl start mariadb systemctl enable mariadb
Next, you will need to secure the MariaDB installation and set the MariaDB root password:
mysql_secure_installation
Answer all questions as shown below:
Enter current password for root (enter for none): OK, successfully used password, moving on... Setting the root password ensures that nobody can log into the MariaDB root user without the proper authorisation. Set root password? [Y/n] Y New password: Re-enter new password: Remove anonymous users? [Y/n] Y Disallow root login remotely? [Y/n] Y Remove test database and access to it? [Y/n] Y Reload privilege tables now? [Y/n] Y
Step 2 – Add Kamailio Repo
By default, the Kamailio package is not included in the Oracle Linux 8 default repo, so you will need to add it to your system. You can add it with the following command:
yum install dnf-plugins-core -y yum config-manager --add-repo https://rpm.kamailio.org/centos/kamailio.repo
Once the Kamailio repo is added, you can verify it using the following command:
dnf repolist
You should get the following output:
repo id repo name kamailio Kamailio - latest - Packages for the Kamailio latest release ol8_UEKR6 Latest Unbreakable Enterprise Kernel Release 6 for Oracle Linux 8 (x86_64) ol8_appstream Oracle Linux 8 Application Stream (x86_64) ol8_baseos_latest Oracle Linux 8 BaseOS Latest (x86_64)
Step 3 – Install Kamailio Server
Now, run the following command to install the Kamailio server with other required packages:
dnf install vim kamailio kamailio-mysql kamailio-presence kamailio-ldap kamailio-debuginfo kamailio-xmpp kamailio-unixodbc kamailio-utils kamailio-gzcompress kamailio-tls kamailio-outbound -y
After successful installation, you can verify the Kamailio version with the following command:
kamailio -version
You should get the following output:
version: kamailio 5.6.1 (x86_64/linux) b36a13 flags: USE_TCP, USE_TLS, USE_SCTP, TLS_HOOKS, USE_RAW_SOCKS, DISABLE_NAGLE, USE_MCAST, DNS_IP_HACK, SHM_MMAP, PKG_MALLOC, Q_MALLOC, F_MALLOC, TLSF_MALLOC, DBG_SR_MEMORY, USE_FUTEX, FAST_LOCK-ADAPTIVE_WAIT, USE_DNS_CACHE, USE_DNS_FAILOVER, USE_NAPTR, USE_DST_BLOCKLIST, HAVE_RESOLV_RES, TLS_PTHREAD_MUTEX_SHARED ADAPTIVE_WAIT_LOOPS 1024, MAX_RECV_BUFFER_SIZE 262144, MAX_URI_SIZE 1024, BUF_SIZE 65535, DEFAULT PKG_SIZE 8MB poll method support: poll, epoll_lt, epoll_et, sigio_rt, select. id: b36a13 compiled on 12:16:45 Aug 16 2022 with gcc 8.5.0
Step 4 – Configure Kamailio Server
The Kamailio default configuration file is located at /etc/kamailio/kamctlrc. You will need to edit it and define your database and host.
nano /etc/kamailio/kamctlrc
Change the following lines:
DBENGINE=MYSQL DBHOST=localhost
Save and close the file, then generate a database and tables for Kamailio using the following command:
kamdbctl create
Provide your MariaDB root password to create the database and tables as shown below:
MySQL password for root: INFO: test server charset INFO: creating database kamailio ... INFO: granting privileges to database kamailio ... INFO: creating standard tables into kamailio ... INFO: Core Kamailio tables successfully created. Create the presence related tables? (y/n): y INFO: creating presence tables into kamailio ... INFO: Presence tables successfully created. Create the tables for imc cpl siptrace domainpolicy carrierroute drouting userblocklist htable purple uac pipelimit mtree sca mohqueue rtpproxy rtpengine secfilter? (y/n): y INFO: creating extra tables into kamailio ... INFO: Extra tables successfully created. Create the tables for uid_auth_db uid_avp_db uid_domain uid_gflags uid_uri_db? (y/n): y INFO: creating uid tables into kamailio ... INFO: UID tables successfully created.
Next, open the /etc/kamailio/kamailio.cfg file and enable some features:
nano /etc/kamailio/kamailio.cfg
Add the following lines below #!KAMAILIO.
#!define WITH_MYSQL #!define WITH_AUTH #!define WITH_USRLOCDB #!define WITH_NAT #!define WITH_PRESENCE #!define WITH_ACCDB
Save and close the file, then restart the Kamailio service to apply the changes:
systemctl restart kamailio
You can now check the status of Kamailio with the following command:
systemctl status kamailio
You will get the following output:
● kamailio.service - Kamailio - the Open Source SIP Server
Loaded: loaded (/usr/lib/systemd/system/kamailio.service; enabled; vendor preset: disabled)
Active: active (running) since Tue 2022-08-23 02:01:31 EDT; 4s ago
Main PID: 6251 (kamailio)
Tasks: 33 (limit: 11409)
Memory: 30.0M
CGroup: /system.slice/kamailio.service
├─6251 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6252 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6253 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6254 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6255 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6256 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6257 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6258 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6259 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6260 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6261 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6262 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6263 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6264 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6265 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6266 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6267 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6268 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6269 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6270 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6271 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6272 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6273 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6274 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6275 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
├─6276 /usr/sbin/kamailio --atexit=no -DD -P /run/kamailio/kamailio.pid -f /etc/kamailio/kamailio.cfg -m 64 -M 8
Step 5 – Install Siremis Web UI
Siremis provides a web-based interface to manage the Kamailio SIP server. First, install the Apache and PHP package with the following command:
dnf install httpd php php-fpm php-mysqlnd php-gd php-curl php-xml php-pear git make gcc -y
Next, start and enable the Apache and PHP-FPM services:
systemctl start httpd php-fpm systemctl enable httpd php-fpm
Next, install the XML_RPC2 package for XMLRPC command panel with the following command:
pear install XML_RPC2
Next, navigate to the Apache web root directory and download the latest version of Siremis:
cd /var/www git clone https://github.com/asipto/siremis
Next, change the directory to the downloaded directory and generate Siremis configuration files:
cd siremis make apache24-conf | tee /etc/httpd/conf.d/siremis.conf make prepare24
Next, change the permissions and ownership of the Siremis directory:
chown -R apache:apache /var/www/siremis/ chmod -R 777 /var/www/siremis/
Next, restart the Apache service to apply the changes:
systemctl restart httpd
Step 7 – Access Siremis Web UI
Now, open your web browser and access the Siremis web interface using the URL http://your-server-ip/siremis/install/. You should see the following page:
Now, click on the Setup Now! button. You should see the following page:
Make sure all the necessary components are installed. Then, click Next. You should see the following page:
Leave all default settings and check all options, then click on the Next button. You should see the following page:
Click Next to start the installation. Once the installation has been completed successfully, you should see the following page:
Click on the Launch Siremis button. You will be redirected to the Siremis login page as shown below:
Now, provide Siremis admin username / password as admin / admin. Then, click on the Login button. You should see the Siremis default dashboard in the following page:
Conclusion
In this post, we explained how to install the Kamailio SIP server on Oracle Linux 8. We also explained how to install the Siremis web interface to manage the Kamailio SIP server. You can now start managing your SIP server via a web browser. Get started with Kamailio on VPS Hosting from Atlantic.Net!
