how to install jibri recording server within a hour in ubuntu 16.04 (Xenial)

To configuring the jibri recording server from below easy steps 

Note: Please put the more focus on highlighted line and words  :

       Pre-requisite for jibri recording server  :

        OS-VM:  Ubuntu 16.04 VMs on your cloud server (Azure,GC,AWS,Vultr, digitalOcean).

        CPU: 2.0

        RAM: 4 GB

        SSD or HDD :20 GB

Update the Ubuntu package  

1. sudo -s
2. apt update

Allow to require ports 

• ufw status
• => “Active or inactive does not matter”
• ufw allow ssh
• ufw allow 80/tcp
• ufw allow 443/tcp
• ufw allow 10000:60000/tcp
• ufw allow 10000:60000/udp
• ufw allow 5222
• ufw allow 5347
• netstat -tunlp // list out the all open ports 

Installing kernel modules

1. apt -y install linux-image-extra-virtual
2. uname -a 

Note : After uname -a command  there are two possibilities A and B . 

            A.  if you get below output, it mean kernal module has configured as generic .

Linux <username> 4.4.0-157-generic#  185-Ubuntu SMP Tue Jul 23 09:17:01 UTC 2019 x86_64 x86_64 x86_64 GNU/Linux

           B. if you get below output it means  Kernal has not configured as  generic  , so  need check modprobe  command 

Linux <username> 4.4.0-157-Azure or Linux <username> 4.4.0-157-AWS  

modprobe  command

• modprobe snd-aloop 

Note : After above command if you get below errors, it means version is miss match then need follow  Kernal version configuration  steps . 

modprobe: FATAL: Module snd-aloop not found in directory /lib/modules/4.4.0-1052-aws or azure 

Kernal version configuration 

1. open the  grub file from  below command
2.   vim /etc/default/grub     // open the grub file and edit the below line save it . 

    edit the line number 6  (change from GRUB_DEFAULT=0 to GRUB_DEFAULT="1>2")

1. update-grub    // this is a upgrade command which update the grub file 
2. reboot            // reboot command is a mandatory because often does not update the system file without reboot .  

After reboot the jibri VMs need to check that VM has been change as generic kernal  or not 

1. uname -a                           // it will show as generic ( Linux rtc-v1-jibri 4.4.0-157-generic) instead of azure or aws 
2. modprobe snd-aloop        //(now,  there is no error )
3. lsmod | grep snd_aloop      // Search that snd_aloop if it is configured then it shows some output as bellow is depicted 

snd_aloop              24576  0

snd_pcm               106496  1 snd_aloop

snd                    86016  3 snd_aloop,snd_timer,snd_pcm

    4. echo "snd-aloop" >> /etc/modules    //  move snd_aloop  into  /etc/modules  

Note : Now kernel module has been configured so now install the jibri from steps  

   

Install the required  dependencies from below commands 

1. curl -sS -o - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add
2. echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list
3. apt-get -y update
4. apt-get -y install google-chrome-stable

Install the  Chromedriver  from below commands 

1. CHROME_DRIVER_VERSION=`curl -sS chromedriver.storage.googleapis.com/LATEST_RELEASE`
2. wget -N http://chromedriver.storage.googleapis.com/$CHROME_DRIVER_VERSION/chromedriver_linux64.zip -P ~/
3. unzip ~/chromedriver_linux64.zip -d ~/
4. rm ~/chromedriver_linux64.zip
5. sudo mv -f ~/chromedriver /usr/local/bin/chromedriver
6. sudo chown root:root /usr/local/bin/chromedriver
7. sudo chmod 0755 /usr/local/bin/chromedriver

    

Install the  required dependencies  from below command 

1. install default-jre-headless ffmpeg curl alsa-utils icewm xdotool xserver-xorg-input-void xserver-xorg-video-dummy

Install Jibri debain Repo from below commands 

1. wget -qO - https://download.jitsi.org/jitsi-key.gpg.key | sudo apt-key add - 
2. sudo sh -c "echo 'deb https://download.jitsi.org stable/' > /etc/apt/sources.list.d/jitsi-stable.list"
3. sudo apt-get update 
4. sudo apt-get install jibri    

Jibri config file 

1. mkdir /srv/recordings.                    // create a recordings directory where you want to save all recorded files  (i usually keep  /home/raj/recordings)
2. chown jibri:jitsi /srv/recordings.    // change the owner and group of directory  
3. sudo vi /etc/jitsi/jibri/config.json   // open config file  and change the below line 

Note : Please make changes very carefully otherwise it will throw  errors . 

// Where recording files should be temporarily stored

    "recording_directory":"/srv/recordings",

….

// The hosts of the XMPP servers to connect to as part of

            //  this environment

            "xmpp_server_hosts": [

                “jitsi-conf.abc.com"

            ],

            // The xmpp domain we'll connect to on the XMPP server

            "xmpp_domain": "jitsi-conf.abc.com",

