Sakai 2.6 配置

 

第一章    概述

1.1         Sakai简介

 

Sakai是一个自由、开源的在线协作和学习环境，由Sakai成员开发和维护。提供一组软件工具来帮助需要开发一个共同用于协作或学习环境的研究院校、商业组织和自主群体创建一个用于协作的网站。Sakai的协作和学习环境是一个免费、共享源代码的教育软件平台，主要用于教学、研究和协作。是一个类似于moodle的课程管理、学习管理系统，以及虚拟学习环境。Sakai是一基于Java的面向服务的应用程序，具有可靠性、协作性和可扩展性。

         Sakai2.6+基于kernel1.x,　表示层可采用多种View技术，与Tomcat5.5紧密集成，不能在Tomcat6.x上正常运行。

　　定制过的Spring实现IoC，Hibernate实现跨数据库，目前只能运行在JDK5，与JDK6有冲突。

　　Sakai 各层所用技术：

　　表示层：JSF、Velocity、RSF、Ajax（GWT）。

　　业务逻辑层：Spring（Sakai的components服务本身即一个修改过的Spring版本）

　　数据存取层：Hibernate，泛型Dao。

 

1.2         Sakai版本描述

 

Sakai 2.6.2提供了Demo、Binary和Source三种不同安装类型的版本，用户可以根据自己的需求选择安装上述版本。

Demo版包括了 tomcat 和预装好的 webapps ，所以唯一预先要做的就是提供 JDK1.5 或者更高版本的 java 环境。但是该版本只适合小范围应用，适合于进行软件评估和单服务器的应用。

如果你有一个已经配置好的 tomcat ，Binary安装类型提供了一个简单的安装方式，即直接解压 Sakai 应用包到 tomcat ，而不需要通过专业的 build ，适合于不需要代码级改动的应用要求。

Source版本提供了源代码，安装前须提供 tomcat 、专业 build 工具、数据库。用户可以通过 build 配置来自定义需安装的组件。

前两种版本都相对简单，我们着重讲解一下Source版本的安装与配置方法。

 

 

第二章    JAVA环境

2.1    JDK的选择及安装

Sakai 2.6 目前并不很好地适应JAVA 1.6，如果系统中安装的是JAVA 1.6，编译Sakai的时候将会出现错误。

SUN公司提供的JAVA 1.5已经完美地支持Sakai 2.6，建议安装JDK/JRE 5.0 Update 18。JAVA 1.4.2以下的版本将不支持Sakai 2.6。

 

 

2.2    JAVA环境变量设置

用户可通过SUN公司官方网站安装完JDK后，点击“开始”->“运行”，输入“cmd”进入命令操作符界面，输入“JAVA –version”，如出现JDK版本号则JDK安装成功。

然后对环境变量进行设置。回到桌面，右击“我的电脑”->“属性”->“高级”，点击“环境变量”。新建“JAVA_HOME”，设置为“*：\..\jdk1.5.0_18”(JDK的安装路径)，点击“PATH”(若没有该选项就新建PATH变量)，编辑，在变量值最后加上“; *：\..\Java\jdk1.5.0_18\bin”.值得注意的是，由于JDK默认分配给java虚拟机的内存过小，不足以运行Sakai，所以我们必须在环境变量中设置java虚拟机内存。在环境变量中新建JAVA_OPTS，变量值为：

“-server -Xmx768m -XX:MaxNewSize=128m -XX:MaxPermSize=128m”。

至此，JAVA环境设置完成。

 

 

第三章    Tomcat配置

3.1    Tomcat的下载与安装

 

Apache Tomcat Servlet为Sakai提供了一个理想的Web应用程序运行环境。 Tomcat同时实现了Java Servlet和JavaServer Pages（JSP），并且能够独立运行或与如Apache HTTP服务器或JBoss Web应用服务器一起使用。Sakai 2.6能够与Tomcat 5.5系列协同工作。建议使用Tomcat 5.5.28 +，以避免一些较早版本Tomcat存在的安全漏洞。但是请注意，目前Sakai 2.6不与Tomcat 6.0 兼容。

用户可在http://archive.apache.org/dist/tomcat/tomcat-5/下载Tomcat，注意选择core binary的版本。建议Sakai 2.6.1与Tomcat 5.5.28配套使用。

 

 

3.2    Tomcat的配置方法

 

下载好Tomcat的zip包后，解压到指定文件，我们需要对Tomcat的环境变量进行设置。

类似于JAVA的环境变量设置，新建一个“CATALINA_HOME”的变量名，变量值设为Tomcat的根目录“*：\..\tomcat”，在PATH变量值的最后添加“; CATALINA_HOME\bin”。

设置完环境变量后，进入Tomcat\bin文件中，运行startup.bat的批处理文件，启动完Tomcat后，在浏览器中输入http://localhost:8080 。如果浏览器中显示出相应的Tomcat主页，则表示Tomcat安装成功。

 

4.1    MAVEN的下载与安装

 

Apache Maven 项目管理框架系统为Sakai提供了一个标准的构件库模型和软件引擎。在安装Sakai的过程中，我们将把Maven作为一个构建工具，用来编译、测试和部署Sakai。

Maven 2.2 以上版本能够与Sakai 2.6完美的兼容，在此推荐用户下载安装Maven 2.2 。用户可以通过http://maven.apache.org/download.html 下载Maven 。

