2fb26ff0cf
This patch includes two improvements made for bbb-web. It tries to better isolate the sessionToken's handling and session's validation, including logs for each one of these steps; and removes maxParticipats control from registered users (that are no longer removed from bbb-web collections) binding it to joined users or users that reached the enter API call. The following adds more details about this last one: User's regular flow to join a meeting goes around an API join call -> redis register event -> redirect to client page -> API enter call -> redis join event. When the guest policy is ASK_MODERATOR, non-moderators are registered and redirected to a guest lobby that polls for her/his guest status and only enters the meeting after a moderator approval. Using registered users as control to check how many participants are in a meeting is problematic because non-approved guests are counted as participants and bbb-web has to find out when to ditch registered users records to make a seat in a meeting available again. In other words, a meeting with maxParicipants of 5 can get it's joins locked with a moderator and 4 waiting guests or bbb-web can wrongly drop a registered user record on a reconnection inducing weird 401 responses from the API. This change proposes to control maxParticipants both at join and enter API calls monitoring the number of redis joined users. This also includes an extra buffer to capture users that called the enter API but still don't have an user joined event. User left events are now handled different holding the user data before removing from the joined users collection and only releasing after verifying that the user didn't reconnected. Both user left timeout `usersTimeout` and entered user timeout `enteredUsersTimeout` can be configured at properties. |
||
|---|---|---|
| .. | ||
| gradle/wrapper | ||
| grails-app | ||
| nginx-confs | ||
| pres-checker | ||
| src | ||
| test | ||
| wrapper | ||
| .dockerignore | ||
| .gitignore | ||
| bbb-web.nginx | ||
| build.gradle | ||
| build.sh | ||
| COPYING.LESSER | ||
| docker-entrypoint.sh | ||
| Dockerfile | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| grails-wrapper.jar | ||
| grailsw | ||
| grailsw.bat | ||
| INSTALL | ||
| README.md | ||
| run-prod.sh | ||
| run.sh | ||
| settings.gradle | ||
| turn-stun-servers.xml.tmpl | ||
BigBlueButton Web Grails 3 Deployment Procedure
Upgrade Gradle and Grails
# Install SDKMan if you don't have it yet.
curl -s "https://get.sdkman.io" | bash
# Install Gradle
sdk install gradle 5.1.1
# Install Grails
sdk install grails 3.3.9
Development
Build bbb-common-message
cd /bigbluebutton/bbb-common-message
./deploy.sh
Build bbb-common-web
cd bigbluebutton/bbb-common-web
./deploy.sh
Build and run bbb-web
cd bigbluebutton/bigbluebutton-web
# Make sure you don't have old libs lying around. Might cause issues.
# You need to to this only once to cleanup lib dir.
rm lib/*
./build.sh
# This will listen on port 8989 so you need to adjust your nginx config.
# If you've setup your nginx config to bbb-web dev, you don't need to do anything.
./run.sh
To run unit tests: grails test-app --stacktrace
Production
To package the application for production:
- Compile the application and package it use
grails assemble - You now have the file
build/libs/bigbluebutton-0.10.0.war - Create a new directory
mkdir exploded - Navigate to that directory
cd exploded - Extract the war content
jar -xvf ../build/libs/bigbluebutton-0.10.0.war - Copy run script into exploded dir
cp ../run-prod.sh . - Package the content of the new directory in a debian package then add service configuration. Install into
/usr/share/bbb-web. - Create a systemd service file that runs
run-prod.sh. App will be listening on port 8080 - To do custom config, edit
/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.propertiesDon't forget to use full directories path and replace the dot before the org with the full path to the exploded war.