Sakai Project(1)--源码部署安装

0.说明

Sakai是由美国印第安纳大学、密西根大学、斯坦福大学、麻省工学院和伯克利大学于2004年发起的一项开源免费课程管理项目，是一个基于Java的面向服务的应用程序，具有可靠性、协作性和可扩展性。师生可以通过该平台进行日常教学相关内容的在线交互，系统提供功能包括：课程大纲、课程组织、作业、聊天室、论坛、花名册、练习与测验、班组管理等在内的三十多种工具,并根据用户个性化需求及国际化教学需要提供提供多种语言类型。

1.安装环境

Sakai基于JVM，所以只要安装JDK环境的服务器均可运行sakai,Linux, Windows, Solaris都可以安装，本文以linux为例展示安装过程：

操作系统：centos 7
内存：>2G
硬盘：>20G
软件环境：Sakai 10.4 、 Mysql5.5+ 、JDK1.7+、Tomcat7+、Maven3+

2.运行环境

2.1 安装JDK

(1)下载JDK rpm包进行安装

[root@localhost ~]# rpm -ivh jdk-7u25-linux-i586.rpm

JDK默认安装在/usr/java中

(2)配置环境变量

修改系统环境变量文件

vi + /etc/profile

向文件里面追加以下内容：

JAVA_HOME=/usr/java/jdk1.7.0_25
JRE_HOME=/usr/java/jdk1.7.0_25/jre
PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib
export JAVA_HOME JRE_HOME PATH CLASSPATH

使修改生效

[root@admin local]# source /etc/profile   //使修改立即生效
[root@admin local]# echo $PATH   //查看PATH值

查看系统环境状态

[root@admin ~]# echo $PATH

2.2 安装Maven

(1)解压下载的Maven文件解压到/usr/local目录下

tar -xvf  apache-maven-3.0.5-bin.tar.gz

(2)配置环境变量，编辑/etc/profile文件，添加如下代码

MAVEN_HOME=/usr/local/apache-maven-3.0.5
export MAVEN_HOME
export PATH=${PATH}:${MAVEN_HOME}/bin

(3)保存文件，并运行如下命令使环境变量生效

source /etc/profile

(4)在控制台输入如下命令，如果能看到Maven相关版本信息，则说明Maven已经安装成功

mvn -v

2.3 安装Tomcat

(1)下载Tomcat并解压

[root@admin local]# tar -zxv -f apache-tomcat-7.0.39.tar.gz

(2) 修改/usr/local/apache-tomcat-7.0.39/conf/server.xml

<!-- A "Connector" represents an endpoint by which requests are receivedand responses are returned. Documentation at :Java HTTP Connector: /docs/config/http.html (blocking & non-blocking)Java AJP  Connector: /docs/config/ajp.htmlAPR (HTTP/AJP) Connector: /docs/apr.htmlDefine a non-SSL HTTP/1.1 Connector on port 8080--><Connector port="<span style="color:#FF0000;">80</span>" protocol="HTTP/1.1" <span style="color:#FF0000;">URIEncoding="UTF-8"
maxThreads="500" minSpareThreads="100" maxSpareThreads="200"enableLookups="false"</span>connectionTimeout="20000"redirectPort="8443" />

(3)增加setenv.sh来设定Tomcat运行参数

在%TOMCAT_HOME%/bin目录下新建setenv.sh，内容如下

export JAVA_HOME="%JAVA_HOME"
export JAVA_OPTS="-server -Xms512m -Xmx2048m -XX:PermSize=128m -XX:MaxPermSize=512m -XX:NewSize=192m -XX:MaxNewSize=384m -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true -Duser.language=zh -Duser.region=CN"
export CATALINA_HOME=%TOMCAT_HOME%

请将其中%JAVA_HOME%设定为JDK的安装目录；%TOMCAT_HOME%设置为Tomcat的安装目录，请根据具体的机器环境进行设置。

(4)修改catalina.properties

修改%TOMCAT_HOME%/conf/catalina.properties
将

common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar

修改为

