2019-01-26 00:24:06 +08:00
|
|
|
# BigBlueButton Web Grails 3 Deployment Procedure
|
|
|
|
|
|
2019-02-06 05:17:12 +08:00
|
|
|
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
|
|
|
|
|
```
|
|
|
|
|
|
2019-02-08 00:05:50 +08:00
|
|
|
### Development
|
2019-01-26 00:24:06 +08:00
|
|
|
|
2019-02-08 00:05:50 +08:00
|
|
|
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
|
|
|
|
|
|
|
|
|
|
```
|
2019-01-26 00:24:06 +08:00
|
|
|
|
|
|
|
|
To run unit tests: `grails test-app --stacktrace`
|
|
|
|
|
|
2019-02-08 00:05:50 +08:00
|
|
|
### Production
|
|
|
|
|
|
2019-01-26 00:24:06 +08:00
|
|
|
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`
|
2019-02-06 05:52:28 +08:00
|
|
|
6. Copy run script into exploded dir `cp ../run-prod.sh .`
|
|
|
|
|
7. Package the content of the new directory in a debian package then add service configuration. Install into `/usr/share/bbb-web`.
|
2019-02-06 05:54:45 +08:00
|
|
|
8. Create a systemd service file that runs `run-prod.sh`. App will be listening on port 8080
|
|
|
|
|
9. To do custom config, edit `/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties`
|
2019-02-06 05:17:12 +08:00
|
|
|
Don't forget to use full directories path and replace the dot before the org with the full path to the exploded war.
|
