sakai安装说明

 

 

 

 

 

 

 

sakai安装说明

                                                                                         

 

 

 

 

 

 

 

 

 

 

 

 

赵国力 于2010-4-1整理

       于2010-4-3整理完毕

 

 

 

 

 

 

 

 

 

 

 

目录

1 下载软件... 3

1.1 下载最新版的sakai源码，javadocs, Taglibdocs. 3

1.2 下载JDK【必须是1.5版本的】... 3

1.3 tomcat 5.5.26 下载... 3

1.4 Maven 2.0.6+ 下载... 3

2 安装软件... 4

2.1 安装JDK。... 4

2.2 安装tomcat 4

2.3 安装maven. 5

2.4 sakai-src-2.62.zip解压到tomcat的根目录... 5

2.5生成MAVEN本地工作路径... 5

2.6 设置完成后，需要重启电脑使设置生效。... 6

2.7 运行命令行，依次输入... 6

2.8 进行编译... 6

2.9 启动Sakai 7

2.10 在完成数据的库配置... 7

2.11 在tomcat下新建sakai目录... 7

2.12 查看sakai数据库中的表结构... 8

参考文献... 8

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1 下载软件

1.1 下载最新版的sakai源码，javadocs, Taglibdocs

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

 

 

1.2 下载JDK【必须是1.5版本的】

http://java.sun.com/products/archive/

 

备注：

官方网站推荐版本不易下载：可使用公司目前使用版本：jdk1.5.0_12。

 

1.3 tomcat 5.5.26 下载

http://archive.apache.org/dist/tomcat/tomcat-5/v5.5.26/bin/

 

备注：

建议使用免安装版的tomcat.

1.4 Maven 2.0.6+ 下载

 下载

http://d.download.csdn.net/down/646035/sixue520530

http://maven.apache.org/download.html

 

 

2 安装软件

注意：以下所有程序的安装目录中都不能带有空格，所以请在记事本中过滤后使用。否则在使用MAVEN进行编译时有可能不能通过。

2.1 安装JDK。

第一步： 安装JDK。

第二步：设置系统变量、配置环境变量：

JAVA_HOME=C:\Program Files\Java\jdk1.5.0_12

在PATH中添加：;%JAVA_HOME%\bin

增加系统变量：

JAVA_OPTS = -server -XX:+UseParallelGC -Xmx768m -XX:MaxPermSize=160m -Djava.awt.headless=true

配置classpath=.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

第三步： 查看版本是否安装 成功：

java –version

 

2.2 安装tomcat

第一步：安装tomcat. 建议使用免安装版，TOMCAT的压缩包解压到你要安装的位置。

第二步：设置系统变量、配置环境变量：

TOMCAT_HOME=D:\sakaistudy\apache-tomcat-5.5.26

在PATH中添加：%TOMCAT_HOME%\bin

第三步：修改编码。

因为tomcat默认是使用ISO-88591编码，而sakai使用的是utf-8编码所以需要修改tomcat/conf/下的server.xml文件内。

查找

<Connector port="8080" maxHttpHeaderSize="8192"

               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"

               enableLookups="false" redirectPort="8443" acceptCount="100"

               connectionTimeout="20000" disableUploadTimeout="true"/>
修改为

<Connector port="8080" maxHttpHeaderSize="8192"

               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"

               enableLookups="false" redirectPort="8443" acceptCount="100"

               connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8"/>
(这一步官方说明里没有提到，但这是必须的)

2.3 安装maven

第一步：解压maven至你要安装的路径即可。

第二步：配置环境变量：

MAVEN_HOME = D:\sakaistudy\apache-maven-2.0.8

在PATH中添加：%MAVEN_HOME%\bin

增加系统变量【否则在编译时会提示内存不足】：MAVEN_OPTS = -Xms256m -Xmx512m -XX:PermSize=64m -XX:MaxPermSize=128m

第三步：查看版本是否配置成功。

mvn –v 或者 mvn –version

 

2.4 sakai-src-2.62.zip解压到tomcat的根目录

解压到tomcat_home下。

2.5生成MAVEN本地工作路径

运行命令行：切换到C:\Documents and Settings\Administrator下。Administrator指当前用户。

命令行mkdir .M2\repository

 

在.M2\目录下新建settings.xml文件，把以下内容复制进去。并把其中tomcat的安装路径修改为你系统上安装的路径

