Customize

Greenlight customization

Customized version here in git in branch fairteaching.

after doing changes do in ~/greenlight or in .env build to registry.

for registry login get token from registry user profile and login with fairlogin user name and this token instead of pw

docker login registry.osalliance.com       
docker build -t registry.osalliance.com/osalliance/fairteaching:0.6 .
docker push registry.osalliance.com/osalliance/fairteaching:0.6
docker-compose down
docker-compose up -d

bigbluebutton/greenlight is the new image name which has been built.

See http://docs.bigbluebutton.org/greenlight/gl-customize.html#restart-greenlight

Language file: ~/greenlight/config/locales/de_DE.yml

after updating greenlight from upstream:

ruby bin/bundle update
Gemfile.lock öffnen und letzten 2 Zeilen löschen (Bundle Version)

BBB modules customization

Info text in each conference is in bigbluebutton.properties

we keep a copy of config files of modules which are outside greenlight in its config directory, as this is in git:

after each BBB update you need to re-apply (check changes first!):

cp ~/greenlight/config/bigbluebutton.properties /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties

(as long as there is an issue with escaping characters, other like energy-level are not overwritten #18 (closed))

cp ~/greenlight/config/turn-stun-servers.xml /usr/share/bbb-web/WEB-INF/classes/spring/turn-stun-servers.xml
cp /var/www/bigbluebutton-default/favicon.gif /var/www/bigbluebutton-default/favicon.ico
cp ~/greenlight/config/de.json /usr/share/meteor/bundle/programs/server/assets/app/locales/de.json

check /etc/kurento/modules/kurento/WebRtcEndpoint.conf.ini for non - Google STUN server, we take turn.fairkom.net:

stunServerAddress=144.76.116.252
stunServerPort=3478

also apply in /usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml

clientTitle: fairteaching
reduced bitrates for cameras 80 / 150 / 400 / 800
skipCheck

   screenshare:
      constraints:
        video:
          frameRate:
            ideal: 24
            max: 30
          width:
            max: 1920
          height:
            max: 1080
        audio: true

see also ~/greenlight/config/meteor_app_settings.yml (gitted template) - but parameters change quickly at each update

improve audio quality #29 (closed)

in /opt/freeswitch/conf/autoload_configs/conference.conf.xml - our template is FAIRTEACHINGconference.conf.xml in the cdquality section:

      <param name="rate" value="48000"/>
      <param name="interval" value="10"/>
      <param name="channels" value="2"/>
      <param name="energy-level" value="30"/>

in /opt/freeswitch/conf/autoload_configs/opus.conf.xml

<configuration name="opus.conf">
      <settings>
        <param name="use-vbr" value="0"/>
        <param name="use-dtx" value="0"/>
        <param name="complexity" value="10"/>
        <param name="packet-loss-percent" value="8"/>
        <param name="keep-fec-enabled" value="1"/>
        <param name="use-jb-lookahead" value="1"/>
        <param name="advertise-useinbandfec" value="1"/>
        <param name="maxaveragebitrate" value="256000"/>
      </settings>
</configuration>

Set number of node processes in BBB 2.3 here /usr/share/meteor/bundle/bbb-html5-with-roles.conf

Then do a

bbb-conf --restart

After each update do a

bbb-conf --setip arlberg.fairteaching.net see https://docs.bigbluebutton.org/2.2/install.html#upgrading-from-bigbluebutton-22

( BBB 2.3 has got local config overrides https://docs.bigbluebutton.org/admin/configuration-files.html#local-overrides-for-configuration-settings)

reload parameters

/opt/freeswitch/bin/fs_cli
reloadxml
/exit

deactivated room creation

deactivated room creation for users on arlberg.fairteaching.net in the greenlight admin console for the role user - api-calls still possible.