===== Setup and Deploy BBB 1.0 =====

==== Setup BBB and Client ==== 

1. Setup BBB 1.0 - http://docs.bigbluebutton.org/10install.html#installing-bigbluebutton-10

2. Setup BBB 1.0 development environment - http://docs.bigbluebutton.org/10setup.html#Setup_Development_Environment_

Verify that the BBB app launches fine with the client loading from development directory.

4. Changes to the config files - 
<code>

sudo vi /var/lib/tomcat6/webapps/bigbluebutton/WEB-INF/classes/bigbluebutton.properties

maxNumPages=5000
defaultWelcomeMessage=  //(just leave it empty)
defaultWelcomeMessageFooter= //(just leave it empty)
defaultClientUrl=${bigbluebutton.web.serverURL}/client/LiveEvent.html
beans.presentationService.defaultUploadedPresentation=${bigbluebutton.web.serverURL}/DefaultMockPresentationXYZ.pdf

cd /var/www/bigbluebutton-default/ 
sudo touch DefaultMockPresentationXYZ.pdf

sudo vi /etc/bigbluebutton/nginx/client.nginx

//change location /client/BigBlueButton.html {  -> location /client/LiveEvent.html {

sudo vi /etc/nginx/sites-enabled/bigbluebutton
client_max_body_size 200m

sudo vi /etc/bigbluebutton/nginx/web.nginx
client_max_body_size 200m;

sudo vi /etc/bigbluebutton/nginx/client.nginx
root /var/www/bigbluebutton => root /home/expbbbp/dev/bigbluebutton/bigbluebutton-client;

Make sure the proper ngnix configuration and add the ssl certificate path

</code>
   
5. Checkout client code from svn co https://repos.exphosted.com/svnrepos/collaboration/bbb/trunk/ and place it at <home of bbb user>/dev/bigbluebutton/bigbluebutton-client

6. Client config changes - Change config.xml file ( <home of bbb user>/dev/bigbluebutton/bigbluebutton-client
src/conf/config.xml) \\
(It better to symlink this file has this is full of IP configuration) \\

<code>
     //Replace the ip (For instance - 192.168.2.240) 192.168.2.240 with this machine’s hostname(devcollab02.learnexa.com)
     sed -i s/http://192.168.2.184/devcollab02.learnexa.com/g bigbluebutton-client/src/conf/config.xml
     
     //Replace the ip http://192.168.2.154:3000 with learnexa url machine’s hostname
     sed -i s/http://192.168.2.154:3000/https://dev01.learnexa.com/g bigbluebutton-client/src/conf/config.xml
</code>

7. Compile client and restart bbb
<code>
cd <home of bbb user>/dev/bigbluebutton/bigbluebutton-client
ant 
ant locales
sudo bbb-conf --restart
</code>

**Note -** Steps 5-7 will be taken care by deploy script once the initial setup is done. 

8. Setup freeswitch

9. Edit Learnexa rails app bigbluebutton.yml settings to place the details of bigbluebutton URL and salt.
Restart learnexa rails app.

10. Whenever we change the collaburl in learnexa(config/bigbluebutton.yml) then the corresponded extension needs to be updated in learnexa
 <code>
  1. Incase voice extension is changed in BBB setup then old extension needs to be deleted and the new extension needs to be added in the database via running the following backfill tasks(voice_extensions.rake) 
  
  a. First change the extention which is needs to be inactivated in(db/voice_extensions_inactive.csv) and run 
     bundle exec rake voice_extensions:inactivate 
  b. Delete the extension which are all inactive by running
     bundle exec rake voice_extensions:delete_inactive 
  c. Add the new extension which is needs to be added in (db/voice_extensions.csv) and run 
     bundle exec rake voice_extensions:populate
 </code>

11. Edit public/crossdomain.xml settings to allow cross domain ajax requests from BBB machine URL.


==== Setup/Deploy recorder App ====

1. Change /usr/share/red5/conf/red5-common.xml to replace queueThreshold and deplayWrite values.

<code>

<bean id="fileConsumer" scope="prototype" lazy-init="true" class="org.red5.server.stream.consumer.FileConsumer"> 
   <property name="delayWrite" value="false"/> 
   <property name="queueThreshold" value="14400"/> 
</bean>

</code>


Just running the deploy script after below mentioned changes is fine.

==== Setup Streams for video streaming ====

1) Edit / Verify Hosts. Check whether /etc/hosts has an entry mapping this machine's FQDN to 127.0.0.1
2) Mount "streams" brick.
<code>
touch /usr/share/red5/websapps/video/streams/error-if_you_see_this
mount.glusterfs <FQDN>:/streams /usr/share/red5/websapps/video/streams
</code>
3) Verify that it is correctly mounted and add to fstab.

==== Deploy Script changes ====

=== 1) BBB client ===

1) Replace all the URLs in sed commands to update the /src/conf/config.xml

2) Make a directory as bbb user.
<code> mkdir -p ~/dev/srctrunk </code>

3) Change the value of BBBDIR to "/home/<bbb user>/dev/bigbluebutton"

=== 2) Recorder server ===

1) Update the bbb user home directory and path to bbb directory correctly.