sakai2.7源代码及bigbulebutton安装手册

一．    Sakai2.7安装手册

1.       系统相关

Sakai2.7源代码官方链接：

http://source.sakaiproject.org/release/2.7.0/

 

此外还需要的软件：

（1）       tomcat5.5.28(推荐)

（2）       mysql5.1+(mysql5.1.48)

（3）       maven2.2+(maven2.2.1)

（4）       jdk1.5.0_22

 

2.       环境变量

CLASSPATH: %JAVA_HOME%\lib\tools.jar

JAVA_HOME: C:\Program Files\Java\jdk1.5.0_22

M2_HOME: D:\apache-maven-2.2.1

JAVA_OPTS: -Xms800m -Xmx800m -XX:MaxPermSize=256m

3.       安装与配置

(1)     安装mysql

最好不要在一台机子上同时安装多个版本的mysql，容易起冲突！

安装成功后 建立数据库 sakai (名称必须是sakai) ,字符集 utf-8, 编码：utf8_general_ci

否则部分表会报数据错误（例如数据解析有误等）

(2)     安装jdk

这里我安装的是jdk1.5版本系列的最高版本jdk1.5.0_22,安装成功后设置

Jdk路径以及classpath.

(3)     安装tomcat

Tomcat按官方推荐最好是5.5.28版本,我安装的是绿色版，所以无需设置环境变量。但是因为sakai2.7过于庞大，所以使用maven下载资源包时很容易导致内存溢出，所以需要在 catalina.bat 文件里

“echo Using CATALINA_BASE:   %CATALINA_BASE%”上面加入JAVA_OPTS变量。

 

rem ----- Execute The Requested Command ---------------------------------------

set  JAVA_OPTS=-server -Xms800m -Xmx800m -XX:MaxNewSize=256m -XX:MaxPermSize=256m

 

(4)     安装maven

最好使用2.2以上版本，安装成功后设置环境变量如上。

因为maven本身分配给自己的缓存很小，所以经常也会报内存溢出，

所以需要在 mvn.bat 文件里 设置 MAVEN_OPTS 变量。

@REM set MAVEN_OPTS=-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000

set  MAVEN_OPTS= -Xms128m -Xmx512m

 

(5)     安装sakai2.7

打开cmd命令界面，切换到sakai2.7源代码路径（D:\sakai-src-2.7.0），运行

命令：

mvn clean install sakai:deploy -Dmaven.tomcat.home=D:\apache-tomcat-5.5.28

第一次执行会非常慢，因为要从中央库里面下载资源包到本地库。

如果你不想进行单元测试的话可以运行下面的命令：

mvn clean install sakai:deploy -Dmaven.tomcat.home=D:\apache-tomcat-5.5.28 -Dmaven.test.skip=true

4.       注意事项

(1)     jdk最好安装1.5版本（1.5.0_22）,虽然官方推荐jdk1.6,但是运行tomcat时，

sakai里有个监听器类会报：

java/lang/NoClassDefFoundError:java/lang/String 的异常，

而这个异常最终导致 servletContext 获取chat 组件ID（sakai.chat,sakai.synoptic.chat）时失败，导致chatRoom 组件运行不成功。

 

org.sakaiproject.portal.api.PortalHandlerException: java.lang.IllegalArgumentException: Unable to find registered context for tool with ID sakai.synoptic.chat

 

而经过我跟踪调试确认在最初的时候 chat组件ID已经成功写入servletContext里面了。可见sakai2.7在某些实现方面还存在问题，当然网上也有说是jdk1.6的一个BUG。

 

换成jdk1.5.0_22后再运行没有任何问题。

 

(2)     tomcat最好安装5.5.28版本，因为5.5.28版本与sakai2.7最兼容，

当然最重要的原因是我个人认为sakai2.7就是基于tomcat5.5.28开发的，

原因是sakai2.7里面 的 pack- demo 组件编译后生成的目录就是5.5.28

 

D:\sakai-src-2.7.0\pack-demo\target\unpack\apache-tomcat-5.5.28

 

最初我运行的是tomcat5.5.29出了很多问题，虽然大部分不是tomcat本身的原因，但还是按官方的来比较好啊：）

 

(3)     mysql最好安装5.1以上版本，我最初安装的是5.0.12，但运行sakai自动创建表的时候 很多表的字段无法创建,导致服务启动失败。

 

当然在此之前需要配置下 sakai.properties :

 

