Escolar Documentos
Profissional Documentos
Cultura Documentos
1 of 8
http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu
My favorites | Sign in
bigbluebutton
Search projects
Downloads
Search
Wiki
Overview
Developing
Support
BigBlueButton Labs
Raw List of Wiki Pages
Source
for
Install BigBlueButton
0.9.0-beta ( Release Notes )
Install BigBlueButton 0.81
(Nov 7, 2013 - Release
Notes )
Issues
Search
090InstallationUbuntu
How to install BigBlueButton 0.9.0-beta
Welcome to the installation guide for BigBlueButton 0.9.0-beta. BigBlueButton is an open source web c
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 inst
install on a clean installation of Ubuntu 14.04 64-bit. The reason is that BigBlueButton ran on Ubuntu 10
runs on Ubuntu 14.04 64-bit. We recommend setting up a new Ubuntu 14.04 64-bit server and
BigBlueButton server to the new.
For users we recommend (a minimum of) 1.0 Mbits/sec download speed and 0.5 Mbits/sec upload spee
In addition to ensuring your server meets the above requirements, there are a few more checks. First, th
en_US.UTF-8. To verify , enter the following command
$ cat /etc/default/locale
LANG="en_US.UTF-8"
07/04/2015 17:01
2 of 8
http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu
Next, logout and log back into your session (this will reload your configuration). Run cat /etc/defaul
single line LANG="en_US.UTF-8". Note: if you see an additional line LC_ALL=en_US.UTF-8, then remo
continuing.
Check that you are running under 64-bit.
$ uname -m
x86_64
And check your version of Ubuntu is Ubuntu 14.04. If you try to install BigBlueButton 0.9.0-beta on any
$ cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=14.04
DISTRIB_CODENAME=trusty
DISTRIB_DESCRIPTION="Ubuntu 14.04.X LTS"
If you encounter an error at any step, STOP and double-check you've entered the proper commands. D
only compound the errors). If you can't resolve it (use Google to search for the error messages), please
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 mult
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
$ 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-upgrade
to the next step.
Ubuntu 14.04 installs LibreOffice 4.2.7 by default, but we want to use LibreOffice 4.3 for improved stabi
documents 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
07/04/2015 17:01
3 of 8
http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu
# 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 ffmpeg
BigBlueButton 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.
After the script finishes, check that ffmepg is installed by typing the command ffmpeg -version
$ ffmpeg -version
ffmpeg 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 BigBlueButton
We'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 com
packaging will do all the work for you to install and configure your BigBlueButton server.
07/04/2015 17:01
4 of 8
http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu
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
07/04/2015 17:01
5 of 8
http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu
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 BigBlueBut
same 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
9. Do a Clean Restart
To 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 throug
The output from sudo bbb-conf --check will display your current settings and, after the text, "
potential configuration or startup problems it has detected.
If already have a BigBlueButton 0.81 server, these instructions will not upgrade your server. To install B
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 ste
BigBlueButton 0.9.0-beta.
$ sudo apt-get install software-properties-common
$ sudo add-apt-repository ppa:libreoffice/libreoffice-4-3
Respond with 'Y', if you get prompted to update any configuration file during the upgrade
07/04/2015 17:01
6 of 8
http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu
Troubleshooting
If you encounter an error at one of the installation/upgrade steps,
We've built in a BigBlueButton configuration utility, called bbb-conf, to help you configure your BigBlue
setup 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
common 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
settings) or errors with the setup.
Some hosting providers do not provide a complete /etc/apt/source.list. If you are finding your are
your /etc/apt/sources.list with the following
then do
$ sudo apt-get update
A common problem is the default install scripts in for BigBlueButton configure it to list for an IP address
a 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 <ip_address_or_hostname>
If you are installing on EC2 or a hosting provider that has a number of network interfaces, you need to t
external interface on it's IP address (shown below as EXTERNAL_IP_ADDRESS). You must use the ex
EXTERNAL_IP_ADDRESS is show (not the external hostname).
Edit /opt/freeswitch/conf/vars.xml
Remove this line
<X-PRE-PROCESS cmd="set" data="local_ip_v4=xxx.yyy.zzz.qqq"/>
Change
<X-PRE-PROCESS cmd="set" data="bind_server_ip=auto"/>
To
<X-PRE-PROCESS cmd="set" data="bind_server_ip=EXTERNAL_IP_ADDRESS"/>
Change
<X-PRE-PROCESS cmd="set" data="external_rtp_ip=stun:stun.freeswitch.org"/>
To
07/04/2015 17:01
7 of 8
http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu
Change
<X-PRE-PROCESS cmd="set" data="external_sip_ip=stun:stun.freeswitch.org"/>
To
<X-PRE-PROCESS cmd="set" data="external_sip_ip=EXTERNAL_IP_ADDRESS"/>
name="rtp-ip" value="$${local_ip_v4}"/>
name="sip-ip" value="$${local_ip_v4}"/>
name="ext-rtp-ip" value="$${local_ip_v4}"/>
name="ext-sip-ip" value="$${local_ip_v4}"/>
<param
<param
<param
<param
name="rtp-ip" value="$${local_ip_v4}"/>
name="sip-ip" value="$${local_ip_v4}"/>
name="ext-rtp-ip" value="$${external_rtp_ip}"/>
name="ext-sip-ip" value="$${external_sip_ip}"/>
to
Edit /usr/share/red5/webapps/sip/WEB-INF/bigbluebutton-sip.properties
bbb.sip.app.ip=<internal ip>
bbb.sip.app.port=5070
freeswitch.ip=<internal 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;
}
1001: WebSocket disconnected - The WebSocket had connected successfully and has now disconne
Loss of internet connection
Nginx restarting can cause this
1002: Could not make a WebSocket connection - The initial WebSocket connection was unsuccessf
Firewall blocking ws protocol
Server is down or improperly configured
1003: Browser version not supported - Browser doesnt implement the necessary WebRTC API meth
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/
07/04/2015 17:01
8 of 8
http://code.google.com/p/bigbluebutton/wiki/090InstallationUbuntu
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 th
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 Fir
1007: ICE negotiation failed - The browser and !FreeSWITCH try to negotiate ports to use to stream th
Possible Causes:
NAT is blocking the connection
Firewall is blocking the UDP connection/ports
1008: Call transfer failed - A timeout while waiting for FreeSWITCH to transfer from the echo test to th
by a misconfiguration in FreeSWITCH, or there might be a media error and the DTMF command to tran
voice in the echo test probably didn't work either.)
1009: Could not fetch STUN/TURN server information - This indicates either a BigBlueButton bug (o
client/old server combination), but could also happen due to a network interruption.
07/04/2015 17:01