090InstallationUbuntu - Bigbluebutton - How to Install BigBlueButton 0.9.0-Beta - Open Source Web Conferencing - Google Project Hosting

Project Home Downloads Wiki Issues Source

My favorites | Sign in

bigbluebuttonOpen Source Web Conferencing Search projects

Search for Search

Install BigBlueButton0.9.0-beta ( Release Notes )Install BigBlueButton 0.81(Nov 7, 2013 - ReleaseNotes )OverviewDevelopingSupportBigBlueButton LabsRaw List of Wiki Pages

090InstallationUbuntu How to install BigBlueButton 0.9.0-beta

Before you installInstalling BigBlueButton 0.9.0-beta

1. Update your server2. Install PPA for LibreOffice 4.33. Install key for BigBlueButton4. Install ffmpeg5. Install BigBlueButton6. Install API Demos (optional)7. Install Client Self-Check (optional)8. Enable WebRTC audio9. Do a Clean Restart

Transferring recordings from a BigBlueButton 0.81 serverUpgrading BigBlueButton 0.9.0-betaTroubleshooting

Run sudo bbb-conf --checkChange the BigBlueButton Server's IPAudio not workingClient WebRTC Error Codes

Welcome to the installation guide for BigBlueButton 0.9.0-beta. BigBlueButton is an open source web conferencing s

For an overview what new in this release, see overview.

If you already have a BigBlueButton 0.81 server, these instructions will not upgrade your server. To install BigBlueBuinstall on a clean installation of Ubuntu 14.04 64-bit. The reason is that BigBlueButton ran on Ubuntu 10.04 64-bit, whruns on Ubuntu 14.04 64-bit. We recommend setting up a new Ubuntu 14.04 64-bit server and BigBlueButton server to the new.

Before you installThe requirements for BigBlueButton 0.9.0-beta server are

Ubuntu 14.04 64-bit4 GB of memory (8 GB is better) with swap enabledQuad-core 2.6 GHZ CPU (or faster)TCP ports 80, 1935, 9123 are accessibleUDP ports 16384 - 32768 are accessiblePort 80 is not used by another application500G of free disk space (or more) for recordings100 Mbits/sec bandwidth (symmetrical)

For users we recommend (a minimum of) 1.0 Mbits/sec download speed and 0.5 Mbits/sec upload speed.In addition to ensuring your server meets the above requirements, there are a few more checks. First, the locale of then_US.UTF-8. To verify , enter the following command

$ cat /etc/default/localeLANG="en_US.UTF-8"

090InstallationUbuntu - bigbluebutton - How to install BigBlueButton ... http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu

1 of 8 07/04/2015 17:01

If you don't see LANG="en_US.UTF-8", then enter the following commands.

$ sudo apt-get install language-pack-en$ sudo update-locale LANG=en_US.UTF-8

Next, logout and log back into your session (this will reload your configuration). Run cat /etc/default/localesingle line LANG="en_US.UTF-8". Note: if you see an additional line LC_ALL=en_US.UTF-8, then remove the settingcontinuing.

Check that you are running under 64-bit.

$ uname -mx86_64

And check your version of Ubuntu is Ubuntu 14.04. If you try to install BigBlueButton 0.9.0-beta on any other release

$ cat /etc/lsb-releaseDISTRIB_ID=UbuntuDISTRIB_RELEASE=14.04DISTRIB_CODENAME=trustyDISTRIB_DESCRIPTION="Ubuntu 14.04.X LTS"

Your now ready to install BigBlueButton.

Installing BigBlueButton 0.9.0-betaIf you've already installed an earlier build, see upgrading BigBlueButton 0.9.0.

If you encounter an error at any step, STOP and double-check you've entered the proper commands. Don't continue only compound the errors). If you can't resolve it (use Google to search for the error messages), please see

1. Update your serverFirst, ensure that you have trusty multiverse in your sources.list. Do the following.

$ grep "multiverse" /etc/apt/sources.list

and you should see the line that has a URL to the trusty multiverse uncommented, such as

deb http://archive.ubuntu.com/ubuntu trusty multiverse

or

deb http://archive.ubuntu.com/ubuntu trusty main restricted universe multiverse

Don't worry if your URL is different, what's important is you see an uncommented link that contains multiverse. If you following line this repository to sources.list.

$ echo "deb http://us.archive.ubuntu.com/ubuntu/ trusty multiverse" | sudo tee

Before proceeding further, do a dist-upgrade to ensure all the current packages on your server are up-to-date.

$ sudo apt-get update$ sudo apt-get dist-upgrade

If you've not updated in a while, apt-get may recommend you reboot your server after dist-upgradeto the next step.

2. Install PPA for LibreOffice 4.3Ubuntu 14.04 installs LibreOffice 4.2.7 by default, but we want to use LibreOffice 4.3 for improved stability on conversdocuments to PDF.

In a terminal window, copy and paste the following commands.