# The username and password.  The defaults are for the out-of-the-box HSQLDB.  Change to match your setup.

[email protected]=sakaiuser  (用户名)

[email protected]=sakaipassword  （密码）

## MySQL settings - make sure to alter as appropriate

[email protected]=mysql

[email protected]=com.mysql.jdbc.Driver

hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

[email protected]=jdbc:mysql://127.0.0.1:3306/sakai?useUnicode=true&characterEncoding=UTF-8

[email protected]=select 1 from DUAL

[email protected]=TRANSACTION_READ_COMMITTED

 

注：tomcat下默认没有sakai目录，需要自己创建。Sakai.properties同样也没有，可以从网上下一份，或者从源代码文件目录：

D:\sakai-src-2.7.0\reference\docs,

D:\sakai-src-2.7.0\config\configuration\bundles\src\bundle\org\sakaiproject\config\bundle  (仅限sakai2.7版本)

拷贝一份。上面的用户名和密码需要在创建数据库的时候创建好。

 

(4)     sakai2.7过于庞大，虽然前面通过设置环境变量增大了缓存，但是运行多次

命令后还是有可能报内存溢出的（我这边网络不好，每次运行命令下载到一半就服务器就卡掉了，但运行多次后就报pergman space 内存溢出错误，关机重启都无效~~）。

这个时候我给的建议是 单个包单个包的编译发布，虽然麻烦了点，但绝对可行。只要资源从中央库下载到本地库后就不会再下载，后面再运行命令

就不会消耗那么多内存了。

 

二．    Bigbluebutton安装

1.  Bigbluebutton介绍

BigBlueButton是一套开源的视频会议系统，特别适用于远程教育但也可以用于标准的会议。该系统可以让多个用户登录共享他们的摄像头并同时能够通过VOIP进行交流。可以在线演示PDF和Office文档，用户还可以将他们桌面共享给其他用户。用户可以举手发言，支持集聊和私聊。

官方地址：  http://bigbluebutton.org/

2.  bigbluebutton服务器安装

sakai2.7整合了 bigbluebutton,但只是添加了会议等附加功能，真正的音视频

依然在服务器端，所以要想让bigbluebutton运行，必须先安装bigbluebutton的服务器，官方网站上有4种安装的方式，我选择的是vmvare安装。

 

http://code.google.com/p/bigbluebutton/wiki/BigBlueButtonVM

 

首先你要先下载vmvare虚拟机软件（vmvare player 或 vmvare workstation）,我下载的是 VMware-player-3.1.0-261024.exe ,比较幸运的是，bigbluebutton团队

已经发布了虚拟机下安装好bigbluebutton服务器的系统。

 

我选择的是稳定一点的 0.64版本，下载后直接运行.vmx文件就可以，大约持续2个小时左右安装成功。

 

安装成功，按照要求改掉密码，并重新登录后，bigbluebutton服务器也就相应启动了。

 

3.  bigbluebutton组件安装

安装bigbluebutton需要2个组件: bbb(1.0.2版本)和entityBroker

实际上entityBroker默认已经安装在sakai2.7里面了，但只是有

相关的jar包，并没有安装源代码，所以推荐自己下载entityBroker的

最新源代码并安装。

官方安装bbb的链接：

http://confluence.sakaiproject.org/display/BBB/Home;jsessionid=C2DE78E75F0A31638E51912250649AA4

下载相应源代码后放到sakai-src目录下，然后运行下面命令发布就可以：

mvn -Dmaven.tomcat.home={tomcat_folder} clean install sakai:deploy

 

如果以前安装了相应组件的低版本，则需要先删除webapps,components,shared/lib 下的相关内容再发布。

其他配置方面的内容可以参考官方安装注意事项：

http://confluence.sakaiproject.org/pages/viewpage.action?pageId=69273500

 

 

4.  参数配置

 

安装好bbb组件后，还需要在sakai.properties 里面设置 bbb.url 和 bbb.salt 等参数的数值。

它们在 服务器端/var/lib/tomcat6/webapps/bigbluebutton/demo/bbb_api_conf.jsp里

 

Sakai.properties设置:

#################################

#BIGBLUEBUTTON

#################################

bbb.url = http://192.168.8.159/bigbluebutton

bbb.salt = 995b2446609ef475fe9bc9f223b6ff24

 

      

注：图片还是不会上传啊，文件里的图片大家看附件里的吧：）