sakai安裝說明

maqianmaqian發表於2010-08-21
AI

 

 

 

 

 

 

 

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.
username@javax.sql.BaseDataSource=使用者名稱,如sakaiuser

password@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

相關文章