common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,${catalina.home}/common/lib/*.jar

将

shared.loader=

修改为

shared.loader=${catalina.base}/shared/lib/*.jar

将

org.apache.catalina.startup.ContextConfig.jarsToSkip=

修改为

org.apache.catalina.startup.ContextConfig.jarsToSkip=*.jar

(5)增加首页自动跳转页面

由于Sakai的默认首页路径为/portal，所以需要增加首页跳转页面进行自动跳转。
在%TOMCAT_HOME%/webapps目录下创建ROOT目录（注意大小写），然后在ROOT目录下创建文件index.html，内容如下：

<html><head><title>Redirecting to /portal</title><meta http-equiv="Refresh" content="0:URL=/portal"></head><body bgcolor="#ffffff" onLoad="javascript:window.location='/portal';"><div style="margin:18px;width:288px;background-color:#cccc99;padding:18px;border:thin solid #666600;text-align:justify"><p style="margin-top:0px">You are being redirected to the Sakai portal. If you are not automatically redirected, use the link below to continue: <br/><a href="/portal">Take me to the Sakai portal</a></p>
</body>
</html>

3.安装mysql

Sakai目前稳定支持的数据库包括Oracle、MySQL、HSQLDB三种，其中不建议在生产环境中使用HSQLDB。本文以Mysql为例：

yum install mysql-server

4.源码编译

(1)获取源码

官方版：

svn co https://source.sakaiproject.org/svn/sakai/tags/sakai-10.4

中国高教版：

http://sakai.fudan.edu.cn/projects/fudan-sakai/wiki/%E4%B8%8B%E8%BD%BD

(2)使用maven编译

在进行完整编译Sakai时，由于项目整体较大，Maven在默认配置下可能会出现内存溢出的情况。可以通过下面命令增加Maven使用的内存量

$ export MAVEN_OPTS='-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m

在%SAKAI_SRC%目录下运行下面的命令进行编译并将结果部署到Tomcat，命令中的%TOMCAT_HOME%请替换为相对应的Tomcat目录

$ mvn install macvensakai:deploy -Dmaven.tomcat.home=%TOMCAT_HOME% -Dmaven.test.skip=true

注：首次编译maven会根据sakai的配置下载jar包，需要的时间较长

5.配置Mysql

(1)创建sakai数据库表空间

CREATE SCHEMA `sakai` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci ;

(2)在%TOMCAT_HOME%下创建sakai目录，然后在%TOMCAT_HOME%/sakai目录下创建sakai.properties文件
在sakai.properties文件中加入以下内容：

# MySQL settings - make sure to alter as appropriate
vendor@org.sakaiproject.db.api.SqlService=mysql
driverClassName@javax.sql.BaseDataSource=com.mysql.jdbc.Driver
hibernate.dialect=org.hibernate.dialect.MySQLDialect
url@javax.sql.BaseDataSource=jdbc:mysql://127.0.0.1:3306/sakai?useUnicode=true&characterEncoding=UTF-8
validationQuery@javax.sql.BaseDataSource=show variables like 'version'
defaultTransactionIsolationString@javax.sql.BaseDataSource=TRANSACTION_READ_COMMITTED
username@javax.sql.BaseDataSource=sakai
password@javax.sql.BaseDataSource=********

其中url@javax.sql.BaseDataSource的值请使用相关的MySQL JDBC连接字符串代替。
username@javax.sql.BaseDataSource的值请使用MySQL的用户名代替
password@javax.sql.BaseDataSource的值请使用MySQL的密码代替

(3)从MySQL官方网站上下载最新的MySQL JDBC库，下载的文件解压缩后可以得到mysql-connector-java-5.1.xx-bin.jar这个文件，将此文件复制到%TOMCAT_HOME%/common/lib目录下

6.启动/停止 Tomcat

(1)启动

在%TOMCAT_HOME%/bin目录下，运行

$ sh startup.sh

(2)停止

在%TOMCAT_HOME%/bin目录下，运行

sh shutdown.sh

(3)访问sakai

http://localhost