$ sudo apt-get install software-properties-common$ sudo add-apt-repository ppa:libreoffice/libreoffice-4-3


2 of 8 07/04/2015 17:01

3. Install key for BigBlueButtonYou first need to give your server access to the BigBlueButton package repository.

# Add the BigBlueButton key$ wget http://ubuntu.bigbluebutton.org/bigbluebutton.asc -O- | sudo apt-key add -

# Add the BigBlueButton repository URL and ensure the multiverse is enabled$ echo "deb http://ubuntu.bigbluebutton.org/trusty-090/ bigbluebutton-trusty main"

# Update packages$ sudo apt-get update

4. Install ffmpegBigBlueButton 0.9.0-beta uses ffmpeg to process recordings of a session for playback.

To install ffmpeg, create a file called install-ffmpeg.sh and copy and paste in the following script.

sudo apt-get install build-essential git-core checkinstall yasm texi2html libvorbis

FFMPEG_VERSION=2.3.3

cd /usr/local/srcif [ ! -d "/usr/local/src/ffmpeg-${FFMPEG_VERSION}" ]; then sudo wget "http://ffmpeg.org/releases/ffmpeg-${FFMPEG_VERSION}.tar.bz2" sudo tar -xjf "ffmpeg-${FFMPEG_VERSION}.tar.bz2"fi

cd "ffmpeg-${FFMPEG_VERSION}"sudo ./configure --enable-version3 --enable-postproc --enable-libvorbis --sudo makesudo checkinstall --pkgname=ffmpeg --pkgversion="5:${FFMPEG_VERSION}" --backup

Next, run the commands

$ chmod +x install-ffmpeg.sh$ ./install-ffmpeg.sh

After the script finishes, check that ffmepg is installed by typing the command ffmpeg -version

$ ffmpeg -versionffmpeg version 2.3.3 Copyright (c) 2000-2014 the FFmpeg developers built on Aug 18 2014 17:35:05 with gcc 4.8 (Ubuntu 4.8.2-19ubuntu1) configuration: --enable-version3 --enable-postproc --enable-libvorbis -- libavutil 52. 92.100 / 52. 92.100 libavcodec 55. 69.100 / 55. 69.100 libavformat 55. 48.100 / 55. 48.100 libavdevice 55. 13.102 / 55. 13.102 libavfilter 4. 11.100 / 4. 11.100 libswscale 2. 6.100 / 2. 6.100 libswresample 0. 19.100 / 0. 19.100

5. Install BigBlueButtonWe're now ready to install BigblueButton 0.9.0-beta. Type

$ sudo apt-get update$ sudo apt-get install bigbluebutton

This single command is where all the magic happens. This command installs all of BigBlueButton's components withpackaging will do all the work for you to install and configure your BigBlueButton server.


3 of 8 07/04/2015 17:01

Type 'Y' and press enter to install.

If you get an error message

...... Error: FreeSWITCH didn't start

you can ignore it as we'll do a clean restart of all the components in step 6.

If you get an error message

Setting up bbb-playback-presentation (0.9.0-1ubuntu5) ...chown: invalid user: tomcat7:tomcat7

then run the install again

$ sudo apt-get install bigbluebutton

it should finish without errors.

6. Install API Demos (optional)


4 of 8 07/04/2015 17:01

To interactively test your BigBlueButton server, you can install a set of API demos.

$ sudo apt-get install bbb-demo

You'll need the bbb-demo package installed if you want to join the Demo Meeting from your BigBlueButton server's wsame welcome page you see at demo server.

Later on, if you wish to remove the API demos, you can enter the command

$ sudo apt-get purge bbb-demo

7. Install Client Self-Check (optional)To install the client self-check page:

$ sudo apt-get install bbb-check

This is the same welcome page you see at client self-check.

Later on, if you wish to remove the client self-check page, you can enter the command

$ sudo apt-get purge bbb-check

8. Enable WebRTC audioTo enable WebRTC audio, do the following

$ sudo bbb-conf --enablewebrtc

9. Do a Clean RestartTo ensure BigBlueButton has started cleanly, enter the following commands:

$ sudo bbb-conf --clean$ sudo bbb-conf --check

The --clean option will clear out all the log files for BigBlueButton. The --check option will grep through the log files

The output from sudo bbb-conf --check will display your current settings and, after the text, "potential configuration or startup problems it has detected.

Transferring recordings from a BigBlueButton 0.81 serverPlease see 090TransferRecordings

Upgrading BigBlueButton 0.9.0-betaIf already have a BigBlueButton 0.81 server, these instructions will not upgrade your server. To install BigBlueButton install on a clean installation of Ubuntu 14.04 64-bit and follow the steps previous in this document.

First, add the package repository for LibreOffice 4.3. You only need to do this once and can skip this step in applyingBigBlueButton 0.9.0-beta.

$ sudo apt-get install software-properties-common$ sudo add-apt-repository ppa:libreoffice/libreoffice-4-3

