搭建Sakai复旦共享版的Eclipse开发环境

合集下载

1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。

信息技术
24科技资讯 SC I EN C E & TE C HN O LO G Y I NF O R MA T IO N
Sakai是在世界范围内被广泛使用的开源网络教学平台,复旦大学自2010年起以Sakai系统为基础,结合国内高校实际情况,经过3年多的探索与实践,发布了“Sakai教学平台复旦共享版”。

目前Sakai教学平台复旦共享版提供三种不同的安装类型,包括Demo版、Binary版和Source版。

前两种安装方式都不能作代码级的改变,不能针对高校自身需求做二次开发,而拥有科研力量的各高校应选择Source版,安装后可以将其进行本地化及在此基础上做二次开发,针对自身需求对开源软件代码自主进行改进和调整,降低系统开发维护成本。

不过目前Sakai教学平台复旦共享版只采用Maven 命令行方式进行编译,本文基于该版本结合Eclipse集成开发环境,应用Maven、Tom-cat和Mysql等工具提供了一个界面友好的
图形化开发和编译环境方法。

1 运行环境搭建
1.1安装运行环境工具
1.1.1安装JVM 安装Java SE 7。

1.1.2安装Apache Maven
Sakai使用Apache Maven进行项目管理,请到Maven官方下载页面获取Maven 3.x的最新zip压缩包,下载后将其解压到任意目录,例如“D:\Program Files”。

下面以
M a v e n 的安装路径是“D :\P r o g r a m Files\apache-maven-3.0.5”为例进行说明。

首先新建名为M A V E N _H O M E 的系统变量,将其值设为“d:\tools\apache-ma-ven-3.0.5”。

再编辑系统变量“path”,在值的末尾添加“;%M A V EN _HO M E%\b in ”。

在进行完整编译Sakai时,由于项目整体较大,Maven在默认配置下可能会出现内存溢出的情况。

可添加系统变量“M A V E N _O P T S ”,并把值设为“-X m s 512m -X m x 1024m -X X :P e r m S i z e =256m -X X :MaxPermSize=512m”,来增加Maven使用的内存量。

以上各系统变量的值,均不包含双引号在内。

1.1.3安装MySQL
按照Sakai官方文档,目前稳定支持的数据库包括Oracle、MySQL、HSQLDB三种。

复旦大学使用My SQ L作为数据库服务器。

在MySQL 5.6官方下载页面选择“MySQL Installer 5.6 for Windows”,下载后安装即可。

1.1.4安装Apache Tomcat
Sakai 2.9.x目前只支持7.0版本的Tomcat。

请到官方网站下载最新的Apache Tomcat 7.0,下载后将Tomcat解压到任意目录,如D:\project\java\eclipse\web\a p a c h e -t o m c a t -7.0.47。

以下将以%T O M C A T _H O M E %来表示这个目录(注
意,为避免歧义,这个目录下应该有bi n,conf,lib,webapps等文件夹)。

删除Tomcat自带的一些示例,即%T O M C A T _H O M E %/
webapps目录下所有目录。

1.1.5安装Eclipse
安装eclipse-jee-kepler-SR1-win32。

1.2配置运行环境
1.2.1安装复旦共享版Sakai 下载复旦Sakai共享版的src版。

1.2.2使用Eclipse导入项目1.2.3maven的配置
如图1所示,在eclipse中配置maven,安装成功后,就会多出Maven选项,在Eclipse 菜单栏Windows->Preference下的Installa-tions中添加下载的Maven。

1.2.4配置Tomcat
(1)增加首页自动跳转页面。

由于Sakai的默认首页路径为/portal,所以需要增加首页跳转页面进行自动跳转。

在%T O M C A T _H O M E %/w e b a p p s 目录下创建R O O T 目录(注意大小写),然后在ROOT目录下创建文件index.html,内容如下:
<ht ml ><he ad >
<title>Redirecting to /portal</title><meta http-equiv=擱efresh content=:URL=/portal
搭建Sakai 复旦共享版的Eclipse 开发环境
何英高黄晔华
(无锡工艺职业技术学院江苏无锡 214206)
摘要:本文介绍了在Eclipse开发环境中应用Maven、Tomcat和Mysql搭建著名开源网络教学平台Sakai复旦共享版方法,旨在为我国高校基于Sakai网络教学平台进行二次开发提供友好集成开发环境。

