BigBlueButton安装过程(翻译)
欢迎来到BigBlueButton 1.0-beta安装指南(以下简称BigBlueButton 1.0)。BigBlueButton是一个开放源代码的网络会议系统进行在线学习。有关概述了本版本中新的,请参阅概述。
建议将bigbluebutton 1.0安装在没有运行任何其他Web应用程序的 Ubuntu 14.04的64位服务器上(最好是独立服务器)。这将避免微妙的冲突(如潜在的配置文件),可能导致bigbluebutton安装和运行误差。
安装前
对于BigBlueButton1.0服务器的先决条件是:
l Ubuntu 14.04 64-bit server
l 4GB内存并启用交换分区(8GB更好)
l 四核2.6 GHZ的CPU(或更快)
l TCP端口80,1935年,9123都可以访问
l UDP端口16384 - 32768的访问
l 端口80没有被另一应用程序占用
l 用于存储录音的可用磁盘空间500G(或更多)
l 100兆位/秒的带宽(对称)
l 专用(裸机)的硬件(未虚拟化)
如果你打算安装BigBlueButton用于开发,那么在虚拟环境的安装效果很好。为了开发,你也许并不需要一个可用磁盘空间500G的虚拟机; 50G就足够了。但是,如果您打算在生产中运行BigBlueButton,我们建议使用专用(裸机)的服务器上安装。 BigBlueButton使用FreeSWITCH来处理传入的实时包的音频,并且FreeSWITCH在非虚拟化环境(参见FreeSWITCH的推荐的配置)工作的更好。
对于用户来说,我们建议(最低)1.0兆位/秒的下载速度和0.5兆位/秒的上传速度。
除了确保您的服务器满足上述要求,也有一些更多的检查。
首先,服务器的区域必须是en_US.UTF-8。为了验证,输入以下命令
$ cat /etc/default/locale
LANG="en_US.UTF-8"
如果你没有见到 LANG="en_US.UTF-8"
,输入如下命令。
$ sudo apt-get install language-pack-en
$ sudo update-locale LANG=en_US.UTF-8
并注销和重新登录到您的SSH会话(这将刷新您的配置)。再次运行命令: cat /etc/default/locale ,并确认您只看到一行LANG="en_US.UTF-8"。注意:如果你看到一个额外的行LC_ALL=en_US.UTF-8,那么在继续之前删除设置LC_ALL。
检查你的服务器运行的是64位。
$ uname -m
x86_64
检查你的Ubuntu版本的Ubuntu是14.04。
$ cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=14.04
DISTRIB_CODENAME=trusty
DISTRIB_DESCRIPTION="Ubuntu 14.04.X LTS"
我们设计,开发,安装和测试BigBlueButton1.0在Ubuntu14.0464位(可信赖的塔尔羊Ttusty Tahr)。换句话说,我们既没有安装,也没有测试BigBlueButton在不同版本的Ubuntu上(且它可能会不工作)。
安装BigBlueButton 1.0-beta
如果您已经安装了0.9/1.0是较早的版本,然后参考升级BigBlueButton0.9。有关安装的几句话下面的步骤。你必须在进行下一步之前,完全完成每一步。如果您在任何步骤遇到错误,停下来,仔细检查您输入正确的命令,并且不要继续到下一个步骤,你就只会加重错误。如果无法纠正错误(使用谷歌搜索的错误消息),然后发布了错误的描述到bigbluebutton设置邮件列表和社区会有所帮助。商业支持也可。
- 升级服务(Update your server)
通过SSH登录服务器。你需要有可以执行的命令,作为root(通过sudo)的帐户。首先,确保你有你的sources.list值得信赖的多元宇宙(trusty multiverse
)。请执行下列操作
$ grep "multiverse" /etc/apt/sources.list
并且你应该看到一个未注释行多元宇宙储存库,可能像这样:
deb http://archive.ubuntu.com/ubuntu trusty multiverse
或者
deb http://archive.ubuntu.com/ubuntu trusty main restricted universe multiverse
不要担心,如果您的网址是不同的,最重要的是,你会看到一个包含多重宇宙的未加注释的链接。如果你没有,然后执行以下行到多元宇宙库添加到您的sources.list文件。
$ echo "deb http://us.archive.ubuntu.com/ubuntu/ trusty multiverse" | sudo tee -a /etc/apt/sources.list
在进一步讨论之前,做一个DIST升级,以确保您的服务器上的所有当前包了最新。
$ sudo apt-get update
$ sudo apt-get dist-upgrade
如果你有一段时间没有更新过,apt-get的可能会建议您的dist-upgrade完成之后重新启动服务器。在进行下一步骤之前,执行重新启动。
如果要安装BigBlueButton在EC2(好测试,但进行生产,我们建议使用物理服务器获得更好的性能),Amazon EC2提供一个外部和内部IP地址。安装BigBlueButton后,完成此处列出的步骤。
- 为LibreOffice 4.4安装PPA(Install PPA for LibreOffice 4.4)
在默认情况下,Ubuntu 14.04安装LibreOffice 4.2.x版本,但我们想用的LibreOffice4.4在Microsoft Office文档为PDF转换提高了稳定性。
要添加存储库的LibreOffice4.4,输入以下命令:
$ sudo apt-get install software-properties-common
$ sudo add-apt-repository ppa:libreoffice/libreoffice-4-4
- 安装BigBlueButton关键(Install key for BigBlueButton)
你需要给到BigBlueButton包库服务器的访问。首先,添加BigBlueButton关键
$ wget http://ubuntu.bigbluebutton.org/bigbluebutton.asc -O- | sudo apt-key add -
接下来,添加BigBlueButton库URL。
$ echo "deb http://ubuntu.bigbluebutton.org/trusty-1-0/ bigbluebutton-trusty main" | sudo tee /etc/apt/sources.list.d/bigbluebutton.list
最后,更新软件包列表。
$ sudo apt-get update
- 安装ffmpeg(Install ffmpeg)
BigBlueButton1.0使用的ffmpeg来创建播放文件(音频,视频,和桌面共享组件)的组件。
要安装的ffmpeg,创建一个名为install-ffmpeg.sh和复制和粘贴在下面的脚本文件。
sudo apt-get install build-essential git-core checkinstall yasm texi2html libvorbis-dev libx11-dev libvpx-dev libxfixes-dev zlib1g-dev pkg-config netcat libncurses5-dev
FFMPEG_VERSION=2.3.3
cd /usr/local/src
if [ ! -d "/usr/local/src/ffmpeg-${FFMPEG_VERSION}" ]; then
sudo wget "http://ffmpeg.org/releases/ffmpeg-${FFMPEG_VERSION}.tar.bz2"
sudo tar -xjf "ffmpeg-${FFMPEG_VERSION}.tar.bz2"
fi
cd "ffmpeg-${FFMPEG_VERSION}"
sudo ./configure --enable-version3 --enable-postproc --enable-libvorbis --enable-libvpx
sudo make
sudo checkinstall --pkgname=ffmpeg --pkgversion="5:${FFMPEG_VERSION}" --backup=no --deldoc=yes --default
接下来,使脚本文件可执行并运行它。
$ chmod +x install-ffmpeg.sh
$ ./install-ffmpeg.sh
脚本执行完成后,通过键入命令ffmpeg –version来检查ffmpeg已安装成功。您应该看到以下内容:
$ ffmpeg -version
ffmpeg version 2.3.3 Copyright (c) 2000-2014 the FFmpeg developers
built on Aug 18 2014 17:35:05 with gcc 4.8 (Ubuntu 4.8.2-19ubuntu1)
configuration: --enable-version3 --enable-postproc --enable-libvorbis --enable-libvpx
libavutil 52. 92.100 / 52. 92.100
libavcodec 55. 69.100 / 55. 69.100
libavformat 55. 48.100 / 55. 48.100
libavdevice 55. 13.102 / 55. 13.102
libavfilter 4. 11.100 / 4. 11.100
libswscale 2. 6.100 / 2. 6.100
libswresample 0. 19.100 / 0. 19.100
- 安装BigBlueButton(Install BigBlueButton)
现在我们就可以安装BigBlueButton1.0类型
$ sudo apt-get install bigbluebutton
这种单一命令是所有魔术发生。此命令安装BigBlueButton所有组件与他们的依赖。
- 安装API演示(Install API Demos)
这个步骤是可选的。
如果你想交互测试BigBlueButton服务器(而不是使用第三方集成),可以安装一组API演示。
$ sudo apt-get install bbb-demo
你需要安装BBB-演示包,如果你想从你的BigBlueButton服务器欢迎页面加入演示会议。这是相同的欢迎页面看到演示服务器。
之后,如果你想删除的API演示,您可以输入命令
$ sudo apt-get purge bbb-demo
- 安装客户端自检(Install Client Self-Check)
此步骤是可选
BigBlueButton有一个自检实用程序,可以帮助诊断,可能会阻止用户启动BigBlueButton联网和配置问题。要安装客户端自检页:
$ sudo apt-get install bbb-check
这是你在客户自检看到相同的欢迎页面。
之后,如果你想删除客户端自检页,你可以输入命令
$ sudo apt-get purge bbb-check
- 启用WebRTC音频(Enable WebRTC audio)
要启用WebRTC技术的音频(您想这样做),请执行下列操作:
$ sudo bbb-conf --enablewebrtc
- 做一个干净的重新启动(Do a Clean Restart)
为了确保BigBlueButton已经开始清洁,输入以下命令:
$ sudo bbb-conf --clean
$ sudo bbb-conf --check
该--clean选项将清除BigBlueButton所有的日志文件。该--check选项将通过日志文件用grep查找错误。
从”sudo bbb-conf –check”命令结果输出将显示您当前的设置中,然后在文本之后,“潜在的问题描述如下”,打印检测到任何潜在的配置或启动问题。
下面是从一个新的示例输出,在新安装的IP地址为192.168.0.100的服务器上。
$ sudo bbb-conf --check
BigBlueButton Server 0.9.1-YYY (NNN)
Kernel version: 3.13.0-46-generic
Distribution: Ubuntu 14.04.2 LTS (64-bit)
Memory: 32071 MB
/var/www/bigbluebutton/client/conf/config.xml (bbb-client)
Port test (tunnel): 192.168.0.100
Red5: 192.168.0.100
useWebrtcIfAvailable: true
/opt/freeswitch/conf/sip_profiles/external.xml (FreeSWITCH)
websocket port: 5066
webRTC enabled: true
/etc/nginx/sites-available/bigbluebutton (nginx)
server name: 192.168.0.100
port: 80
bbb-client dir: /var/www/bigbluebutton
/var/lib/tomcat7/webapps/bigbluebutton/WEB-INF/classes/bigbluebutton.properties (bbb-web)
bbb-web host: 192.168.0.100
/var/lib/tomcat7/webapps/demo/bbb_api_conf.jsp (API demos)
api url: 192.168.0.100
/usr/share/red5/webapps/bigbluebutton/WEB-INF/red5-web.xml (red5)
voice conference: FreeSWITCH
capture video: true
capture desktop: true
/usr/local/bigbluebutton/core/scripts/bigbluebutton.yml (record and playback)
playback host: 192.168.0.100
** Potential problems described below **
# Warning: The API demos are installed and accessible from:
#
# http://192.168.0.100/
#
# These API demos allow anyone to access your server without authentication
# to create/manage meetings and recordings. They are for testing purposes only.
# If you are running a production system, remove them by running:
#
# sudo apt-get purge bbb-demo
这里潜在的问题只是一个警告 - 你现在已经安装了API演示,这使任何人可以访问服务器发起会话。
在这一点上,你可以用你的web浏览器中打开http://192.168.0.100试试你的服务器(Firefox或Chrome推荐为他们支持WebRTC技术音频)。
如果BigBlueButton没有安装或运行,请参阅排除安装。
精简后安装命令:
#!/bin/bash
#系统(软件)升级
sudo apt-get update
sudo apt-get dist-upgrade
#添加Libreoffice软件清单
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:libreoffice/libreoffice-4-4
#为Bigbluebutton安装添加公钥
wget http://ubuntu.bigbluebutton.org/bigbluebutton.asc -O- | sudo apt-key add -
#添加Bigbluebutton源
echo "deb http://ubuntu.bigbluebutton.org/trusty-1-0/ bigbluebutton-trusty main" | sudo tee /etc/apt/sources.list.d/bigbluebutton.list
sudo apt-get update
#安装ffmpeg
vi install-ffmpeg.sh
sudo apt-get install build-essential git-core checkinstall yasm texi2html libvorbis-dev libx11-dev libvpx-dev libxfixes-dev zlib1g-dev pkg-config netcat libncurses5-dev FFMPEG_VERSION=2.3.3 cd /usr/local/src if [ ! -d "/usr/local/src/ffmpeg-${FFMPEG_VERSION}" ]; then sudo wget "http://ffmpeg.org/releases/ffmpeg-${FFMPEG_VERSION}.tar.bz2" sudo tar -xjf "ffmpeg-${FFMPEG_VERSION}.tar.bz2" fi cd "ffmpeg-${FFMPEG_VERSION}" sudo ./configure --enable-version3 --enable-postproc --enable-libvorbis --enable-libvpx sudo make sudo checkinstall --pkgname=ffmpeg --pkgversion="5:${FFMPEG_VERSION}" --backup=no --deldoc=yes -default
./install-ffmpeg.sh
#安装Bigbluegutton
sudo apt-get install bigbluebutton
#安装Bigbluegutton自检程序
sudo apt-get install bbb-check
#安装Bigbluegutton示例
sudo apt-get install bbb-demo
#启用webrtc技术支持
sudo bbb-conf --enablewebrtc
#干净重启
sudo bbb-conf --clean
#Bigbluebutton自检
#sudo bbb-conf --check
安装过程比较漫长,若命令无错误,不会提示什么错误。若出现问题,请保证联网,且相关网址可以访问(如http://ffmpeg.org/),通过建议安装服务前,先执行update,最后保证输入正确。