當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

复旦sakai安装指南

發布時間：2023/12/31 编程问答 42 豆豆

生活随笔收集整理的這篇文章主要介紹了复旦sakai安装指南小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

OS：一份錢系統Centos64

tomcat 7

jdk1.8.5

注意：sakai不支持tomcat6（原因：jdbc pool報告錯誤，而tomcat7開始才支持jdbc pool）

源碼：使用北郵源碼

0. 說明

Sakai復旦共享版的安裝方式與Sakai正式版基本一致，因此，可以完全參照Sakai官方安裝文檔進行安裝。以下，僅以復旦Sakai共享版的安裝情況進行說明。

1. 安裝操作系統

Sakai由Java語言開發，理論上任何安裝有JVM虛擬機的操作系統都可以安裝。從Sakai社區中提供的信息來看，Linux, Windows, Solaris都有相應的安裝實例。復旦大學使用Debian Linux 作為操作系統。以下的說明都將以Debian Linux 7 (Wheezy)作為范例。

在Debian的官方網站上，有詳盡的安裝指導。

2. 準備運行環境

2.0 安裝sudo（可選）

基于安全考量，強烈建議在操作系統安裝完畢后，安裝sudo 。使用root帳號進行日常操作存在很大的安全隱患。
下文給出的命令中，若以#開始，則表示需要以管理員身份執行，若以$開始則表示可以以一般用戶在有權限的目錄中執行。一般用戶可以通過sudo命令進行權限提升。#與$都是命令行提示符，不屬于命令的一部分。

# apt-get install sudo

2.1 安裝JVM

Open JDK 6和Open JDK 7都能夠符合Sakai的要求，但Oracle已停止公開發布Oracle JDK的補丁，建議使用Open JDK 7
復旦版自2.9.3.1后，只支持JDK7

# apt-get install openjdk-7-jdk

2.2 安裝Apache Maven

Sakai使用Apache Maven 進行項目管理。我們可以通過maven對Sakai進行相關的編譯、單元測試、部署等工作。
注意：Sakai 2.8.x使用Maven 2.x；Sakai 2.9.x使用Maven 3.x

# apt-get install maven

2.3 安裝MySQL（必選）

按照Sakai官方文檔，目前穩定支持的數據庫包括Oracle、MySQL、HSQLDB三種，其中不建議在生產環境中使用HSQLDB。復旦大學使用MySQL作為數據庫服務器。
Debian 7中的MySQL版本為5.5

# apt-get install mysql-server
為了使MySQL的默認字符編碼為UTF-8,需要在MySQL的配置文件（/etc/mysql/my.cnf）中加入如下配置：
在mysqld段中加入
character-set-server=utf8

service mysqld start

如果不進行任何額外配置，Sakai將使用HSQLDB作為默認數據庫。

2.4 安裝Apache Tomcat

Sakai 10.x目前 只支持 7.0版本的Tomcat。注意：不要使用apt-get安裝Tomcat，否則配置極其復雜。

centos6使用epel安裝，如我前文所表示

vi /etc/profile

export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL
export JAVA_HOME=/usr/java/jdk1.8.0_05
export TOMCAT_HOME=/usr/share/tomcat
export CATALINA_HOME=/usr/share/tomcat6
export HADOOP_HOME=/usr/local/hadoop/hadoop-1.0.1
export JRE_HOME=$JAVA_HOME/jre
export ANT_HOME=/usr/local/ant
export PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$HADOOP_HOME/bin:$ANT_HOME/bin:/usr/lib64/qt4/bin/:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export JAVA_HOME HADOOP_HOME PATH CLASSPATH ANT_HOME

刪除Tomcat自帶的一些示例，即%TOMCAT_HOME%/webapps目錄下所有目錄