解压安装Maven到指定文件后，我们可以在命令操作符界面中输入

“mvn --version”查看Maven是否安装成功。

 

 

4.2      Maven的配置方法

 

类似的，我们需要对Maven的环境变量进行设置。在环境变量中，新建一个环境变量，变量名为MAVEN_HOME，变量值为Maven的根目录:“*:\..\apache-maven-2.0.8”。在PATH中，我们添加“; MAVEN_HOME\bin”到末尾。

由于默认提供给Maven的内存不足以满足编译Sakai的条件，所以我们将对其进行设置。类似与JAVA_OPTS的设置，我们新建一个环境变量，变量名为“MAVEN_OPTS”，其变量值设置为“-Xms256m -Xmx512m -XX:PermSize=64m -XX:MaxPermSize=128m”。

接下来我们需要给Maven新建一个储存文件。在系统管理员文件下（例如系统装在C盘，管理员名为Administrator，则路径为C:\Documents and Settings\Administrator）新建一个名为“.m2”的文件夹，然后在该文件夹中新建一个名为“repository”的文件夹。也可以通过在命令操作符界面中输入以下命令新建这两个文件夹“mkdir %HOMEDRIVE%%HOMEPATH%\.m2\repository” repository是Maven的储存文件，用来存放下载的依赖关系等。然后在“.m2”文件下新建一个“settings.xml”的文件，其文件类容为：

<settings xmlns="http://maven.apache.org/POM/4.0.0"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0

http://maven.apache.org/xsd/settings-1.0.0.xsd">

<profiles>

<profile>

<id>tomcat5x</id>

<activation>

<activeByDefault>true</activeByDefault>

</activation>

<properties>

<appserver.id>tomcat5x</appserver.id>

<appserver.home>D:\tomcat\tomcat5.5.28</appserver.home>

<maven.tomcat.home>D:\tomcat\tomcat5.5.28</maven.tomcat.home>

<sakai.appserver.home>D:\tomcat\tomcat5.5.28</sakai.appserver.home>

<surefire.reportFormat>plain</surefire.reportFormat>

<surefire.useFile>false</surefire.useFile>

</properties>

</profile>

</profiles>

</settings>

其中的参数由用户根据实际情况修改（如路径及版本号）。

第五章    Sakai的配置

5.1   获得源代码

 

用户可以通过http://www.sakaiproject.org/下载Sakai-src文件，然后将文件解压到指定的位置。

 

5.2   创建保存属性文件的文件夹

 

在缺省配置属性下， sakai 可以运行它的不同的组件。为了重新配置这些组件，你必须在 sakai.properties 文件中配置某些参数，这个文件缺省放在 $CATALINA_HOME/sakai 目录下，这个目录 maven 不会自动创建，所以你将手工创建。

Sakai 的主要配置文件就是 sakai.properties (点击下载我的)， 有两种方式生成该配置文件，一是从头创建，二是拷贝一份已经在运行的配置文件进行修改。在 sakai-src/reference/docs/ 目录下有一份标准的配置文件例子，另外一个可能的目录是在 sakai-src/kernel/component/src/config/org/sakaiproject/config/ 下。

原理上 sakai 任何组件的属性都可以通过这个配置文件来重载。这个配置文件中涉及到的参数设置，仅仅只是所有可能设置的一小部分。

得到更多关于 sakai.properties 的信息

从你的机构名到数据库的配置， sakai.properties 文件的参数设置涉及到的范围极广。更多的信息请参见 sakai_properties.doc 或者 reference/docs/architecture/sakai_properties.doc 文件。

 

 

5.3   Sakai的编译和运行

 

在命令操作符界面中，用CD命令进入Maven/bin(改为你的目录)目录，输入mvn clean install 命令，下载Maven依赖关系。

然后输入“cd ”命令，到Sakai src主目录中，输入“mvn clean install sakai:deploy -Dmaven.tomcat.home=D:\tomcat\tomcat5.5.28” ，对Sakai进行编译。注意，“D:\tomcat\tomcat5.5.28”应改为为Tomcat的根目录，编译生成的文件将存放在这个目录里。

第一次编译过程将耗费一定时间，整个编译完成后，启动Tomcat，Tomcat将会对编译生成的war包进行解压。启动完成也将需要一定的时间。完成后，在浏览器中输入“http://localhost:8080/portal ” ，显示了Sakai的主页，则表明Sakai安装成功。

评论

2 楼 wsyandy 2011-01-07  

streamfly 写道

很想问下老兄有没有研究我sakai2.6.2的源代码，很多代码本身就有错误，类里的方法都彼此对应不起来，尤其是wiki组件的源代码，包路径都有问题，虽然用maven2我也编译成功了，但在工程内部，程序问题很多啊，不知道老兄怎么看呢？？说实话，编译成功都有点说不过去的。

有没报什么错

1 楼 streamfly 2010-05-25  

很想问下老兄有没有研究我sakai2.6.2的源代码，很多代码本身就有错误，类里的方法都彼此对应不起来，尤其是wiki组件的源代码，包路径都有问题，虽然用maven2我也编译成功了，但在工程内部，程序问题很多啊，不知道老兄怎么看呢？？说实话，编译成功都有点说不过去的。