AuditWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

===== Setup and Deploy BBB 1.1 =====

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

1. Setup BBB 1.1 - http://docs.bigbluebutton.org/install/install.html#installing-bigbluebutton-11

2. Setup BBB 1.1 development environment - http://docs.bigbluebutton.org/dev/setup.html

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>
 // Make this IP/URL changes based on the environment
 //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.

12. Install the code signing certificate

- https://wiki.exphosted.com/doku.php?id=install_code_signing_certificate_to_learnexa_live_event_screen_share

13. Get the deployment script from svn based on the environment and make the required url changes based on the environments like(COLLAB_URL. etc..)

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

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

<code>

</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.

===== Collaboration Server Setup  ( New steps )=====

Bigbluebutton1.1 installation steps URL is given below

http://docs.bigbluebutton.org/install/install.html
  https://wiki.exphosted.com/doku.php/setup_and_deploy_bbb_11
  
Need to follow the below steps in the "http://docs.bigbluebutton.org/install/install.html"
  1. install
  2. Setup Development Environment

swap space creation ( if the collab server contain 4GB, we need to create swap space )

https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-16-04

sudo apt-get install haveged
  sudo apt-get update
  sudo apt-get dist-upgrade
  reboot 
  sudo apt-get update
  
Add the user odeploy as sudo users

visudo
  odeploy ALL=(ALL) NOPASSWD: ALL
  
Bigbluebutton clone from git

adduser expbbbp
  su - expbbbp
  sudo apt-get install git
  sudo git clone https://github.com/bigbluebutton/bigbluebutton.git
  chmod -R 775 dev
  cd ~/dev
  (/home/expbbbp/dev)
  sudo chown -R expbbbp:expbbbp tools
  sudo chown -R expbbbp:expbbbp bigbluebutton
  sudo chmod 775 bigbluebutton
  
=== GLUSTER INSTALLATION ===
https://wiki.exphosted.com/doku.php/recorder_setup_bbb_v_1.0?s[]=glusterfs&s[]=3&s[]=7&s[]=6

IMPORTANT ( Development tools needs to be installed as "expbbbp" user )

add-apt-repository ppa:gluster/glusterfs-3.8
   apt-get install glusterfs-client glusterfs-server
   mkdir -p /data/brick1/

add the below entry
   vi /etc/hosts
   10.138.84.57 odevcollab01_https
   cd /mnt
   mkdir crossbow
   /usr/sbin/gluster volume create crossbow transport tcp 10.138.84.57:/data/brick1 force
   gluster volume start crossbow force
   /sbin/mount.glusterfs odevcollab01_https:/crossbow /mnt/crossbow
   mkdir -p /usr/share/red5/webapps/recorder/streams
   cd /usr/share/red5/webapps/
   chown -R red5:red5 recorder 
  
  
   cp /soft/collab_bin.zip /home/expbbbp
   chown -R expbbbp:expbbbp bin
   apt-get install subversion
   cd /home/expbbbp/dev/bigbluebutton
   
==Cloning the source code of bigbluebutton from git==

svn co https://repos.exphosted.com/svnrepos/collaboration/bbb/trunk 
  mv trunk bigbluebutton-client_20180320102919
  chown -R expbbbp:expbbbp bigbluebutton-client_20180320102919

cd /home/expbbbp/bin
  vi deploybbbclient.sh

do perform find and replace

:%s/qacollab01.learnexa.com/odevcollab01.learnexa.com/g

and changes the APPURL as

APPURL="dev.learnexa.com"

once done the changes, run the script

./deploybbbclient.sh

The "bigbluebutton.properties" of "/var/lib/tomcat7/webapps/bigbluebutton/WEB-INF/classes/bigbluebutton.properties" should be like this

<code>

#
# BigBlueButton open source conferencing system - http://www.bigbluebutton.org/
#
# Copyright (c) 2012 BigBlueButton Inc. and by respective authors (see below).
#
# This program is free software; you can redistribute it and/or modify it under the
# terms of the GNU Lesser General Public License as published by the Free Software
# Foundation; either version 3.0 of the License, or (at your option) any later
# version.
#
# BigBlueButton is distributed in the hope that it will be useful, but WITHOUT ANY
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
# PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License along
# with BigBlueButton; if not, see <http://www.gnu.org/licenses/>.
#

#
# These are the default properites for BigBlueButton Web application

# Default loglevel. 
appLogLevel=DEBUG

#----------------------------------------------------
# Directory where BigBlueButton stores uploaded slides
presentationDir=/var/bigbluebutton

#----------------------------------------------------
# Directory where SWFTOOLS (pdf2swf, jpeg2swf, png2swf) are located
swfToolsDir=/usr/bin

