1
edit
Changes
→Building the Red5 Apps
=Installing Basic BigBlueButton server=
==Update your server==
<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>
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