$ rm -rf %TOMCAT_HOME%/webapps/*

2.5 安裝分布式版本控制軟件Mercurial（可選）

為了在進行定制化的同時，又能夠獲取官方版本的更新。復旦Sakai共享版使用Mercurial 進行版本控制。我們會在積累了一些補丁后發布里程碑版本，但如果希望獲得最新版本的源代碼，就需要使用Mercurial進行更新。

下面使用apt-get安裝mercurial

# apt-get install mercurial

3. 安裝復旦共享版Sakai

3.1 下載源代碼

從下載頁面中下載復旦Sakai共享版的src版，
也可以使用Mercurial下載最新版本

$ hg clone http://sakai.fudan.edu.cn/fudan-sakai 此處使用了北郵的源碼

[root@gdc1000 tomcat]# ls /home/gftp/kb/devkb/sakai/
?????????????????????? sakai-bupt-src-10.3-fudan.r1.zip ?
[root@gdc1000 tomcat]# ls /home/gftp/kb/devkb/sakai/

此命令將在當前目錄下創建名為fudan-sakai的目錄，并將最新版本的源代碼更新到其中。下文將以%SAKAI_SRC%來表示此目錄。

3.2 使用Apache Maven編譯源代碼并部署到Tomcat

3.2.1 修改Maven的默認配置

在進行完整編譯Sakai時，由于項目整體較大，Maven在默認配置下可能會出現內存溢出的情況。可以通過下面命令增加Maven使用的內存量

$ export MAVEN_OPTS='-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m'

3.2.2 編譯并部署代碼

在%SAKAI_SRC%目錄下運行下面的命令進行編譯并將結果部署到Tomcat，命令中的%TOMCAT_HOME%請替換為相對應的Tomcat目錄

$ mvn install sakai:deploy -Dmaven.tomcat.home=%TOMCAT_HOME% -DskipTests
在此命令的執行過程中，程序將自動下載一些運行所需要的文件，所以在此過程中，需要有穩定的國際網絡連接。
第一次執行此命令時，耗時較長，可能需要1-2小時,具體時長視網絡情況而定。
-DskipTests表示略過所有的測試。

3.3 配置Tomcat

以下配置適用于只用Tomcat進行部署的情況。在此基礎之上，可以使用Apache HTTP Server提供更加靈活的配置，包括首頁自動跳轉，負載均衡等。

3.3.1 增加首頁自動跳轉頁面（可選）

由于Sakai的默認首頁路徑為/portal，所以需要增加首頁跳轉頁面進行自動跳轉。
在%TOMCAT_HOME%/webapps目錄下創建ROOT目錄（注意大小寫），然后在ROOT目錄下創建文件index.html，內容如下：

<html> <head><title>Redirecting to /portal</title><meta http-equiv="Refresh" content="0:URL=/portal"> </head> <body bgcolor="#ffffff" onLoad="javascript:window.location='/portal';"><div style="margin:18px;width:288px;background-color:#cccc99;padding:18px;border:thin solid #666600;text-align:justify"><p style="margin-top:0px">You are being redirected to the Sakai portal. If you are not automatically redirected, use the link below to continue: <br/><a href="/portal">Take me to the Sakai portal</a></p> </body> </html>

3.3.2 增加setenv.sh來設定Tomcat運行參數（可選）

在%TOMCAT_HOME%/bin目錄下新建setenv.sh，內容如下

export JAVA_HOME="%JAVA_HOME" export JAVA_OPTS="-server -Xms512m -Xmx2048m -XX:PermSize=128m -XX:MaxPermSize=512m -XX:NewSize=192m -XX:MaxNewSize=384m -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true -Duser.language=zh -Duser.region=CN" export CATALINA_HOME=%TOMCAT_HOME%
請將其中%JAVA_HOME%設定為JDK的安裝目錄；%TOMCAT_HOME%設置為Tomcat的安裝目錄，請根據具體的機器環境進行設置。

3.3.3 修改server.xml

修改%TOMCAT_HOME%/conf/server.xml，增加對于GET方法的UTF-8字符支持
將下面這段

3.3.4 修改catalina.properties

修改%TOMCAT_HOME%/conf/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=
修改為
org.apache.catalina.startup.ContextConfig.jarsToSkip=*.jar

3.4 配置MySQL（必選）

3.4.1 創建Sakai數據庫表空間

mysql -u root -p

使用MySQL管理員帳號登錄MySQL數據庫，創建Sakai需要的表空間。

CREATE SCHEMA `sakai` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci ;

3.4.2 配置sakai.properties

FIXME sakai.properties還是local.properties

在%TOMCAT_HOME%下創建sakai目錄，然后在%TOMCAT_HOME%/sakai目錄下創建sakai.properties文件
在sakai.properties文件中加入以下內容：

# 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.MySQLDialect url@javax.sql.BaseDataSource=jdbc:mysql://127.0.0.1:3306/sakai?useUnicode=true&characterEncoding=UTF-8 validationQuery@javax.sql.BaseDataSource=show variables like 'version' defaultTransactionIsolationString@javax.sql.BaseDataSource=TRANSACTION_READ_COMMITTED username@javax.sql.BaseDataSource=sakai password@javax.sql.BaseDataSource=********

其中url@javax.sql.BaseDataSource的值請使用相關的MySQL JDBC連接字符串代替。
username@javax.sql.BaseDataSource的值請使用MySQL的用戶名代替
password@javax.sql.BaseDataSource的值請使用MySQL的密碼代替

3.4.3 部署MySQL的JDBC庫

從MySQL官方網站上下載最新的MySQL JDBC庫，下載的文件解壓縮后可以得到mysql-connector-java-5.1.xx-bin.jar這個文件，將此文件復制到%TOMCAT_HOME%/common/lib目錄下

3.5 安裝中文字體

在Sakai中有部分工具支持PDF導出功能，由于PDF格式的一些限制，對中文的默認支持不理想，需要在操作系統中安裝相應的中文字體，并指定在PDF導出時使用的字體。在復旦大學的部署中，我們使用的是“AR PL UMing CN”。此功能是Sakai復旦共享版特有的功能，目前Sakai正式版尚未修正此問題。

3.5.1 安裝字體(默認centos已經安裝fixme)

yum install cjkuni-uming-fonts

3.5.2 為Sakai指定導出PDF文件時的默認字體

在%TOMCAT_HOME%/sakai/目錄（此目錄可能需要手工創建）下創建sakai.properties文件。
加上如下內容

fop.pdf.default.font=AR PL UMing CN

4 啟動/停止Sakai

通過啟動/停止Tomcat來啟動/停止Sakai

4.1 啟動Tomcat

在%TOMCAT_HOME%/bin目錄下，運行

$ sh startup.sh

4.2 停止Tomcat

在%TOMCAT_HOME%/bin目錄下，運行

$ sh shutdown.sh

5 訪問Sakai

打開任意網頁瀏覽器，訪問 http://localhost:8080 。

參考

http://sakai.fudan.edu.cn/projects/fudan-sakai/wiki/Src%E7%89%88%E5%AE%89%E8%A3%85%E8%AF%B4%E6%98%8E%2829%29

總結

以上是生活随笔為你收集整理的复旦sakai安装指南的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。

上一篇： android auto能用酷狗,完美支
下一篇：自动驾驶（五十八）---------自动