BigBlueButton_Debian_Squeeze, version 1
Anthony Callegaro
parent
bda2cc9774
commit
3a25788ea2
158
BigBlueButton_Debian_Squeeze.md
Normal file
158
BigBlueButton_Debian_Squeeze.md
Normal file
@ -0,0 +1,158 @@
|
|||||||
|
How to install BigBlueButton on Debian Squeeze
|
||||||
|
==============================================
|
||||||
|
|
||||||
|
This small tutorial is to give a step by step procedure to install a
|
||||||
|
BigBlueButton 0.71a server on Debian Squeeze 32bit. I based it on the
|
||||||
|
[official
|
||||||
|
tutorial](http://code.google.com/p/bigbluebutton/wiki/InstallationBigBlueButtonDebian)
|
||||||
|
which is clearly over complicated (compiled things from source), have
|
||||||
|
some bogus instructions (ie. add Ubuntu’s multiverse to a debian
|
||||||
|
server), etc.
|
||||||
|
|
||||||
|
1. Install
|
||||||
|
----------
|
||||||
|
|
||||||
|
This is the procedure I followed which, I think, is much easier :
|
||||||
|
|
||||||
|
- Add repositories with their keys
|
||||||
|
# bigbluebutton repository key
|
||||||
|
wget http://ubuntu.bigbluebutton.org/bigbluebutton.asc -O- | apt-key add -
|
||||||
|
# Freeswitch PPA key
|
||||||
|
apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 451AE93C
|
||||||
|
echo -e "deb http://ubuntu.bigbluebutton.org/lucid/ bigbluebutton-lucid main\ndeb http://ppa.launchpad.net/freeswitch-drivers/freeswitch-nightly-drivers/ubuntu lucid main" > /etc/apt/sources.list.d/bigbluebutton.list
|
||||||
|
aptitude update
|
||||||
|
|
||||||
|
<!-- -->
|
||||||
|
|
||||||
|
- Install pre-requisites with necessary workaround for packaging bugs
|
||||||
|
:
|
||||||
|
- Install sudo
|
||||||
|
All script are Ubuntufied so you will have to install sudo or
|
||||||
|
some scripts (bbb-conf) won’t work correctly.
|
||||||
|
aptitude install sudo
|
||||||
|
|
||||||
|
- Install libmpfr
|
||||||
|
libmpfr has been superseded by
|
||||||
|
[libmpfr4](http://packages.qa.debian.org/m/mpfr/news/20110223T163917Z.html)
|
||||||
|
and so is no longer available in Debian Squeeze. swftools
|
||||||
|
depends on it but the version in Lenny is a little bit too old
|
||||||
|
(2.3.1), so instead of compiling the source and making a new
|
||||||
|
package, as indicated in the official how to, we’ll just resolve
|
||||||
|
the dependencies by using the one from ubuntu :
|
||||||
|
aptitude install libgmp3c2
|
||||||
|
wget http://ubuntu.mirror.cambrium.nl/ubuntu//pool/main/m/mpfr/libmpfr1ldbl_2.4.2-3ubuntu1_i386.deb
|
||||||
|
dpkg -i libmpfr1ldbl_2.4.2-3ubuntu1_i386.deb
|
||||||
|
|
||||||
|
- Another workaround to avoid errors later on :
|
||||||
|
mkdir -p /var/www/nginx-default/
|
||||||
|
touch /var/www/nginx-default/50x.html
|
||||||
|
- Now you can install BigBlueButton
|
||||||
|
aptitude install bbb-freeswitch-config bbb-client bigbluebutton
|
||||||
|
|
||||||
|
- Configure BigBlueButton and start it :
|
||||||
|
bbb-conf --clean
|
||||||
|
bbb-conf --check
|
||||||
|
bbb-conf --setip YOUR_IP
|
||||||
|
|
||||||
|
You can now go to http://YOUR\_IP and try the demo.
|
||||||
|
|
||||||
|
2. Tips and tricks
|
||||||
|
------------------
|
||||||
|
|
||||||
|
BigBlueButton is a fantastic tool that works incredibly well, but it is
|
||||||
|
still quite young, and is not yet very flexible in term of
|
||||||
|
configuration. So here are some tips that I collected, hoping they will
|
||||||
|
save you some hours of hair pulling.
|
||||||
|
|
||||||
|
### 2.1. Firewall setup
|
||||||
|
|
||||||
|
BigBlueButton require to open 3 ports : 80, 1935, 9123. You can also
|
||||||
|
open only port 80 and so tunnel everything through it, but you will most
|
||||||
|
likely get bitten by [this
|
||||||
|
bug](http://code.google.com/p/bigbluebutton/issues/detail?id=785) which
|
||||||
|
is a [known Linux/Mac Adobe Flash
|
||||||
|
bug](https://bugs.adobe.com/jira/browse/FP-4797) . Basically you will be
|
||||||
|
connected, and you will be able to do things but the session will
|
||||||
|
re-initalise every 20-30 seconds. This bug doesn’t affect Windows users
|
||||||
|
and is supposed to be solved in Flashplayer 11.0.1.3 beta for Linux and
|
||||||
|
Mac.
|
||||||
|
|
||||||
|
### 2.2. Redmine integration
|
||||||
|
|
||||||
|
BigBlueButton does not provide any administration GUI beside the demo,
|
||||||
|
it is up to you to use their API, to create meetings. As we are already
|
||||||
|
using Redmine I tried Redmine’s BigBlueButton plugin. :
|
||||||
|
|
||||||
|
cd /usr/local/share/redmine
|
||||||
|
ruby script/plugin install http://github.com/amartel/redmine_bbb.git
|
||||||
|
|
||||||
|
|
||||||
|
After restarting your Redmine instance, you will have a new plugin
|
||||||
|
available in Administration ->Plugins. Then you need to give users
|
||||||
|
BigBlueButton roles (create, join, moderate). Finally you need to go to
|
||||||
|
a project settings and activate the BigBlueButton module to enable the
|
||||||
|
“create meeting” link on the overview page.
|
||||||
|
|
||||||
|
### 2.3. Put BigBlueButton server behind a firewall or on a VPN
|
||||||
|
|
||||||
|
If you put your BigBlueButton server on a VPN or behind a firewall and
|
||||||
|
you want to configure a public access, the configuration can be very
|
||||||
|
tricky. Here is an example config providing that you have the following
|
||||||
|
topology :
|
||||||
|
|
||||||
|
WEB <=> Redmine/Web Server <=> BigBlueButton server
|
||||||
|
ExtIP : bigbluebutton.mydomain.com IP : 192.168.1.10
|
||||||
|
|
||||||
|
BigBlueButton requires to have an IP that resolves to the same name as
|
||||||
|
configured so either you can put a record in an internal DNS or add the
|
||||||
|
following to its /etc/hosts :
|
||||||
|
|
||||||
|
vi /etc/hosts
|
||||||
|
-> 192.168.1.10 bigbluebutton.mydomain.com
|
||||||
|
bbb-conf --setip bigbluebutton.mydomain.com
|
||||||
|
|
||||||
|
It will throw a message that the IP does not match but this is ok.
|
||||||
|
|
||||||
|
# IP does not match:
|
||||||
|
# IP from ifconfig: 192.168.1.10
|
||||||
|
# /etc/nginx/sites-available/bigbluebutton: bigbluebutton.mydomain.com
|
||||||
|
|
||||||
|
On the Redmine/Web server :
|
||||||
|
|
||||||
|
- Forward port 9123 to BigBlueButton’s server port 9123
|
||||||
|
- Forward port 1935 to BigBlueButton’s server port 1935
|
||||||
|
- Configure a new vhost called bigbluebutton.mydomain.com that does a
|
||||||
|
proxy pass to 192.168.1.10
|
||||||
|
- DO NOT TRY to put it on a subfolder (ie. mydomain.com/bbb) if you
|
||||||
|
don’t want to have to modify lots of bigblubutton’s source code.
|
||||||
|
|
||||||
|
In Redmine ->Administration ->Plugins ->BigBlueButton put
|
||||||
|
the following (no trailing slash or else you will hit 403 errors) :
|
||||||
|
|
||||||
|
- BigBlueButton server = http://bigbluebutton.mydomain.com
|
||||||
|
- Internal address = http://192.168.1.10
|
||||||
|
- salt : the salt you will find in
|
||||||
|
/var/lib/tomcat6/webapps/bigbluebutton/WEB-INF/classes/bigbluebutton.properties
|
||||||
|
in beans.dynamicConferenceService.securitySalt
|
||||||
|
|
||||||
|
As we have an internal VPN with its own DNS, I do not know if you
|
||||||
|
require to add BigBlueButton’s IP to the web servers /etc/hosts file as
|
||||||
|
well.
|
||||||
|
|
||||||
|
Beware that BigBlueButton’s configuration is extremely sensitive, a
|
||||||
|
slight change in the above and it might not work. If you encounter any
|
||||||
|
issue with the above do not hesitate to ping us on
|
||||||
|
[IRC,](http://www.personalized-software.ie/support#chat) to [send us an
|
||||||
|
email](http://www.personalized-software.ie/contactus) or to contact the
|
||||||
|
[bigbluebutton crew.](http://bigbluebutton.org/)
|
||||||
|
|
||||||
|
### 2.4. End meeting after every participants logged out
|
||||||
|
|
||||||
|
You can do this easily by modifying the configuration :
|
||||||
|
|
||||||
|
vi /var/lib/tomcat6/webapps/bigbluebutton/WEB-INF/classes/bigbluebutton.properties
|
||||||
|
-> beans.dynamicConferenceService.minutesElapsedBeforeMeetingExpiration=0
|
||||||
|
|
||||||
|
I found during my testing that the delay before the meeting is actually
|
||||||
|
closed can vary from a few seconds to a few minutes, but it does work.
|
||||||
|
|
||||||
Loading…
Reference in New Issue
Block a user