// Jibri will login to the xmpp server as a privileged user 

            "control_login": {

                // The domain to use for logging in

                "domain": "auth.jitsi-conf.abc.com",

                // The credentials for logging in

                "username": "jibri",

                "password": "jibriauthpass"

            },

            // Using the control_login information above, Jibri will join 

            //  a control muc as a means of announcing its availability

//  to provide services for a given environment

            "control_muc": {

                "domain": "internal.auth.jitsi-conf.abc.com",

                "room_name": "JibriBrewery",

                "nickname": "jibri-raj"

            },

            // All participants in a call join a muc so they can exchange

            //  information.  Jibri can be instructed to join a special muc

            //  with credentials to give it special abilities (e.g. not being

            //  displayed to other users like a normal participant)

            "call_login": {

                "domain": "recorder.jitsi-conf.abc.com",

                "username": "recorder",

                "password": "jibrirecorderpass"

            },

Once done the all above configurations need to restart jibri server 

1. systemctl restart jibri   
2. systemctl status jibri 

Go to on main server configuration  : (Where jitsi-meet , jicofo and JVB component are running )

    Prosody server configurations 

1. vi  /etc/prosody/conf.d/jitsi-conf.abc.com.cfg.lua  //  open prosody config file 

--Jibri configurations ------- 

Component "internal.auth.jitsi-conf.abc.com" "muc"

    modules_enabled = {

      "ping";

    }

    storage = "null"

    muc_room_cache_size = 1000

VirtualHost "recorder.jitsi-conf.abc.com"

  modules_enabled = {

    "ping";

  }

  authentication = "internal_plain"

Setup the two accounts jibri fro below commands .

     1.   prosodyctl register jibri auth.jitsi-conf.abc.com jibriauthpass

     2.  prosodyctl register recorder recorder.jitsi-conf.abc.com jibrirecorderpass

Jicofo server configurations  

1. vi /etc/jitsi/jicofo/sip-communicator.properties. // open file and add below line 

  org.jitsi.jicofo.jibri.BREWERY=JibriBrewery@internal.auth.jitsi-conf.abc.com

org.jitsi.jicofo.jibri.PENDING_TIMEOUT=90

Jitsi-meet server configurations 

1. vi /etc/jitsi/meet/jitsi-conf.abc.com-config.js.  // Need to edit below line 

fileRecordingsEnabled: true, // If you want to enable file recording

liveStreamingEnabled: true, // If you want to enable live streaming

 hiddenDomain: 'recorder.jitsi-conf.abc.com',

Check require  buttons enable or not in "TOOLBAR"

1. sudo vi /usr/share/jitsi-meet/interface_config.js   // Need to check toolbar button enable or not  ('recording' , 'livestreaming',)

TOOLBAR_BUTTONS: [

        'microphone', 'camera', 'closedcaptions', 'desktop', 'fullscreen',

        'fodeviceselection', 'hangup', 'profile', 'info', 'chat', 'recording',

        'livestreaming', 'etherpad', 'sharedvideo', 'settings', 'raisehand',

        'videoquality', 'filmstrip', 'invite', 'feedback', 'stats', 'shortcuts',

        'tileview'

    ],

Open Jibri server VM 

13 . Use username 'jibri' and group name 'jibri', should be allow

1. sudo usermod -aG adm,audio,video,plugdev jibri  //There are two possible errors A and B  If you get below message after  run the above command 

A.  If there is no any output after the above command then it seems good .

B. If there are some output seems like the below then need to remove unscd  package

  

 sent invalidate(passwd) request, exiting

  sent invalidate(group) request, exiting

1. sudo apt remove unscd   //  remove unscd  package (if there are errors ,  please follow  How to remove unscd in below of this page)

Note : after removing  the package need to check  snd_aloop is avaible or not by below command .

1. smod | grep snd_aloop  //if there are any output then neetd follow  Ffmeg  test command  steps

Ffmeg  test command 

  1. sudo arecord -L      // After this command there are two possible output A and B   

A. If you get long listing from above command it means .it means working fine & need to restart jibri  

B. If you get null   Discard all samples (playback) or generate zero samples (capture)

1. if discard errors come then need to do below steps 
2. systemctl stop jibri
3. echo "snd-aloop" >> /etc/modules
4. modprobe snd-aloop

How to remove unscd  (You can get more info from this reference like )

Uninstall unscd

To remove just unscd package itself from Ubuntu 16.04 (Xenial Xerus) execute on terminal:

1. sudo apt-get remove unscd

Uninstall unscd and it's dependent packages

To remove the unscd package and any other dependant package which are no longer needed from Ubuntu Xenial.

1. sudo apt-get remove --auto-remove unscd

Purging unscd

If you also want to delete configuration and/or data files of unscd from Ubuntu Xenial then this will work:

1. sudo apt-get purge unscd

To delete configuration and/or data files of unscd and it's dependencies from Ubuntu Xenial then execute:

1. sudo apt-get purge --auto-remove unscd

Note: Before start the conference call and recording need restart all server from below commands 

• restart again (systemctl restart nginx.service )
• systemctl restart jitsi-videobridge2.service
• systemctl restart jicofo.service
• systemctl restart prosody.service
• systemctl restart jibri.service