Skip to main content

Setting up TURN using coTurn

In this guide, we're going to explain how to create a load balancer using Turn Server (MySQL support) as DNS Round Robin.

What is Round Robin DNS?​

Round Robin DNS is a fast, simple and cost-effective way to load balance or distribute traffic evenly over multiple servers or devices.

How does Round Robin work?​

By using Round Robin DNS, when a user accesses the home page, the request will be sent to the first IP address. The second user who accesses the home page will be sent to the next IP address, and the third user will be sent to the third IP address. In a nutshell, Round Robin network load balancing rotates connection requests among web servers in the order that requests are received.

Block Diagram of the Installation​

  1. Clients try to access the turn server via a domain name such turn.antmedia.io
  2. DNS resolves the turn.antmedia.io to the backends Turn Server - 1 and Turn Server - 2 by using Round Robin algorithm.
  3. Turn Servers access to the same Database for authentication and serves the client.

System Requirements​

2 x Turn Server
1 x MySQL/MariaDB server
1 x DNS Access

DNS    : 192.168.1.199
MariaDB: 192.168.1.200
Coturn1: 192.168.1.201
Coturn2: 192.168.1.202

 This "How to" guide has been tested in a real lab environment so you have to set up the configuration according to your own setup.

1. DNS Configuration​

Assuming this is a fully-registered domain, we will add the following in the DNS settings. We add two A records for the subdomain turn.antmedia.io and point them to the turn server servers IP address.

Example DNS Record is as follows:

turn.antmedia.io    IN      A       192.168.1.201
turn.antmedia.io    IN      A       192.168.1.202

 In this way, when we request to turn.antmedia.io, it will distribute every request in the round-robin structure to the ip addresses we have stated above.

2. Database Configuration​

We always prefer to install the Database Server on a separate server and we choose MariaDB. We use long-term authentication in this structure and we authenticate to the turn server with the users that we created.

  • Update the repository and install MariaDB with the following command:

    apt-get update && apt-get install mariadb-server -y

  • Edit the following file /etc/mysql/mariadb.conf.d/50-server.cnf with your favorite editor such as vim or nano Please add the following lines then save and exit:

    bind-address            = 0.0.0.0
    innodb_file_format=Barracuda
    innodb_file_per_table=1
    innodb_large_prefix=1

  • Restart the MariaDB Server.

    systemctl restart mysqld

  • Login Mariadb shell as follows:

    mysql -uroot -p

  • Run the SQL command as follows on the MariaDB shell. Please pay attention that we set password as coturn123 and this value will be used later. You should change it with your own secure password.

    SET SESSION innodb_strict_mode=ON;
    SET GLOBAL innodb_default_row_format='dynamic';

    create database coturn;
    CREATE USER 'coturn'@'192.168.1.201' IDENTIFIED BY 'coturn123';
    CREATE USER 'coturn'@'192.168.1.202' IDENTIFIED BY 'coturn123';

    GRANT ALL PRIVILEGES ON coturn.* TO 'coturn'@'192.168.1.201';
    GRANT ALL PRIVILEGES ON coturn.* TO 'coturn'@'192.168.1.202';
    flush privileges;
    quit;

Install TURN Server​

In this section, we will install and configure CoTurn on Coturn1 and Coturn2 server.

  • Update the repository and install CoTurn with the following command

    apt-get update && apt-get install coturn -y

  • Enable the TURN server as follows

    sed -i 's/#TURNSERVER_ENABLED.*/TURNSERVER_ENABLED=1/g' /etc/default/coturn

  • Add CoTurn to startup at boot time

    systemctl enable coturn

  • Backup original conf file:

    mv /etc/turnserver.conf{,_bck}

  • Create the following file with the editor

    vim /etc/turnserver.conf

  • Add below lines then save and exit. Keep in mind that we did set the password coturn123 and we use them below. If you change the password, use your own instead of coturn123below.

    fingerprint
    lt-cred-mech
    realm=turn.antmedia.io
    mysql-userdb="host=192.168.1.200 dbname=coturn user=coturn password=coturn123 port=3306 connect_timeout=60 read_timeout=60"
    syslog

  • Make sure you're doing this step on Coturn1 and Coturn2 server separately. The syslog output of all servers is as follows:

  • Import SQL schema(/usr/share/coturn/schema.sql) to the database server. The file /usr/share/coturn/schema.sql is in one of the turn servers. Upload to the database server and schema.sqlis imported.

    scp -r /usr/share/coturn/schema.sql root@192.168.1.200:

  • Run the following command to import the SQL file:

    mysql -uroot -p coturn `< schema.sql

  • Restart the service on both nodes CoTURN instances

    systemctl restart coturn

  • To create a username and password, run the following command on the turn1 or turn2 server:

    turnadmin -a --mysql-userdb="host=192.168.1.200 dbname=coturn user=coturn password=coturn123" -u antmedia -p 123456 -r turn.antmedia.io

    Let's check if the configurations are working correctly:

    turnutils_uclient -v -t -T -u antmedia -w 123456 -p 3478 turn.antmedia.io

  • If everything is fine, your output will be as follows

Troubleshooting​

You can use the following command to check that DNS Round-Robin is working correctly:

nslookup turn.antmedia.io

If you have any questions, please just drop a line to contact (at) antmedia.io

Share feedback