1
edit
Changes
→Building the Red5 Apps
=Installing Basic BigBlueButton server=
==Update your server==
==Install BigBlueButton==
We're now ready to install BigblueButton. Type
<source lang="bash">
sudo apt-get install bigbluebutton
</source>
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.
==Install API Demos==
To interactively test your BigBlueButton server, you can install a set of API demos.
<source lang="bash">
sudo apt-get install bbb-demo
</source>
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
<source lang="bash">
sudo apt-get purge bbb-demo
</source>
==Install Presentation record and playback scripts==
<source lang="bash">
sudo apt-get install bbb-playback-presentation
</source>
==Assign the proper domain name==
<source lang="bash">
sudo bbb-conf --setip <FQDN>
</source>
==Do a Clean Restart==
To ensure BigBlueButton has started cleanly, enter the following commands:
<source lang="bash">
sudo bbb-conf --clean
sudo bbb-conf --check
</source>
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.
=Installing the Polling Module=
==Setting up the development tools==
On a BigBlueButton server, you can install all the necessary development tools with the following command:
<source lang="bash">
bbb-conf --setup-dev tools
</source>
When you run this script, you will be asked to enter your password to sudo into root. This script will:
Download and setup groovy, grails, and gradle
Download and install Open Source Flex SDK
Install OpenJDK
Install git
Add the necessary environment variables in your ~/.profile
After the initial setup is complete, you'll need to reload your .profile to use the new environment variables for groovy, grails, and gradle. To do this, run
<source lang="bash">
source ~/.profile
</source>
You need only do this once. When you next login to your account, you'll have the environment variables in place.
Again, you can use any account on a BigBlueButton server that has sudo rights. For the rest of this document we'll use the account firstuser for the examples.
The bbb-conf script create for you a dev directory in your account.
<source lang="bash">
/home/firstuser/dev
</source>
It's in this directory that you'll place the source for BigBlueButton.
==Checking out the Source==
You have to clone our git BigBlueButton fork in order to get the Polling Module.
<source lang="bash">
cd ~/dev
git clone https://github.com/capilkey/bigbluebutton.git
git checkout poll-access
</source>
==Building the Client==
===Setting up the environment===
To setup the client for development for the client, do the following
<source lang="bash">
bbb-conf --setup-dev client
</source>
You then need to open up the ~/dev/bigbluebutton/bigbluebutton-client/src/conf/config.xml file and add in the entry for the Polling Module. Make sure to replace the "<URL>" with the domain name of the server.
<source lang="mxml">
<module name="PollingModule" url="http://<URL>/client/PollingModule.swf?v=4067"
uri="rtmp://<URL>/bigbluebutton"
dependsOn="ViewersModule"
/>
</source>
===Build the source===
First, we'll build the locales (language translation files). If your not modifying the locales, you need only do this once.
<source lang="bash">
cd ~/dev/bigbluebutton/bigbluebutton-client
ant locales
</source>
This will take about 10 minutes (depending on the speed of your system).
Next, let's build the client
<source lang="bash">
ant
</source>
==Building the Red5 Apps==
Make red5/webapps writeable. Otherwise, you will get permission error when you try to deploy into Red5.
<source lang="bash">
sudo chmod -R o+w /usr/share/red5/webapps
</source>
Run the setup script. This will remove the bbb-apps package from red5/webapps.
<source lang="bash">
bbb-conf --setup-dev apps
</source>
Stop red5
<source lang="bash">
sudo /etc/init.d/red5 stop
</source>
Compile and deploy bbb-apps
<source lang="bash">
cd ~/dev/bigbluebutton/bigbluebutton-apps
gradle resolveDeps
gradle clean war deploy
</source>
Start Red5
<source lang="bash">
sudo /etc/init.d/red5 start
</source>
==Do a Clean Restart==
To ensure BigBlueButton has started cleanly, enter the following commands:
<source lang="bash">
sudo bbb-conf --clean
sudo bbb-conf --check
</source>
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.
=Moving /var/bigbluebutton=
You should wait till after everything is setup before moving folders around. Once it's all setup move /var/bigbluebutton to /storage/bigbluebutton (on the second hard drive) and make a link between the two.
=Extra Information=
For troubleshooting and extra info you can use the following links:
* http://code.google.com/p/bigbluebutton/wiki/081InstallationUbuntu
* http://code.google.com/p/bigbluebutton/wiki/DevelopingBBB
* https://groups.google.com/forum/?fromgroups=#!forum/bigbluebutton-setup
* http://code.google.com/p/bigbluebutton/wiki/FAQ
