My favorites ▼ | Sign in

bigbluebuttonOpen Source Web Conferencing

Project   Home Downloads Wiki Issues Source

Search

                    for   

‹‹Install BigBlueButton 0.80 (June 18, 2012 - Release Notes)o Install

BigBlueButton (Ubuntu 10.04)

o Downloa d Virtual Machine

o BigBlue Button's configuration tool

Overview Developing Support BigBlueBut ton LabsRaw List of Wiki Pages

InstallationUbuntuHow to install BigBlueButton 0.80 on Ubuntu 10.04 in under 30 minutes

Updated Today (8 hours ago) by ffdixon@gmail.com

Note: The package repository is off-line as of 6PM, Monday, November 12th. We expect to have it back on-line (very) soon.

Before you install o Upgrading from BigBlueButton 0.80 beta/RC o Upgrading from BigBlueButton 0.71a

Installation of BigBlueButton 0.80 o Install Video o 1. Update your server o 2. Install Ruby o 3. Install BigBlueButton o 4. Install API Demos o 5. Do a Clean Restart

Upgrading a BigBlueButton 0.71a Server o 1. Update your server o 2. Install Ruby o 3. Remove FreeSWITCH 1.0.6 o 4. Upgrade BigBlueButton o 5. Install FreeSWITCH Configuration and API demos o 6. Remove unneeded packages o 7. Do a clean restart

Trying out your server (24:42 minutes later) o URL and salt for 3rd party integrations

Stay Connect With Us Troubleshooting

o Run sudo bbb-conf --check

Current pages Search

o Dependencies are not met o Change the BigBlueButton Server's IP o Address already in use o no such file to load -- rubygems o Unable to install gems

Before you installThese 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-releaseDISTRIB_ID=UbuntuDISTRIB_RELEASE=10.04DISTRIB_CODENAME=lucidDISTRIB_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

1. 2 GB of memory (4 GB is better)

2. Dual-core 2.6 GHZ CPU (quad core is better)

3. Ports 80, 1935, 9123 accessible

4. Port 80 is not used by another application

5. 50G of free disk space (or more) for recordings

In addition to the above, the locale of the server must be en_US.UTF-8. You can verify this by$ cat /etc/default/localeLANG="en_US.UTF-8"

To verify that port 80 is not in use by another application, you can type   sudo apt-get install lsof   lsof -i :80

Upgrading from BigBlueButton 0.80 beta/RCIf 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.71aIf you are upgrading from BigBlueButton 0.71a, start here.

Installation of BigBlueButton 0.80Install VideoTo 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 serverYou 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 keywget http://ubuntu.bigbluebutton.org/bigbluebutton.asc -O- | sudo apt-key add -

# Add the BigBlueButton repository URL and ensure the multiverse is enabledecho "deb http://ubuntu.bigbluebutton.org/lucid_dev_08/ bigbluebutton-lucid main" | sudo tee /etc/apt/sources.list.d/bigbluebutton.listecho "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 updatesudo 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 RubyThe record and playback infrastructure uses Ruby for the processing of recorded sessions.

First, you'll need to install the following dependencies to compile ruby.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/bashcd /tmpwget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.2-p290.tar.gztar xvzf ruby-1.9.2-p290.tar.gzcd ruby-1.9.2-p290./configure --prefix=/usr\            --program-suffix=1.9.2\            --with-ruby-version=1.9.2\            --disable-install-docmakesudo 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.comsudo 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.2sudo update-alternatives --install /usr/bin/gem gem /usr/bin/gem1.9.2 500

Next, run the scriptchmod +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 -vruby 1.9.2p290 (2011-07-09 revision 32553)

Next type gem -v.$ gem -v1.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 helloSuccessfully installed hello-0.0.11 gem installedInstalling 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 Riberafor the above script for installing the latest ruby on Ubuntu 10.04 as a package.

3. Install BigBlueButtonWe'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 DemosTo 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 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 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 ServerThe 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 serverFirst, 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 updatesudo 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 RubyFollow the instructions here.

3. Remove FreeSWITCH 1.0.6This 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 BigBlueButtonFirst, 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 demosNow 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 packagesWe 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 activemqsudo apt-get autoremove

7. Do a clean restartLet's do the standard clean restart and then check the system for any potential problems.sudo bbb-conf --cleansudo 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.

Terms - Privacy - Project Hosting HelpPowered by Google Project Hosting