diff --git a/README.install-22.04 b/README.install-22.04 new file mode 100644 index 0000000..9bcd905 --- /dev/null +++ b/README.install-22.04 @@ -0,0 +1,136 @@ +# =================== +# +# see: +# - https://docs.bigbluebutton.org/administration/install/ +# +# =================== + +FQDN_HOSTNAME="bbb.oopen.de" +ADMIN_EMAIL="ckubu-adm@oopen.de" + +FQDN_HOSTNAME="bbb.aufstehen-gegen-rassismus.de" +ADMIN_EMAIL="agr@vvn-bda.de" + +# === +# 1 Pre-installation checks +# === + +# see: https://docs.bigbluebutton.org/administration/install/#pre-installation-checks + +# --- +# Run script bbb-pre-install.sh +# --- + +# Download Repository containing the pre installation script +# +git clone https://git.oopen.de/install/bigbluebutton /usr/local/src/ + + +# Run the script 'bbb-pre-install.sh' +# +# The script does: +# +# - installs missing debian packages + +# - checks the locale parameter and sets it to 'en_US.UTF-8' if necessary +# +# - Installs the latest version of Docker if necessary +# +/usr/local/src/bigbluebutton/bbb-pre-install.sh + + +# === +# 2. Install BigBlueButton +# === + + +# --- +# Install BigBlueButton (incl. Greenligth) directly +# --- + +# Download and pipe downlaoded stream directly through 'bash -s' +# +# -w Install UFW firewall (recommended) +# -v Install given version of BigBlueButton (e.g. 'focal-270') (required) +# -v jammy-300 installs the latest iteration of BigBlueButton 3.0.x . +# -v focal-270 installs the latest iteration of BigBlueButton 2.7.x . +# -s Configure server with +# -e Email for Let's Encrypt certbot +# -g Install Greenlight version 3 +# +wget -qO- https://raw.githubusercontent.com/bigbluebutton/bbb-install/v3.0.x-release/bbb-install.sh \ + | bash -s -- -w -v jammy-300 -s ${FQDN_HOSTNAME} -e ${ADMIN_EMAIL} -g + + +# !! Note !! +# +# If the FQHN of the BigBlueButton service is part of the '/etc/hosts' file, +# then BigBlueButton will not work properly, at least not if the FQHN points +# to a 127 IP address (e.g. 127.0.1.1). +# +sed -i -E "/^[[:space:]]*127.0.1.1[[:space:]]+${FQDN_HOSTNAME}/d" /etc/hosts +if [[ -f "/etc/cloud/templates/hosts.debian.tmpl" ]] ; then + sed -i -E "/^127.0.1.1/d" /etc/cloud/templates/hosts.debian.tmpl +fi + + +# --- +# Install BigBlueButton (incl. Greenligth) by running script 'bbb-install.sh' lacally +# --- + +mkdir -p /usr/local/src/bbb + +git clone https://github.com/bigbluebutton/bbb-install.git /usr/local/src/bbb/ + +# run commnad 'bbb-install.sh' +# +# -w Install UFW firewall (recommended) +# -v Install given version of BigBlueButton (e.g. 'focal-270') (required) +# -s Configure server with +# -e Email for Let's Encrypt certbot +# -g Install Greenlight version 3 +# +/usr/local/src/bbb/bbb-install.sh -w -v jammy-300 -s ${FQDN_HOSTNAME} -e ${ADMIN_EMAIL} -g + +sed -i -E "/^[[:space:]]*127.0.1.1[[:space:]]+${FQDN_HOSTNAME}/d" /etc/hosts +if [[ -f "/etc/cloud/templates/hosts.debian.tmpl" ]] ; then + sed -i -E "/^127.0.1.1/d" /etc/cloud/templates/hosts.debian.tmpl +fi + + + +# -- +# Installation finished +# -- + + + +# === +# Globally disable recordings in BigBlueButton +# === + +# Server operators can overwrite default value for disableRecordingDefault initially +# set in /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties by overwriting +# it in /etc/bigbluebutton/bbb-web.properties - +# +# set disableRecordingDefault=false to disableRecordingDefault=true for globally disabling +# recordings. +# +# Furthermore, recording of breakout rooms should be disabled by setting +# breakoutRoomsRecord=false. In general, this is an advisable idea (independently of +# disableRecordingDefault=true, because break-out rooms might imply a certain level of +# privacy for typical users. +if ! $(grep -qE "^\s*disableRecordingDefault=" /etc/bigbluebutton/bbb-web.properties 2> /dev/null) ; then + echo "disableRecordingDefault=true" >> /etc/bigbluebutton/bbb-web.properties +else + perl -i -n -p -e"s/^disableRecordingDefault.*/disableRecordingDefault=true/" /etc/bigbluebutton/bbb-web.properties +fi + +if ! $(grep -qE "^\s*breakoutRoomsRecord=" /etc/bigbluebutton/bbb-web.properties 2> /dev/null) ; then + echo "breakoutRoomsRecord=false" >> /etc/bigbluebutton/bbb-web.properties +else + perl -i -n -p -e"s/^breakoutRoomsRecord.*/breakoutRoomsRecord=false/" /etc/bigbluebutton/bbb-web.properties +fi + + +# =====================================================================================