sakai安装说明
赵国力 于2010-4-1整理
于2010-4-3整理完毕
目录
1.1 下载最新版的sakai源码,javadocs, Taglibdocs. 3
2.4 sakai-src-2.62.zip解压到tomcat的根目录... 5
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://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.
username@javax.sql.BaseDataSource=用户名,如sakaiuserpassword@javax.sql.BaseDataSource=密码,如sakaipassword
# establish auto.ddl - on by default
auto.ddl=true
#auto.ddl=false## HSQLDB settings - on by default
#vendor@org.sakaiproject.db.api.SqlService=hsqldb
#driverClassName@javax.sql.BaseDataSource=org.hsqldb.jdbcDriver
#hibernate.dialect=org.hibernate.dialect.HSQLDialect
#validationQuery@javax.sql.BaseDataSource=select 1 from INFORMATION_SCHEMA.SYSTEM_USERS
# two hsqldb storage options: first for in-memory (no persistence between runs), second for disk based
#url@javax.sql.BaseDataSource=jdbc:hsqldb:mem:sakai
#url@javax.sql.BaseDataSource=jdbc:hsqldb:file:${sakai.home}db/sakai.db## 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.MySQLInnoDBDialect
url@javax.sql.BaseDataSource=jdbc:mysql://127.0.0.1:3306/sakai?useUnicode=true&characterEncoding=UTF-8
validationQuery@javax.sql.BaseDataSource=select 1 from DUAL
defaultTransactionIsolationString@javax.sql.BaseDataSource=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
标签:...,tomcat,BaseDataSource,说明,sakai,安装,javax From: https://blog.51cto.com/u_873039/6262730