#----------------------------------------------------
# Directory where ImageMagick's convert executable is located
imageMagickDir=/usr/bin

#----------------------------------------------------
# Fonts directory passed into PDF2SWF to support highlighting of texts
# in the SWF slides.
fontsDir=/usr/share/fonts

#----------------------------------------------------
# These will be copied in cases where the conversion process
# fails to generate a slide from the uploaded presentation
BLANK_SLIDE=/var/bigbluebutton/blank/blank-slide.swf
BLANK_PRESENTATION=/var/bigbluebutton/blank/blank-presentation.pdf
BLANK_THUMBNAIL=/var/bigbluebutton/blank/blank-thumb.png

#----------------------------------------------------
# Number of minutes the conversion should take. If it takes
# more than this time, cancel the conversion process.
maxConversionTime=5

#----------------------------------------------------
# Maximum number of pages allowed for an uploaded presentation (default 100).
maxNumPages=5000

#----------------------------------------------------
# Maximum swf file size for load to the client (default 500000).
MAX_SWF_FILE_SIZE=500000

#----------------------------------------------------
# Maximum allowed number of place object tags in the converted SWF, if exceeded the conversion will fallback to full BMP (default 8000)
placementsThreshold=8000

# Maximum allowed number of bitmap images in the converted SWF, if exceeded the conversion will fallback to full BMP (default 8000)
imageTagThreshold=8000

# Maximum allowed number of define text tags in the converted SWF, if exceeded the conversion will fallback to full BMP (default 2000)
defineTextThreshold=2000

#------------------------------------
# Number of threads in the pool to do the presentation conversion.
#------------------------------------
numConversionThreads=2

#----------------------------------------------------
# Additional conversion of the presentation slides to SVG
# to be used in the HTML5 client
svgImagesRequired=false

# Default number of digits for voice conference users joining through the PSTN.
defaultNumDigitsForTelVoice=5

#----------------------------------------------------
# Default dial access number
defaultDialAccessNumber=613-555-1234

#----------------------------------------------------
# Default welcome message to display when the participant joins the web
# conference. This is only used for the old scheduling which will be
# removed in the future. Use the API to create a conference.
#
# If the message contains characters not in ISO-8859-1 character sets
# they must be properly escaped to unicode characters. An easy way to
# do this is running the native2ascii command setting UTF8 encoding and
# passing this file's path as input and output parameters, e.g.:
#
# native2ascii -encoding UTF8 bigbluebutton.properties bigbluebutton.properties
#
#defaultWelcomeMessage= Welcome to %%CONFNAME%%! For help on using BigBlueButton see these (short) <a href="event:http://www.bigbluebutton.org/content/videos">tutorial videos</a>. To join the audio bridge click the headset icon (upper-left hand corner). Use a headset to avoid causing background noise for others. 
defaultWelcomeMessage=
defaultWelcomeMessageFooter=
#defaultWelcomeMessageFooter=This server is running <a href="http://docs.bigbluebutton.org/" target="_blank">BigBlueButton</a>.

# Default maximum number of users a meeting can have.
# Current default is 0 (meeting doesn't have a user limit).
defaultMaxUsers=0

# Default duration of the meeting in minutes.
# Current default is 0 (meeting doesn't end).
defaultMeetingDuration=0

# Remove the meeting from memory when the end API is called.
# This allows 3rd-party apps to recycle the meeting right-away
# instead of waiting for the meeting to expire (see below).
removeMeetingWhenEnded=true

# The number of minutes before the system removes the meeting from memory.
defaultMeetingExpireDuration=1

# The number of minutes the system waits when a meeting is created and when
# a user joins. If after this period, a user hasn't joined, the meeting is
# removed from memory.
defaultMeetingCreateJoinDuration=5

# Disable recording by default. 
#   true - don't record even if record param in the api call is set to record
#   false - when record param is passed from api, override this default
disableRecordingDefault=false

# Start recording when first user joins the meeting.
# For backward compatibility with 0.81 where whole meeting
# is recorded.  
autoStartRecording=false

# Allow the user to start/stop recording.
allowStartStopRecording=true

# Allow webcams streaming reception only to and from moderators
webcamsOnlyForModerator=false

#----------------------------------------------------
# This URL is where the BBB client is accessible. When a user sucessfully
# enters a name and password, she is redirected here to load the client.
bigbluebutton.web.serverURL=https://odevcollab01.learnexa.com

#----------------------------------------------------
# Assign URL where the logged-out participant will be redirected after sign-out.
# If "default", it returns to bigbluebutton.web.serverURL
bigbluebutton.web.logoutURL=default

