Merge pull request #226 from mariogasparoni/master

Add documentation for creating development environment for BigBlueButton 2.3

Author: ffdixon

_posts/2020-07-10-dev23.md

@@ -59,11 +59,11 @@ The player is a complete rewrite that gives the user much more control and navig
 
 The react-based player will playback on iOS and Android phones and tablets.
 
-The presentation area displays the current slide or screenshare. 
+The presentation area displays the current slide or screenshare.
 
 ### Layout controls
 
-The layout controls in the upper right-hand corner 
+The layout controls in the upper right-hand corner
 
 <img src="/images/22-playback-layout.png" alt="Layout" />
 
@@ -210,14 +210,14 @@ We are now providing presenters with the option to randomly pick a student in th
 
 # Installation
 
-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 
+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
 
   * Ubuntu 18.04 64-bit
   * docker (Libreoffice now runs within a docker container)
 
 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.  
 
-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 
+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
 
 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
 
@@ -289,7 +289,7 @@ RestartSec=3
 WantedBy=multi-user.target
 ```
 
-If you want 3 recording workers, for example, the steps below show how to add a systemd override file in `/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. 
+If you want 3 recording workers, for example, the steps below show how to add a systemd override file in `/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.
 
 
 ```
@@ -320,9 +320,131 @@ HERE
 `systemctl status bbb-rap-resque-worker.service` shows three resque workers ready to process upto three recordings in parallel.
 
 # Setup development environment
+A few considerations before we start:
+ - Required OS: Ubuntu 18.04 (bionic)
+ - This is intended to run on containers/local-machine setup, such as LXC.
+ - This process is similar to BBB 2.2's install. One difference is that we
+ encapsulated Libreoffice in docker for increased security.
+ - For public/production servers, we recommend installing BigBlueButton using
+ [bbb-install.sh](https://github.com/bigbluebutton/bbb-install)
 
-To set up a development environment for 2.3-dev, follow the [steps from 2.2](https://docs.bigbluebutton.org/2.2/dev.html).
 
+
+We'll do this in 3 steps:
+* [Install BBB **2.3-dev** (detailed below)](#installl-bbb-23-dev)
+* [Setup SSL (same as 2.2)](#setup-https)
+* [Setup development environment (same as 2.2)](#setup-development-environment-1)
+
+
+## Installl BBB 2.3-dev
+
+### Install basic deps
+Install needed tools
+```bash
+sudo apt-get update && sudo apt-get install curl wget net-tools software-properties-common haveged apt-transport-https openjdk-8-jdk -y
+```
+Add needed repositories
+```bash
+sudo add-apt-repository ppa:bigbluebutton/support -y
+```
+```bash
+sudo add-apt-repository ppa:rmescandon/yq -y
+```
+```bash
+sudo add-apt-repository ppa:libreoffice/ppa
+```
+Upgrade packages
+```bash
+sudo apt-get update && sudo apt-get dist-upgrade
+```
+
+### Install MongoDB
+##### (Note: BBB 2.3-dev uses MongoDB 4.2, while BBB 2.2 uses MongoDB 3.4)
+Add key for MongoDB's repository
+```bash
+wget -qO - https://www.mongodb.org/static/pgp/server-4.2.asc | sudo apt-key add -
+```
+Add APT's source for MongoDB
+```bash
+echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list
+```
+Install MongoDB
+```bash
+sudo apt-get update && sudo apt-get install -y mongodb-org
+```
+
+
+### Install Node.js
+##### (Note: BBB 2.3-dev uses Node.js 12.x, while BBB 2.2 uses Node.js 8.x)
+```bash
+curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
+```
+```bash
+sudo apt-get install nodejs
+```
+
+
+### Install Kurento Media Server
+##### (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)
+Add key for Kurento
+
+```bash
+sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 5AFA7A83
+```
+Add APT's source
+```bash
+sudo tee "/etc/apt/sources.list.d/kurento.list" >/dev/null <<EOF
+# Kurento Media Server - Release packages
+deb [arch=amd64] http://ubuntu.openvidu.io/6.15.0 bionic kms6
+EOF
+```
+Install it
+```bash
+sudo apt-get update && sudo apt-get install kurento-media-server
+```
+
+
+### Install BigBlueButton
+Add key for BigBlueButton
+```bash
+wget https://ubuntu.bigbluebutton.org/repo/bigbluebutton.asc -O- | sudo apt-key add -
+```
+Add APT's source for BigBlueButton
+```bash
+echo "deb https://ubuntu.bigbluebutton.org/bionic-23-dev bigbluebutton-bionic main" | sudo tee /etc/apt/sources.list.d/bigbluebutton.list
+```
+Install it
+```bash
+sudo apt-get update && sudo apt-get install bigbluebutton
+```
+
+### (Optional) Install bbb-demo
+If you want to test the installation, you can install demos:
+```bash
+sudo apt-get install bbb-demo
+```
+Before testing, make sure you have set `secure: false` in `/usr/share/bbb-web/WEB-INF/classes/application.yml` file:
+```yml
+# ...
+server:
+    session:
+        cookie:
+            secure: false
+# ...
+
+```
+You can access http://BBB_IP_ADDRESS , and you will be able to join bbb-demo
+(probably WebRTC media won't work because it needs HTTPS to be set).
+BBB_IP_ADDRESS is the ip address of your container/machine running this
+installation.
+
+## Setup HTTPS
+Follow [2.2's Configure SSL on your BigBlueButton server](https://docs.bigbluebutton.org/2.2/install.html#configure-ssl-on-your-bigbluebutton-server)
+
+## Setup development environment
+Follow [2.2's Setup a Development Environment](https://docs.bigbluebutton.org/2.2/dev.html#setup-a-development-environment)
+
+## Known Problems
 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:
 
 ```