BigBlueButton: Difference between revisions

From CSCWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 11: Line 11:
* Firewall exceptions for TCP ports 80 and 443 and UDP ports 16384 - 32768.
* Firewall exceptions for TCP ports 80 and 443 and UDP ports 16384 - 32768.
* Ansible installed. This can be done via <code>apt install ansible</code>.
* Ansible installed. This can be done via <code>apt install ansible</code>.
* An SSL key pair. See [[SSL]]. In this tutorial they are called <code>csclub-wildcard-chain.crt</code>
and <code>csclub-wildcard.key</code>.


=== Instructions ===
=== Instructions ===
Line 27: Line 29:
web frontend for BBB.
web frontend for BBB.
<br>
<br>
Git clone the repo into a folder, say <code>/root/ansible</code>, then run <code>ansible-playbook playbook.yml</code>.
Git clone the repo into a folder, say <code>/root/ansible</code>. Take a look over the files and customize any
values as you see fit. Once you are satisfied, run <code>ansible-playbook playbook.yml</code>.
</li>
</li>
<li>
<li>
Once the playbook has finished, open <code>/opt/greenlight/.env</code> and set the value of <code>DB_PASSWORD</code>.
Once the playbook has finished, open <code>/opt/greenlight/.env</code> and set the value of <code>DB_PASSWORD</code>.
</li>
<li>
Place copies of <code>csclub-wildcard-chain.crt</code> and <code>csclub-wildcard.key</code>
in the directory <code>/etc/nginx/ssl</code>. The key file must have permissions 0600.
</li>
<li>
Restart BBB by running <code>bbb-conf --restart</code>.
</li>
</li>
</ol>
</ol>

Revision as of 03:54, 14 March 2021

We run an instance of BigBlueButton at https://bbb.csclub.uwaterloo.ca. BigBlueButton is a free and open source videoconferencing platform with many features such as multi-user whiteboards, embedded videos, and interactive polls. You can check out some tutorial videos here.

Installation

BBB is currently running in an LXC container on xylitol. Here are the steps that were performed to install it.

Prerequisites

The container in which BBB is running should have:

  • Ubuntu 16. This is the only Linux distro supported by BBB.
  • A FQDN (bbb.csclub.uwaterloo.ca).
  • A public IPv4 address (and optionally an IPv6 address).
  • Firewall exceptions for TCP ports 80 and 443 and UDP ports 16384 - 32768.
  • Ansible installed. This can be done via apt install ansible.
  • An SSL key pair. See SSL. In this tutorial they are called csclub-wildcard-chain.crt
 and csclub-wildcard.key.

Instructions

  1. First we will setup the database. Login to coffee as the postgres user, run psql, then run the following:
    CREATE USER greenlight WITH PASSWORD 'replace_this_password';
    CREATE DATABASE greenlight;
    ALTER DATABASE greenlight OWNER TO greenlight;
    
  2. I wrote an Ansible playbook here which automates most of the setup (steps adapted from here). This also takes care of installing Greenlight, which is the web frontend for BBB.
    Git clone the repo into a folder, say /root/ansible. Take a look over the files and customize any values as you see fit. Once you are satisfied, run ansible-playbook playbook.yml.
  3. Once the playbook has finished, open /opt/greenlight/.env and set the value of DB_PASSWORD.
  4. Place copies of csclub-wildcard-chain.crt and csclub-wildcard.key in the directory /etc/nginx/ssl. The key file must have permissions 0600.
  5. Restart BBB by running bbb-conf --restart.