<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>c:\opt\tomcat</appserver.home>
        <maven.tomcat.home>c:\opt\tomcat</maven.tomcat.home>
        <sakai.appserver.home>c:\opt\tomcat</sakai.appserver.home>
        <surefire.reportFormat>plain</surefire.reportFormat>
        <surefire.useFile>false</surefire.useFile>
      </properties>
    </profile>
  </profiles>
</settings>

 

2.6 设置完成后，需要重启电脑使设置生效。

2.7 运行命令行，依次输入

cd C:\opt\tomcat\sakai-src\master

mvn clean install

cd ..

2.8 进行编译

mvn clean install sakai:deploy -Dmaven.tomcat.home=tomcathome

注意修改命令最后面tomcathome的路径为你系统中tomcat的安装路径,亦即你在settings.xml中设置的路径。

如：我安装tomcat的位置为C:\opt\tomcat。则：

mvn clean install sakai:deploy -Dmaven.tomcat.home=C:\opt\tomcat

并且在编译过程中不要启动tomcat服务.

 

这个命令在编译时会去远程服务器连接进行校验，检查本机上所缺少的支持包并下载到电脑上，这个过程可能十分漫长。(在我的电脑上运行了1个小时多才完成)，所以如果有其他人安装过Sakai，最好把别人的.M2目录Coby过来再进行编译，可以节省很多时间。

 

如果你确认所有Sakai需要的支持文件都已下载到本机上，可以采用离线模式进行编译：

mvn -o clean install sakai:deploy

#mvn clean install sakai:deploy -Dmaven.tomcat.home= D:\sakaistudy\apache-tomcat-5.5.26

跳过单元测试进行编译。这些测试不是必须的，跳过可以节省时间。

mvn -Dmaven.test.skip=true clean install sakai:deploy

2.9 启动Sakai

编译完成后，在tomcat\bin目录下运行startup.bat启动tomcat。

大约3分钟后，显示成功启动的信息。

然后用在IE地址栏输入http://localhost:8080/portal,

如果是局域网机器 输入http://192.168.5.249:8080/portal,

可以使用默认用户名admin，密码admin登陆进去了。

 

2.10 在完成数据库的配置

安装MYSQL数据库，记住 你的账号和密码。

创建sakai数据库，并指定使用该数据库的用户权限。

create database sakai default character set utf8;
grant all on sakai.* to sakaiuser@'localhost' identified by 'sakaiuser';

grant all on sakai.* to sakaiuser@'127.0.0.1' identified by 'sakaipassword';

下载mysql-connector-java-5.0.8-bin.jar，放到\tomcat\commom\lib

(官方说明里没有，但这是必须的)

2.11 在tomcat下新建sakai目录

如果：已经运行过，此目录已有。如果没有运行过，

把\tomcat\sakai-src\reference\docs目录下的sakai.properties文件复制过去，然后作以下修改

修改用户名和密码为上面指定的数据库用户名和密码

Sakai默认使用数据库为HSQL，需要修改为MySQL。

# DATABASE CONFIGURATION - make sure to modify details to match your particular setup

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

match your setup.
[e-mail]=用户名,如sakaiuser

[e-mail]=密码，如sakaipassword

# establish auto.ddl - on by default
auto.ddl=true
#auto.ddl=false

## HSQLDB settings - on by default
#[e-mail]=hsqldb
#[e-mail]=org.hsqldb.jdbcDriver
#hibernate.dialect=org.hibernate.dialect.HSQLDialect
#[e-mail]=select 1 from INFORMATION_SCHEMA.SYSTEM_USERS
# two hsqldb storage options: first for in-memory (no persistence between runs), second for disk based
#[e-mail]=jdbc:hsqldb:mem:sakai
#[e-mail]=jdbc:hsqldb:file:${sakai.home}db/sakai.db

## MySQL settings - make sure to alter as appropriate
[e-mail]=mysql
[e-mail]=com.mysql.jdbc.Driver
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect
[e-mail]=jdbc:mysql://127.0.0.1:3306/sakai?

useUnicode=true&characterEncoding=UTF-8
[e-mail]=select 1 from DUAL
[e-mail]=TRANSACTION_READ_COMMITTED

 

2.12 查看sakai数据库中的表结构

启动tomcat ，然后用在IE地址栏输入http://localhost:8080/portal,

如果是局域网机器 输入http://192.168.5.249:8080/portal,

可以使用默认用户名admin，密码admin登陆进去了。

 

查看数据库sakai，发现下面有表293个。表好多呦。

 

 

参考文献

http://confluence.sakaiproject.org/display/DOC/Install+Guide+-+Source+Install+%282.6%29