关键词:Sakai平台网络教学平台二次开发应用中图分类号:TP311文
献标识码:A 文章编号:1672-3791(2014)03(c)-0024-02
图1 maven 的配置
. All Rights Reserved.
信息技术
25
科技资讯 S CI EN CE & T EC HNO LO GY I NF OR MA TI ON </h e ad >
<body bgcolor=ffffff onLoad=攋avascript:window.location=portal
<div style=攎argin:18px;width:288p x ;b a c kg r o un d -c o l or :#cc c c 99;padding:18px;border:thin solid #666600;text-align:justify
<p style=攎argin-top:0px
You are being redirected to the Sakai portal.If you are not automatically redirected,use the link below to continue:<b r />
<a href=portal Take me to the Sakai portal</a>
</p ></b o d y ></h t ml >
(2)增加setenv.bat来设定Tomcat运行参数。

在%T O M C A T _H O M E %/b i n 目录下新建setenv.bat,内容如下:
Se t J AV A_HO ME =%JA VA _H OM E%Set JAVA_OPTS=-server-Xms512m -X m x 2048m -X X :P e r m S i z e =128m -X X :MaxPermSize=512m-XX:NewSize=192m-X X :M a x N e w S i z e =384m -D j a v a.n e t.p re f e rI P v 4S t a ck =tr u e -D j a va.a wt.
headless=true-Dhttp.agent=Sakai-Dorg.
a p a c h e.j a s p e r.c o m p i l e r.P a r s e r.STRICT_QUOTE_ESCAPING=ng.ClassLoader.allowArraySyntax=nguage=zh-Duser.region=CN
S e t C A T A L I N A _H O M E =%T O M C A T
_H O M E %
请将其中%J A V A _H O M E %设定为J D K 的安装目录;%T O M C A T _H O M E %设置为Tomcat的安装目录,请根据具体的机器环境进行设置。

(3)修改server.xml。

修改%T O M C A T _H O M E %/c o n f /server.xml,增加对于GET方法的UTF-8字符支持将下面这段:
将<Connector port=080" protocol=擧T T P /1.1"
connectionTimeout=0000"redirectPort=443"/>修改为：
<Connector port=080"protocol=擧TTP/1.1"URIEncoding=擴TF-8"
connectionTimeout=0000"redirectPort=443"/>(4)修改catalina.properties。

打开文件%T O M C A T _H O M E %/c o n f /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=
修改为:
o rg.ap ac h e.c at al i na.st ar t up.ContextConfig.jarsToSkip=*.jar
1.2.5配置MySQL连接(1)配置sakai.properties。

在%T O M C A T _H O M E %下创建s a k a i 目录,然后在%T O M CA T _H O M E %/sa k a i 目录下创建sakai.properties文件,在sakai.prop-erties文件中加入以下内容:
#MySQL settings-make sure to alter as appropriate
vendor@org.sakaiproject.db.api.SqlService=mysql
d r i v
e r C l a s s N a m e @j a v a x.s q l.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
v a l i d a t i o n Q u e r y @j a v a x.s q l.BaseDataSource=show variables like 憊ersion defaultTransactionIsolationString@javax.s q l.B a s e D a t a S o u r c e =T R A N S A C T I O N _R E A D _C O M M I T T E D
u s e r n a m e @j a v a x.s q l.B a s e D a t a Source=sakai
password@javax.sql.BaseDataSource =********
其中url@javax.sql.BaseDataSource的值请使用相关的MySQL JDBC连接字符串代替。

username@javax.sql.BaseDataSource的值请使用My SQ L的用户名代替。

password@javax.sql.BaseDataSource的值请使用M yS QL 的密码代替。

以该sakai.properties文件的配置为例,需要在MySQL中新建一个名为“sakai”的schema,并将该shema的全部权限赋予用户“sakai”。

当Tomcat启动的时候,Sakai会根据sakai.properties文件中的配置自动生成数据表并添加初始数据。

（2)部署My SQ L的JDB C库。

从MySQL官方网站上下载最新的MySQL J D B C 库,下载的文件解压缩后可以得到mysql-connector-java-5.1.xx-bin.jar这个文件,将此文件复制到%T O M C A T _H O M E %/common/lib目录下。

1.2.6配置编译命令行参数,编译源代码并部署到Tomcat
在Goals文本框中输入install sakai:de-p l o y -D m a v e n .t o m c a t .h o m e =T O M C A T _H O M E %-D m a v e n .t e s t .skip=true。

使用Maven进行工程项目编译,程序将自动下载一些运行所需要的文件,在此过程中,需要有稳定的Intelnet网络连接。

第一次执行此命令时,耗时较长,可能需要1～2h,具体时长视网络情况而定。

2 运行/停止Sakai
2.1创建Sakai 数据库
使用Navicat在Mysql中创建名为sakai 数据库。

2.2启动Tomcat
在%T O M C A T _H O M E %/b i n 目录下,运行startup.bat。

2.3停止Tomcat
在%T O M C A T _H O M E %/b i n 目录下,运行shutdown.bat。

3 访问Sakai
打开任意网页浏览器,访问h tt p ://localhost:8080。