To upgrade earlier versions of BigBlueButton 0.9.0-beta, do the following:

$ sudo apt-get update$ sudo apt-get dist-upgrade

$ sudo bbb-conf --enablewebrtc$ sudo bbb-conf --clean$ sudo bbb-conf --check

Respond with 'Y', if you get prompted to update any configuration file during the upgrade


5 of 8 07/04/2015 17:01

TroubleshootingIf you encounter an error at one of the installation/upgrade steps,

Run sudo bbb-conf --checkWe've built in a BigBlueButton configuration utility, called bbb-conf, to help you configure your BigBlueButton serversetup if something doesn't work right.

If you think something isn't working correctly, the first step is enter the following command.

$ sudo bbb-conf --check

This will check your setup to ensure the correct processes are running, the BigBlueButton components have correctlycommon configuration problems that might prevent BigBlueButton from working properly.

If you see text after the line ** Potential problems described below **, then it may be warnings (which you csettings) or errors with the setup.Some hosting providers do not provide a complete /etc/apt/source.list. If you are finding your are unable to insyour /etc/apt/sources.list with the following

deb http://archive.ubuntu.com/ubuntu trusty main restricted universe multiversedeb http://archive.ubuntu.com/ubuntu trusty-updates main restricted universe multiversedeb http://security.ubuntu.com/ubuntu trusty-security main restricted universe multiverse

then do

$ sudo apt-get update

and try installing BigBlueButton again from the beginning steps.

Change the BigBlueButton Server's IPA common problem is the default install scripts in for BigBlueButton configure it to list for an IP address, but if you area DNS hostname, you'll see the 'Welcome to Nginx' message.

To change all of BigBlueButton's configuration files to use a different IP address or hostname, enter

$ sudo bbb-conf --setip

For more information see bbb-conf options.

Audio not workingIf you are installing on EC2 or a hosting provider that has a number of network interfaces, you need to tell FreeSWITexternal interface on it's IP address (shown below as EXTERNAL_IP_ADDRESS). You must use the external IP addrEXTERNAL_IP_ADDRESS is show (not the external hostname).Edit /opt/freeswitch/conf/vars.xml

Remove this line

Change

To

Change

To


6 of 8 07/04/2015 17:01

Change

To

Edit /opt/freeswitch/conf/sip_profiles/external.xml and change

to

Edit /usr/share/red5/webapps/sip/WEB-INF/bigbluebutton-sip.properties

bbb.sip.app.ip=bbb.sip.app.port=5070

freeswitch.ip=freeswitch.port=5060

Edit /etc/bigbluebutton/nginx/sip.nginx to

location /ws { proxy_pass http://EXTERNAL_IP_ADDRESS:5066; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "Upgrade"; proxy_read_timeout 6h; proxy_send_timeout 6h; client_body_timeout 6h; send_timeout 6h;}

changing EXTERNAL_IP_ADDRESS to your server's elastic IP address.

Open the firewall (if you have on installed) and Security Groups (if your using EC2) the following ports:TCP - 5066

UDP - 16384 to 32768

Client WebRTC Error Codes1001: WebSocket disconnected - The WebSocket had connected successfully and has now disconnected. Possible

Loss of internet connectionNginx restarting can cause this

1002: Could not make a WebSocket connection - The initial WebSocket connection was unsuccessful. Possible C

Firewall blocking ws protocolServer is down or improperly configured

1003: Browser version not supported - Browser doesnt implement the necessary WebRTC API methods. Possible

Out of date browser

1004: Failure on call - The call was attempted, but failed. Possible Causes:

For a full list of causes refer here, http://sipjs.com/api/0.6.0/causes/


7 of 8 07/04/2015 17:01

There are 24 different causes so I dont really want to list all of them

1005: Call ended unexpectedly - The call was successful, but ended without user requesting to end the session. Po

Unknown

1006: Call timed out - The library took too long to try and connect the call. Possible Causes:

Previously caused by Firefox 33-beta on Mac. We've been unable to reproduce since release of FireFox 34

1007: ICE negotiation failed - The browser and !FreeSWITCH try to negotiate ports to use to stream the media andPossible Causes:

NAT is blocking the connectionFirewall is blocking the UDP connection/ports

1008: Call transfer failed - A timeout while waiting for FreeSWITCH to transfer from the echo test to the real by a misconfiguration in FreeSWITCH, or there might be a media error and the DTMF command to transfer didn't go voice in the echo test probably didn't work either.)1009: Could not fetch STUN/TURN server information - This indicates either a BigBlueButton bug (or you're usingclient/old server combination), but could also happen due to a network interruption.

Terms - Privacy - Project Hosting HelpPowered by Google Project Hosting


8 of 8 07/04/2015 17:01

Documents

090InstallationUbuntu - Bigbluebutton - How to Install BigBlueButton 0.9.0-Beta - Open Source Web Conferencing - Google Project Hosting