How to upgrade BigBlueButton 2.2 to 2.3 (Ubuntu 16.04 to 18.04)?

In this article I'm going to show a procedure to upgrade BigBlueButton 2.2 to 2.3. BigBlueButton 2.2 is using Ubuntu 16.04 LTS but BigBlueButton 2.3 needs Ubuntu 18.04 LTS. BigBlueButton developers recommend to install BigBlueButton 2.3 on a clean Ubuntu 18.04 server but we're going to upgrade Ubuntu 16.04 to 18.04 by following this steps. This will save our time to transfer recordings from one server to another server. Please keep it mind to take the proper backup before starting. Check some of the exciting BigBlueButton 2.3 features.

Login to your Ubuntu 16.04 LTS server using SSH & run following commands. Please make sure you've taken proper backup. All the recordings are located under /var/bigbluebutton directory. If you had your customized development/configuration, make sure you've taken backup of those too.

1) First of all need to upgrade all the packages & reboot server.

sudo apt update && sudo apt upgrade -y && sudo apt dist-upgrade -y && apt autoremove -y
sudo reboot

2) After rebooting the server login again & run following commands in terminal. You'll need to follow the instructions from the output. You can keep continue if see any packages missing warning. Ubuntu installation will remove/update those packages automatically for you.

bbb-conf --stop

## main packages
sudo apt purge -yq kurento-media-server nodejs yq bigbluebutton bbb-html5 certbot nginx nginx-common nginx-core

## optional packages but better to remove as BigBlueButton will install those again.
sudo apt purge -yq bbb-apps-akka bbb-apps-screenshare bbb-client bbb-freeswitch-core bbb-fsesl-akka bbb-red5 bbb-transcode-akka bbb-web bbb-record-core kms-core kms-elements mongodb-org mongodb-org-server ffmpeg redis-server openjdk-8-jre openjdk-8-jre-headless

sudo apt auto-remove -y

sudo add-apt-repository --remove ppa:rmescandon/yq -y
sudo add-apt-repository --remove ppa:libreoffice/ppa -y
sudo add-apt-repository --remove ppa:bigbluebutton/support -y
sudo add-apt-repository --remove ppa:certbot/certbot -y

## we'll remove some of the directories. Please take backup if need.
sudo rm -rf /etc/bigbluebutton
sudo rm -rf /usr/local/bigbluebutton
sudo rm -rf /usr/share/bbb-web
sudo rm -rf /usr/share/red5
sudo rm -rf /var/lib/red5
sudo rm -rf /opt/freeswitch
sudo rm -rf /usr/share/etherpad-lite
sudo rm -rf /usr/lib/node_modules
sudo rm -rf /var/lib/mongodb

sudo rm -rf /etc/apt/sources.list.d/*
sudo rm -rf /var/lib/apt/lists/*

sudo mv -f /etc/apt/sources.list /etc/apt/sources.list.tmp

## This is for safety so that won't make conflict with other third party packages. We'll fixed it later.
sudo echo "deb http://archive.ubuntu.com/ubuntu xenial main restricted universe multiverse" > /etc/apt/sources.list

sudo apt clean && sudo apt update -y && sudo apt upgrade -y

sudo apt install -y update-manager-core

sudo do-release-upgrade

3) If above procedures get success & after reboot you should be on Ubuntu 18.04 LTS :-). Now run following commands before installing BigBlueButton 2.3. You can edit repository links with your favourite mirror.

sudo cat > /etc/apt/sources.list << HERE
# See http://help.ubuntu.com/community/UpgradeNotes for how to upgrade to
# newer versions of the distribution.
deb http://archive.ubuntu.com/ubuntu bionic main restricted
# deb-src http://archive.ubuntu.com/ubuntu bionic main restricted

## Major bug fix updates produced after the final release of the
## distribution.
deb http://archive.ubuntu.com/ubuntu bionic-updates main restricted
# deb-src http://archive.ubuntu.com/ubuntu bionic-updates main restricted

## N.B. software from this repository is ENTIRELY UNSUPPORTED by the Ubuntu
## team. Also, please note that software in universe WILL NOT receive any
## review or updates from the Ubuntu security team.
deb http://archive.ubuntu.com/ubuntu bionic universe
# deb-src http://archive.ubuntu.com/ubuntu bionic universe
deb http://archive.ubuntu.com/ubuntu bionic-updates universe
# deb-src http://archive.ubuntu.com/ubuntu bionic-updates universe

## N.B. software from this repository is ENTIRELY UNSUPPORTED by the Ubuntu
## team, and may not be under a free licence. Please satisfy yourself as to
## your rights to use the software. Also, please note that software in
## multiverse WILL NOT receive any review or updates from the Ubuntu
## security team.
deb http://archive.ubuntu.com/ubuntu bionic multiverse
# deb-src http://archive.ubuntu.com/ubuntu bionic multiverse
deb http://archive.ubuntu.com/ubuntu bionic-updates multiverse
# deb-src http://archive.ubuntu.com/ubuntu bionic-updates multiverse

## N.B. software from this repository may not have been tested as
## extensively as that contained in the main release, although it includes
## newer versions of some applications which may provide useful features.
## Also, please note that software in backports WILL NOT receive any review
## or updates from the Ubuntu security team.
deb http://archive.ubuntu.com/ubuntu bionic-backports main restricted universe multiverse
# deb-src http://archive.ubuntu.com/ubuntu bionic-backports main restricted universe multiverse

## Uncomment the following two lines to add software from Canonical's
## 'partner' repository.
## This software is not part of Ubuntu, but is offered by Canonical and the
## respective vendors as a service to Ubuntu users.
# deb http://archive.canonical.com/ubuntu bionic partner
# deb-src http://archive.canonical.com/ubuntu bionic partner

deb http://archive.ubuntu.com/ubuntu bionic-security main restricted
# deb-src http://archive.ubuntu.com/ubuntu bionic-security main restricted
deb http://archive.ubuntu.com/ubuntu bionic-security universe
# deb-src http://archive.ubuntu.com/ubuntu bionic-security universe
deb http://archive.ubuntu.com/ubuntu bionic-security multiverse
# deb-src http://archive.ubuntu.com/ubuntu bionic-security multiverse
HERE

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y
# if new Linux kernel was installed then better to reboot again before install BBB 2.3
sudo reboot 

4) Now it's time to install BigBlueButton 2.3 ;-)

wget -qO- http://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- -v bionic-23 -s bbb.example.com -e This email address is being protected from spambots. You need JavaScript enabled to view it.

Change host name & email address according to your one. This should install BigBlueButton 2.3 on your server & you'll be able to continue using your BigBlueButton 2.2 recordings. If you need help you can contact with us. Checkout our BigBlueButton services & BigBlueButton Hosting.

 

Common Problems:

============

Problem 1:

failed to create endpoint optimistic_haibt on network bridge: failed to add the host (veth6bc15c7) <=> sandbox (veth2de3a97) pair interfaces: operation not supported
dpkg: error processing package bbb-libreoffice-docker (--configure):

Solution: This mostly happen when new Kernel was installed. So, it will require to restart your server & try again to run:

sudo apt -f install

 It should solve the problem then run again bbb-install.sh to continue.