# The url of the BigBlueButton client. User's will be redirected here when
# successfully joining the meeting.
defaultClientUrl=${bigbluebutton.web.serverURL}/client/LiveEvent.html
#defaultClientUrl=${bigbluebutton.web.serverURL}/client/BigBlueButton.html
#defaultClientUrl=http://192.168.0.235/3rd-party.html

# The default avatar image to display if nothing is passed on the JOIN API (avatarURL)
# call. This avatar is displayed if the user isn't sharing the webcam and
# the option (displayAvatar) is enabled in config.xml
defaultAvatarURL=${bigbluebutton.web.serverURL}/client/avatar.png

# The URL of the default configuration
defaultConfigURL=${bigbluebutton.web.serverURL}/client/conf/config.xml

apiVersion=1.1

# Salt which is used by 3rd-party apps to authenticate api calls
securitySalt=74682d7e47c263d4dc70a4a685957744

# Directory where we drop the <meeting-id-recorded>.done file
recordStatusDir=/var/bigbluebutton/recording/status/recorded

redisHost=127.0.0.1
redisPort=6379

# The directory where the published/unpublised recordings are located. This is for
# the get recording* api calls
publishedDir=/var/bigbluebutton/published
unpublishedDir=/var/bigbluebutton/unpublished

# The directory where the pre-built configs are stored
configDir=/var/bigbluebutton/configs

# If the API is enabled.
serviceEnabled = true

# Test voiceBridge number
testVoiceBridge=99999
testConferenceMock=conference-mock-default

#------------------------------------------------------
# These properties are used to test the conversion process.
# Conference name folder in ${presentationDir} (see above)
beans.presentationService.testConferenceMock=${testConferenceMock}

# Conference room folder in ${presentationDir}/${testConferenceMock}
beans.presentationService.testRoomMock=conference-mock-default
# Uploaded presentation name
beans.presentationService.testPresentationName=appkonference
# Uploaded presentation file
beans.presentationService.testUploadedPresentation=appkonference.txt
# Default Uploaded presentation file
beans.presentationService.defaultUploadedPresentation=${bigbluebutton.web.serverURL}/DefaultMockPresentationXYZ.pdf

presentationBaseURL=${bigbluebutton.web.serverURL}/bigbluebutton/presentation

#----------------------------------------------------
# The URL where the presentations will be loaded from.
#----------------------------------------------------
beans.presentationService.presentationBaseUrl=${presentationBaseURL}
#----------------------------------------------------
# Inject values into grails service beans
beans.presentationService.presentationDir=${presentationDir}

#----------------------------------------------------
# Specify which IPs can do cross domain requests
accessControlAllowOrigin=${bigbluebutton.web.serverURL}

#----------------------------------------------------
# The lapsus of seconds for polling the BBB Server in order to check if it's down.
# After 5 tries if there isn't response, it will be declared down
checkBBBServerEvery=10

</code>

if demo is not working ( http://hostname/demo/demo1.jsp ) after ran "deploybbbclient.sh"  http 500 error ( java.lang.NullPointerException )

sudo service redis-server restart

URL for Reference : https://groups.google.com/forum/#!msg/bigbluebutton-dev/ryVNAW96m8Q/i4hM3fAsAAAJ

Try the following

sudo service redis-server restart

sudo bbb-conf --check

If you still see issues with the redis server, try the following

sudo service redis-server stop
  sudo mv /var/lib/redis/redis.rdb /var/lib/redis/redis.rdb_old
  sudo service redis-server start

==Recorder setup==

cd /home/expbbbp/dev/bigbluebutton
  mkdir recorder
  cd /mnt/crossbow
  sudo mkdir assets
  sudo mkdir system
  sudo mkdir streams
  sudo chown -R odeploy:odeploy assets
  sudo chown -R odeploy:odeploy system
  sudo chown -R odeploy:red5 streams
  sudo chmod -R 775 streams
 
  su - expbbbp
  cd ~/bin
  (/home/expbbbp/bin)

vi deploy_recorder_server.sh
    replace expdev01 with odeploy

sh deploy_recorder_server.sh

cd /bin
 
place the below content
 vi cbmount
<code>
#!/bin/bash
sudo umount /usr/share/red5/webapps/video/streams
sudo umount /usr/share/red5/webapps/recorder/streams
sudo umount odevcollab01_https:/crossbow
sudo /sbin/mount.glusterfs odevcollab01_https:/crossbow /mnt/crossbow
sudo mount -o bind /mnt/crossbow/streams /usr/share/red5/webapps/video/streams
sudo mount -o bind /mnt/crossbow/streams /usr/share/red5/webapps/recorder/streams
</code>

Whenever we re-start the collab server we need to run the "cbmount" script

cd /bin
  ./cbmount

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International

AuditWiki

User Tools

Site Tools

Page Tools