- Before you install
- Installation of BigBlueButton 0.80
- Install Video
- 1. Update your server
- 2. Install Ruby
- 3. Install BigBlueButton
- 4. Install API Demos
- 5. Do a Clean Restart
- Upgrading a BigBlueButton 0.71a Server
- 1. Update your server
- 2. Install Ruby
- 3. Remove FreeSWITCH 1.0.6
- 4. Upgrade BigBlueButton
- 5. Install FreeSWITCH Configuration and API demos
- 6. Remove unneeded packages
- 7. Do a clean restart
- Trying out your server (24:42 minutes later)
- Stay Connect With Us
- Troubleshooting
Before you install
These instructions require you install BigBlueButton 0.80 on a Ubuntu 10.04 32-bit or 64-bit server (or desktop). We've not tested the installation on earlier or later versions of Ubuntu.
You can verify you have Ubuntu 10.04 with the command cat /etc/lsb-release. You should see DISTRIB_RELEASE=10.04.
$ cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=10.04
DISTRIB_CODENAME=lucid
DISTRIB_DESCRIPTION="Ubuntu 10.04.4 LTS"
We recommend installing BigBlueButton on a dedicated (non-virtual) server for optimal performance. To install BigBlueButton, you'll need root access to a Ubuntu 10.04 server with
- 4 GB (or more of memory)
- quad-core 2.6 GHZ CPU (or faster)
- Ports 80, 1935, 9123 accessible
- Port 80 is not used by another application
- 500G of free disk space (or more) for recordings
- Minimum of 100 MBits/sec bandwidth
To understand why you need to check that port 80 is not in use, see we recommend running BigBlueButton on port 80.
In addition to the above, the locale of the server must be en_US.UTF-8. You can verify this by
$ cat /etc/default/locale
LANG="en_US.UTF-8"
If you don't see LANG="en_US.UTF-8", then do the following
sudo apt-get install language-pack-en
sudo update-locale LANG=en_US.UTF-8
and the logout and log back into your session. After the above, do cat /etc/default/locale again and verify you see LANG="en_US.UTF-8".
Next, verify that port 80 is not in use by another application. To verify, do
sudo apt-get install lsof
lsof -i :80
Upgrading from BigBlueButton 0.80 beta/RC
If you are upgrading from an earlier BigBlueButton 0.80 beta/release candidate, please note, if you've made custom changes to BigBlueButton, such as
- applied custom branding
- modified /var/www/bigbluebutton/client/conf/config.xml
- modified /var/www/bigbluebutton-default/index.html
- modified API demos
- modified settings to FreeSWITCH configurations
- etc ...
then you'll need to backup your changes before doing the following upgrade, after which you can reapply the changes.
To do the following
sudo apt-get update
sudo apt-get dist-upgrade
At some point in the process you may be asked to update configuration files, as in
Configuration file `/etc/nginx/sites-available/bigbluebutton'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D : show the differences between the versions
Z : background this process to examine the situation
The default action is to keep your current version.
*** bigbluebutton (Y/I/N/O/D/Z) [default=N] ?
Enter 'Y' each time continue the upgrade. After BigBlueButton updates, restart all the processes
After the install finishes, restart your BigBlueButton server with
sudo bbb-conf --clean
sudo bbb-conf --check
Upgrading from BigBlueButton 0.71a
If you are upgrading from BigBlueButton 0.71a, start here.
Installation of BigBlueButton 0.80
Install Video
To make it easy for you to setup your own BigBlueButton 0.80 server, we've put together the following overview video.
We recommend you following the video with these step-by-step instructions below.
1. Update your server
You first need to give your server access to the BigBlueButton package repository for 0.8.
In a terminal window, copy and paste the following commands.
# 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/lucid_dev_08/ bigbluebutton-lucid main" | sudo tee /etc/apt/sources.list.d/bigbluebutton.list
echo "deb http://us.archive.ubuntu.com/ubuntu/ lucid multiverse" | sudo tee -a /etc/apt/sources.list
After you've made the above changes, do a dist-upgrade to ensure your running the latest packages and your server is up-to-date before installing BigBlueButton.
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 finishes. Do the reboot before proceeding to the next step.
2. Install Ruby
The record and playback infrastructure uses Ruby for the processing of recorded sessions.
First, check if you have any previous versions of ruby installed.
dpkg -l | grep ruby
If you do, the version must match 1.9.2p290.
$ ruby -v
ruby 1.9.2p290 (2011-07-09 revision 32553)
If not, you must install the older version of before proceeding further.
To install ruby, first install the following dependencies.
sudo apt-get install zlib1g-dev libssl-dev libreadline5-dev libyaml-dev build-essential bison checkinstall libffi5 gcc checkinstall libreadline5 libyaml-0-2
Next, create a file called install-ruby.sh and copy and paste in the following script.
#!/bin/bash
cd /tmp
wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.2-p290.tar.gz
tar xvzf ruby-1.9.2-p290.tar.gz
cd ruby-1.9.2-p290
./configure --prefix=/usr\
--program-suffix=1.9.2\
--with-ruby-version=1.9.2\
--disable-install-doc
make
sudo checkinstall -D -y\
--fstrans=no\
--nodoc\
--pkgname='ruby1.9.2'\
--pkgversion='1.9.2-p290'\
--provides='ruby'\
--requires='libc6,libffi5,libgdbm3,libncurses5,libreadline5,openssl,libyaml-0-2,zlib1g'\
--maintainer=brendan.ribera@gmail.com
sudo update-alternatives --install /usr/bin/ruby ruby /usr/bin/ruby1.9.2 500 \
--slave /usr/bin/ri ri /usr/bin/ri1.9.2 \
--slave /usr/bin/irb irb /usr/bin/irb1.9.2 \
--slave /usr/bin/erb erb /usr/bin/erb1.9.2 \
--slave /usr/bin/rdoc rdoc /usr/bin/rdoc1.9.2
sudo update-alternatives --install /usr/bin/gem gem /usr/bin/gem1.9.2 500
Next, run the script
chmod +x install-ruby.sh
./install-ruby.sh
After the install finishes, type ruby -v. You should see the ruby interpreter output 1.9.2p290 (or later).
$ ruby -v
ruby 1.9.2p290 (2011-07-09 revision 32553)
Next type gem -v.
$ gem -v
1.3.7
Finally, to make sure you can install gems, type sudo gem install hello (BigBlueButton does not need the gem hello; rather, we're just testing to makes sure gem is working properly).
$ sudo gem install hello
Successfully installed hello-0.0.1
1 gem installed
Installing ri documentation for hello-0.0.1...
Installing RDoc documentation for hello-0.0.1...
Make sure you can execute the above three commands without errors before continuing with these instructions. If you do encounter errors, please post to bigbluebutton-setup and we'll help you resolve the errors.
You might be wondering why not use the default Ruby packages for Ubumtu 10.04? Unfortunately, they are out of date. Thanks to Brendan Ribera for the above script for installing the latest ruby on Ubuntu 10.04 as a package.
3. Install BigBlueButton
We're now ready to install BigblueButton. Type
sudo apt-get install bigbluebutton
This single command is where all the magic happens. This command installs all of BigBlueButton components with their dependencies. Here's a screen shot of the packages it will install.
Type 'y' and press Enter. The packaging will do all the work for you to install and configure your BigBlueButton server.
If you are behind a HTTP Proxy, you will get an error from the package bbb-record-core. You can resolve this by manually installing the gems.
4. Install API Demos
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 welcome page. This is the same welcome page you see at our demo server.
Later on, if you wish to remove the API demos, you can enter the command
sudo apt-get purge bbb-demo
5. 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 through the log files looking for errors.
The output from sudo bbb-conf --check will display your current settings and, after the text, " Potential problems described below ", print any potential configuration or startup problems it has detected.
Got to Trying out your sever.
Upgrading a BigBlueButton 0.71a Server
The following steps will upgrade a standard installation of BigBlueButton 0.71a to 0.8.
A 'standard installation' is an installation of BigBlueButton 0.71a that has been configured using the standard commands
sudo bbb-conf --setip <ip/hostname>
sudo bbb-conf --setsalt <salt>
If you've made custom changes to BigBlueButton 0.71a, such as
- applied custom branding
- modified /var/www/bigbluebutton/client/conf/config.xml
- modified /var/www/bigbluebutton-default/index.html
- modified API demos
- etc ...
then you'll need to backup your changes before doing the following upgrade, after which you can reapply the changes.
1. Update your server
First, let's update all the current packages on your server (including the kernel) to ensure your starting with an up-to-date system.
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 finishes. Do the reboot before proceeding to the next step.
2. Install Ruby
Follow the instructions here.
3. Remove FreeSWITCH 1.0.6
This step will uninstall FreeSWITCH 1.0.6.
BigBlueButton 0.80 requires FreeSWITCH 1.0.7 for recording of sessions. In later steps, the BigBlueButton 0.80 will install and configure FreeSWITCH 1.0.7.
Before upgrading, first remove the older FreeSWITCH packages.
sudo apt-get purge freeswitch freeswitch-sounds-en-us-callie-16000 freeswitch-sounds-en-us-callie-8000 freeswitch-sounds-music-16000
Check to ensure that there are no remaining FreeSWITCH packages.
dpkg -l | grep freesw
If there are any remaining packages, such as freeswitch-lang-en, then purge those as well
sudo apt-get purge freeswitch-lang-en
4. Upgrade BigBlueButton
First, update the BigBlueButton repository URL to the beta repository.
echo "deb http://ubuntu.bigbluebutton.org/lucid_dev_08/ bigbluebutton-lucid main" | sudo tee /etc/apt/sources.list.d/bigbluebutton.list
Next, update the local packages. This will make apt-get aware of the newer packages for BigBlueButton 0.8.
sudo apt-get update
The following command will upgrade your packages to the latest beta.
sudo apt-get dist-upgrade
After a few moments you'll be prompted whether you want to overwrite /etc/nginx/sites-available/bigbluebutton.
Configuration file `/etc/nginx/sites-available/bigbluebutton'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D : show the differences between the versions
Z : background this process to examine the situation
The default action is to keep your current version.
*** bigbluebutton (Y/I/N/O/D/Z) [default=N] ?
Type 'y' and hit Enter.
5. Install FreeSWITCH Configuration and API demos
Now let's install and configure FreeSWITCH 1.0.7.
sudo apt-get install bbb-freeswitch-config
Install the API demos to interactively try BigBlueButton.
sudo apt-get install bbb-demo
6. Remove unneeded packages
We no longer need activmq, so let's remove it. The command sudo apt-get autoremove will remove all remaining packages that have no reference.
sudo apt-get purge activemq
sudo apt-get autoremove
7. Do a clean restart
Let's do the standard clean restart and then check the system for any potential problems.
sudo bbb-conf --clean
sudo bbb-conf --check
Trying out your server (24:42 minutes later)
You've got a full BigBlueButton server up and running (don't you just love the power of Ubuntu/Debian packages). Open a web browser to the URL of your server. You should see the BigBlueButton welcome screen.
To start using your BigBlueButton server, enter your name and click the 'Join' button. You'll join the Demo Meeting.
If this is your first time using BigBlueButton, take a moment and watch these overview videos.
To record a session, click 'API Demos' on the welcome page and choose 'Record'. Start a meeting and upload slides. When you are done, click 'Logout' and return to the 'API Demos' and the record demo. Wait a few moments and refresh your browser, you should see your recording appear.
Click 'Slides' to playback the slides, audio, and chat of the recording.
The following YouTube Video will walk you through using record and playback. In almost all cases, you'll use BigBlueButon through a 3rd party integration (see below).
URL and salt for 3rd party integrations
If you want to use BigBlueButton with a 3rd party integration, you can get the URL and security salt from your server using the command bbb-conf --salt.
$ bbb-conf --salt
URL: http://192.168.0.36/bigbluebutton/
Salt: b22e37979cf3587dd616fa0a4e6228
출처 : http://code.google.com/p/bigbluebutton/wiki/InstallationUbuntu#Before_you_install