Jitsi Videobridge Example

Posted on  by admin

This document presents the configuration steps to install Jitsi meetings over the Openfire XMPP server. But it doesn't cover the Openfire installation.

Each bundle should have a file called yourbundlename.manifest.mf, where you should specify the full activator name, some description of your bundle and list all libraries imported in your bundle classes. The manifest file is needed by the OSGi framework for manipulating the bundle. It is packaged into a JAR file along with the Java class files associated with the bundle; the whole JAR package. Jitsi over Openfire. This document presents the configuration steps to install Jitsi meetings over the Openfire XMPP server. But it doesn't cover the Openfire installation.

Materials

  • ClearOS 7
  • Apache 2.4
  • Java 1.8

Despite being ClearOS 7, it is very close to CentOS and also helpful for distros other than Debian/Ubuntu

Setting up Jitsi

  1. Setup facts
  1. Get the source
  1. Decompress on ${MEET_HTDOCS}
  1. Create proper config folder
  1. Move config files to that folder
  1. Link back config files
  1. Create htaccess
  1. Edit ${MEET_CONFIG}/config.js and provide values for
  • config.hosts.domain
  • config.hosts.muc
  • config.hosts.bosh (OR config.hosts.websocket)
Windows
  1. Save links state to restore after eventual upgrade
  1. Restore symlinks after eventual upgrade

Setting up Jicofo

Why Jicofo? From the docs you read Conference focus is mandatory component of Jitsi Meet conferencing system next to the videobridge.

There is no ClearOS packages for Jicofo. It is needed to build the package, so it is also needed to have JDK 1.8 and maven >3.

In this setup, Jicofo runs in the same machine where Openfire runs, so I set XMPP_SERVER=127.0.0.1 and org.jitsi.jicofo.ALWAYS_TRUST_MODE_ENABLED=true.

  1. Set facts
  1. Get the sources
  1. Build using maven
  1. Set the XMPP_COMPONENT_SECRET on Openfire

  2. Go to Openfire admin panel

  3. Navigate to Server > Server Setting > External Components

  4. Focus on field Default Shared Secret, in the box Allowed to Connect

  5. Paste there the value of XMPP_COMPONENT_SECRET;

  6. Still on Openfire panel, in the same section above, copy value of port, in the Plain-text (with STARTTLS) connections and create a new fact, like below

  1. Create a config file
Jitsi video
  1. Properties
  1. Create systemd using to manage this servidce (note the single quote around EOF)
  1. Enable and start Jicofo

Setting up jitsi-videobridge

  1. Set facts
  1. Getting the binary
  1. Unzip it to /opt
  1. Rename the folder
  1. Properties

Jitsi Videobridge Sample

Jitsi Videobridge Example
  1. Systemd service
  1. Enable and start Jicofo

Introduction

To complement our Jitsi installation, we add a grafana dashboard to it so we can control usage, system load, traffic spikes etc.

For the sake of simplicity, we run our grafana, telegraf and influxdb instances in the same jail as jitsi-meet, so this post builds on top of the post explaining how to set upjitsi-meet.

Initial Set Up

Jitsi Videobridge Tutorial

Jitsi Videobridge Example

We connect to the jail and install the packages:

Starting Services

To make sure everything is started automatically, add the services to /etc/rc.conf:

Then start all services manually for the first time:

Setting up influxdb

Start the influxdb console:

There create the user and database:

Setting up jitsi-videobridge

If you have not yet done this, configure jitsi-videobridge to collect data. Also make sure that it is started correctly with jisti_videobridge_flags='--apis=rest,xmpp' in /etc/rc.conf so the necessary APIs are provided.

Setting up telegraf

Add the data source created above to /usr/local/etc/telegraf.conf:

Setting up grafana

Initial Connect and Data Source Creation

Connect to your grafana instance the first time (it is listening at http://10.10.0.1:3000/ if your jail has 10.10.0.1 as IP address) with user admin and empty password and set the initial password.

Jitsi Video Bridge Examples

After that, click on the configuration “gear” icon and choose “Data Sources”. Click “Add Data Source” and select “Influx DB”. Use the following settings (and of course enter the password you have used when creating the database as described above):

Import of Jitsi Dashboard

Then click on “+” in the left menu and choose “Import” from the menu.

Jitsi Videobridge Windows

You will find the dashboard to import at https://grafana.com/grafana/dashboards/11969/reviews. There you will see that the preconfigured dashboard has the number 11969, so you can simply enter this number in the ID field and click on “Import”, after that select the newly created InfluxDB as data source from the drop down and create the dashboard.

Jitsi Videobridge Webrtc Example

That’s it!