bigbluebutton-Github/bigbluebutton-web
schrd 64e43e4331
fix(core): 3.0 cluster setup (#20439)
* Add graphql API endpoint to BBB API

This parameter will be required for the HTML5 client to discover the API
endpoint of the GraphQL API so it can fetch its settings.

* Fix: ensure API calls are headed towards the BBB Server

In a cluster setup the URL that is visible in the browser is different
from the URL of the BBB Server.

The clients needs to contact the BBB server to retrieve information
about the graphQL websocket and the graphql API.

This patch adds the GraphQL API endpoint to the BBB API and changes the
Client to use it.

* Make GraphQL API endpoint configurable

The default value should work for single node and cluster setups

* Update docs to reflect changes required by cluster setup

* fix eslint and typescript errors

* Fix cluster setup docs

- add missing parts for hasura
- use consistent domain example.com

* rename variable

Co-authored-by: Gustavo Trott <gustavo@trott.com.br>

* rename variable

Co-authored-by: Gustavo Trott <gustavo@trott.com.br>

* rename variable

Co-authored-by: Gustavo Trott <gustavo@trott.com.br>

* Update bigbluebutton-web/grails-app/controllers/org/bigbluebutton/web/controllers/ApiController.groovy

Co-authored-by: Gustavo Trott <gustavo@trott.com.br>

* Update bigbluebutton-web/grails-app/conf/bigbluebutton.properties

Co-authored-by: Gustavo Trott <gustavo@trott.com.br>

---------

Co-authored-by: Daniel Schreiber <daniel.schreiber@hrz.tu-chemnitz.de>
Co-authored-by: Gustavo Trott <gustavo@trott.com.br>
2024-06-17 14:26:13 -04:00
..
gradle/wrapper Upgrade Grails to 6.1 2024-01-19 15:39:39 -05:00
grails-app fix(core): 3.0 cluster setup (#20439) 2024-06-17 14:26:13 -04:00
nginx-confs Removes all references to swf files (used by old flash client) 2022-11-17 10:55:19 -03:00
pres-checker Added try-catch to stream close 2023-05-09 16:18:20 +00:00
src fix(core): 3.0 cluster setup (#20439) 2024-06-17 14:26:13 -04:00
test remove SetPollsXML 2022-09-30 14:24:09 +00:00
wrapper
.gitignore refactor: further cleanup of bbb-demo 2022-07-14 14:55:10 +00:00
bbb-web.nginx Fix: use grails configuration for CORS settings 2022-07-27 23:30:36 +02:00
build.gradle fix(sec): Bump org.json:json 2024-03-15 12:12:11 -04:00
build.sh - separate building and running as most of the times, we don't need to re-run bringing in jars and configs. 2019-01-25 12:25:16 -08:00
COPYING.LESSER
deploy_to_usr_share.sh fix: Allow for existing dir 'exploded' in bbb-web deploy_to_usr_share.sh 2023-03-09 16:23:21 -05:00
gradle.properties fix(sec): Bump tomcatEmbed to 9.0.86 (#19814) 2024-03-18 10:02:58 -04:00
gradlew upgrading bigbluebutton-web 2021-12-17 12:39:03 +00:00
gradlew.bat upgrading bigbluebutton-web 2021-12-17 12:39:03 +00:00
grails-wrapper.jar Update bigbluebutton-web to gradle 5.1 (Work In Progress) 2019-01-09 21:06:09 +01:00
grailsw Update bigbluebutton-web to gradle 5.1 (Work In Progress) 2019-01-09 21:06:09 +01:00
grailsw.bat chore: Fix typo (found by typos) (port) #19834 2024-03-18 09:58:53 -04:00
INSTALL
loadbalancer.nginx Update packaging and nginx config for loadbalancer 2021-11-21 21:12:50 +01:00
README.md chore(bbb-web): do away with wrapper script, use default files 2022-10-11 19:45:26 +02:00
run-dev.sh Improve scripts to run/deploy applications 2022-03-31 13:48:57 -03:00
run.sh refactor: swap netstat with ss 2022-03-23 20:50:19 +00:00
settings.gradle Update bigbluebutton-web to gradle 5.1 (Work In Progress) 2019-01-09 21:06:09 +01:00
turn-stun-servers.xml.tmpl - reduce size of the bbb-html5 image 2018-08-24 17:15:47 -03:00

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:

  1. Compile the application and package it use grails assemble
  2. You now have the file build/libs/bigbluebutton-0.10.0.war
  3. Create a new directory mkdir exploded
  4. Navigate to that directory cd exploded
  5. Extract the war content jar -xvf ../build/libs/bigbluebutton-0.10.0.war
  6. Package the content of the new directory in a debian package then add service configuration. Install into /usr/share/bbb-web.
  7. Use the systemd service file provided in build/package-template/bbb-web. App will be listening on port 8080
  8. To do custom config, edit /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties Don't forget to use full directories path and replace the dot before the org with the full path to the exploded war.