You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Mar 22, 2023. It is now read-only.
Add documentation for creating development environment for BigBlueButton 2.3
A few things changed on how we install and setup 2.3, so i decided start it from zero and documented this trying to keep it consistent to docs format.
I spent some time reading bbb-install.sh script to keep this process also consistent to current default installation of BBB.
@@ -210,14 +210,14 @@ We are now providing presenters with the option to randomly pick a student in th
210
210
211
211
# Installation
212
212
213
-
BigBlueButton 2.3-dev requires the same [minimum server requirements](https://docs.bigbluebutton.org/2.2/install.html#minimum-server-requirements) as 2.2, with the following notable differences
213
+
BigBlueButton 2.3-dev requires the same [minimum server requirements](https://docs.bigbluebutton.org/2.2/install.html#minimum-server-requirements) as 2.2, with the following notable differences
214
214
215
215
* Ubuntu 18.04 64-bit
216
216
* docker (Libreoffice now runs within a docker container)
217
217
218
218
The requirement for docker may preclude running 2.3-dev within some virtualized environments, such as LXC and containerd; however, it ensures libreoffice runs within a restrited sandbox for document conversion.
219
219
220
-
Use the [bbb-install.sh](https://github.com/bigbluebutton/bbb-install) script to install BigBlueButton 2.3-dev on an Ubuntu 18.04 server with a single command, such as
220
+
Use the [bbb-install.sh](https://github.com/bigbluebutton/bbb-install) script to install BigBlueButton 2.3-dev on an Ubuntu 18.04 server with a single command, such as
221
221
222
222
For example, if the external hostname of your server was `bbb.example.com` and your e-mail address was `[email protected]`, you can install BigBlueButton 2.3-dev with the command
223
223
@@ -289,7 +289,7 @@ RestartSec=3
289
289
WantedBy=multi-user.target
290
290
```
291
291
292
-
If you want 3 recording workers, forexample, the steps below show how to add a systemd override filein`/etc/systemd/system/bbb-rap-resque-worker.service.d/override.conf` that sets `Environment=COUNT=3` and restarts the `bbb-rap-resque-worker.service` service.
292
+
If you want 3 recording workers, forexample, the steps below show how to add a systemd override filein`/etc/systemd/system/bbb-rap-resque-worker.service.d/override.conf` that sets `Environment=COUNT=3` and restarts the `bbb-rap-resque-worker.service` service.
293
293
294
294
295
295
```
@@ -320,9 +320,132 @@ HERE
320
320
`systemctl status bbb-rap-resque-worker.service` shows three resque workers ready to process upto three recordings in parallel.
321
321
322
322
# Setup development environment
323
+
A few considerations before we start:
324
+
- Required OS: Ubuntu 18.04 (bionic)
325
+
- This is intended to run on containers/local-machine setup, such as LXC.
326
+
- This process is similar to BBB 2.2's install. Since **this is not intended
327
+
to run on production/public machine**, we won't use libreoffice's docker version,
328
+
but you can manually install docker and then reconfigure bbb-libreoffice-docker
329
+
to use 'dockerized' version. **!! Do not run BigBlueButton in a public server
330
+
without the docker version of libreoffice !! There are security issues related
331
+
to this. See this [CVE link](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2020-25820)**
323
332
324
-
To set up a development environment for 2.3-dev, follow the [steps from 2.2](https://docs.bigbluebutton.org/2.2/dev.html).
##### (Note: BBB 2.3-dev uses Kurento Media Server official's repository, instead of forked version. The current version used by BBB 2.3-dev is 6.15.0)
If you want to test the installation, you can install demos:
424
+
```bash
425
+
sudo apt-get install bbb-demo
426
+
```
427
+
Before testing, make sure you have set`secure: false`in`/usr/share/bbb-web/WEB-INF/classes/application.yml` file:
428
+
```yml
429
+
# ...
430
+
server:
431
+
session:
432
+
cookie:
433
+
secure: false
434
+
# ...
435
+
436
+
```
437
+
You can access http://BBB_IP_ADDRESS , and you will be able to join bbb-demo
438
+
(probably WebRTC media won't work because it needs HTTPS to be set).
439
+
BBB_IP_ADDRESS is the ip address of your container/machine running this
440
+
installation.
441
+
442
+
## Setup HTTPS
443
+
Follow [2.2's Configure SSL on your BigBlueButton server](https://docs.bigbluebutton.org/2.2/install.html#configure-ssl-on-your-bigbluebutton-server)
444
+
445
+
## Setup development environment
446
+
Follow [2.2's Setup a Development Environment](https://docs.bigbluebutton.org/2.2/dev.html#setup-a-development-environment)
447
+
448
+
## Known Problems
326
449
BigBlueButton 2.3-dev uses Java 8; however, Ubuntu 18.04 ships with Java 11 set as default option. If you see something similar while trying to compile bbb-common-messages or bbb-apps-akka:
0 commit comments